. * * @file * @ingroup extensions * @author Mark Holmquist * @copyright Copyright © 2013, Mark Holmquist */ class MultimediaViewerHooks { /** Link to more information about this module */ protected static $infoLink = '//mediawiki.org/wiki/Special:MyLanguage/Multimedia/About_Media_Viewer'; /** Link to a page where this module can be discussed */ protected static $discussionLink = '//mediawiki.org/wiki/Special:MyLanguage/Talk:Multimedia/About_Media_Viewer'; /** * Handler for all places where we add the modules * Could be on article pages or on Category pages * @param OutputPage $out * @return bool */ protected static function getModules( &$out ) { if ( class_exists( 'BetaFeatures') && !BetaFeatures::isFeatureEnabled( $out->getUser(), 'multimedia-viewer' ) ) { return true; } $out->addModules( array( 'ext.multimediaViewer' ) ); return true; } /** * Handler for BeforePageDisplay hook * Add JavaScript to the page when an image is on it * and the user has enabled the feature if BetaFeatures is installed * @param OutputPage $out * @param Skin $skin * @return bool */ public static function getModulesForArticle( &$out, &$skin ) { if ( count( $out->getFileSearchOptions() ) > 0 ) { return self::getModules( $out ); } return true; } /** * Handler for CategoryPageView hook * Add JavaScript to the page if there are images in the category * @param CategoryPage $catPage * @return bool */ public static function getModulesForCategory( &$catPage ) { $title = $catPage->getTitle(); $cat = Category::newFromTitle( $title ); if ( $cat->getFileCount() > 0 ) { $out = $catPage->getContext()->getOutput(); return self::getModules( $out ); } return true; } // Add a beta preference to gate the feature public static function getBetaPreferences( $user, &$prefs ) { global $wgExtensionAssetsPath; $prefs['multimedia-viewer'] = array( 'label-message' => 'multimediaviewer-pref', 'desc-message' => 'multimediaviewer-pref-desc', 'info-link' => self::$infoLink, 'discussion-link' => self::$discussionLink, 'screenshot' => $wgExtensionAssetsPath . '/MultimediaViewer/img/viewer.svg', ); return true; } /** * Export variables used in both PHP and JS to keep DRY * @param array $vars * @return bool */ public static function resourceLoaderGetConfigVars( &$vars ) { $vars['wgMultimediaViewer'] = array( 'infoLink' => self::$infoLink, 'discussionLink' => self::$discussionLink, ); return true; } }