. * * @file * @ingroup extensions */ namespace Popups; use User; use OutputPage; use Skin; use ResourceLoader; /** * Hooks definitions for Popups extension * * @package Popups */ class PopupsHooks { const PREVIEWS_PREFERENCES_SECTION = 'rendering/reading'; static function onGetBetaPreferences( User $user, array &$prefs ) { global $wgExtensionAssetsPath; if ( PopupsContext::getInstance()->isBetaFeatureEnabled() !== true ) { return; } $prefs[PopupsContext::PREVIEWS_BETA_PREFERENCE_NAME] = [ 'label-message' => 'popups-message', 'desc-message' => 'popups-desc', 'screenshot' => [ 'ltr' => "$wgExtensionAssetsPath/Popups/images/popups-ltr.svg", 'rtl' => "$wgExtensionAssetsPath/Popups/images/popups-rtl.svg", ], 'info-link' => 'https://www.mediawiki.org/wiki/Beta_Features/Hovercards', 'discussion-link' => 'https://www.mediawiki.org/wiki/Talk:Beta_Features/Hovercards', 'requirements' => [ 'javascript' => true, ], ]; } /** * Add Page Previews options to user Preferences page * * @param User $user * @param array $prefs */ static function onGetPreferences( User $user, array &$prefs ) { $context = PopupsContext::getInstance(); if ( !$context->showPreviewsOptInOnPreferencesPage() ) { return; } $option = [ 'type' => 'radio', 'label-message' => 'popups-prefs-optin-title', 'help' => wfMessage( 'popups-prefs-conflicting-gadgets-info' ), 'options' => [ wfMessage( 'popups-prefs-optin-enabled-label' )->text() => PopupsContext::PREVIEWS_ENABLED, wfMessage( 'popups-prefs-optin-disabled-label' )->text() => PopupsContext::PREVIEWS_DISABLED ], 'section' => self::PREVIEWS_PREFERENCES_SECTION ]; if ( $context->conflictsWithNavPopupsGadget( $user ) ) { $option[ 'disabled' ] = true; $option[ 'help' ] = wfMessage( 'popups-prefs-disable-nav-gadgets-info', 'Special:Preferences#mw-prefsection-gadgets' ); } $skinPosition = array_search( 'skin', array_keys( $prefs ) ); if ( $skinPosition !== false ) { $injectIntoIndex = $skinPosition + 1; $prefs = array_slice( $prefs, 0, $injectIntoIndex, true ) + [ PopupsContext::PREVIEWS_OPTIN_PREFERENCE_NAME => $option ] + array_slice( $prefs, $injectIntoIndex, count( $prefs ) - 1, true ); } else { $prefs[ PopupsContext::PREVIEWS_OPTIN_PREFERENCE_NAME ] = $option; } } public static function onBeforePageDisplay( OutputPage &$out, Skin &$skin ) { $module = PopupsContext::getInstance(); $user = $out->getUser(); if ( !$module->areDependenciesMet() ) { $logger = $module->getLogger(); $logger->error( 'Popups requires the PageImages and TextExtracts extensions. ' . 'If Beta mode is on it requires also BetaFeatures extension' ); return true; } if ( !$module->isBetaFeatureEnabled() || $module->shouldSendModuleToUser( $user ) ) { $out->addModules( [ 'ext.popups' ] ); } return true; } /** * @param array $vars */ public static function onResourceLoaderGetConfigVars( array &$vars ) { $conf = PopupsContext::getInstance()->getConfig(); $vars['wgPopupsSchemaSamplingRate'] = $conf->get( 'PopupsSchemaSamplingRate' ); $vars['wgPopupsBetaFeature'] = $conf->get( 'PopupsBetaFeature' ); $vars['wgPopupsGateway'] = $conf->get( 'PopupsGateway' ); $vars['wgPopupsAnonsEnabledSamplingRate'] = $conf->get( 'PopupsAnonsEnabledSamplingRate' ); $vars['wgPopupsStatsvSamplingRate'] = $conf->get( 'PopupsStatsvSamplingRate' ); } /** * MakeGlobalVariablesScript hook handler. * * Variables added: * * `wgPopupsShouldSendModuleToUser' - The server's notion of whether or not the * user has enabled Page Previews (see `\Popups\PopupsContext#shouldSendModuleToUser`). * * `wgPopupsConflictsWithNavPopupGadget' - The server's notion of whether or not the * user has enabled conflicting Navigational Popups Gadget. * * @param array $vars * @param OutputPage $out */ public static function onMakeGlobalVariablesScript( array &$vars, OutputPage $out ) { $module = PopupsContext::getInstance(); $user = $out->getUser(); $vars['wgPopupsShouldSendModuleToUser'] = $module->shouldSendModuleToUser( $user ); $vars['wgPopupsConflictsWithNavPopupGadget'] = $module->conflictsWithNavPopupsGadget( $user ); } /** * Register default preferences for popups * * @param array $wgDefaultUserOptions Reference to default options array */ public static function onUserGetDefaultOptions( &$wgDefaultUserOptions ) { $wgDefaultUserOptions[ PopupsContext::PREVIEWS_OPTIN_PREFERENCE_NAME ] = PopupsContext::getInstance()->getDefaultIsEnabledState(); } }