MultimediaViewerHooks.php

Go to the documentation of this file.

<?php
class MultimediaViewerHooks {
    protected static $infoLink =
        'https://mediawiki.org/wiki/Special:MyLanguage/Extension:Media_Viewer/About';
 
    protected static $discussionLink =
        'https://mediawiki.org/wiki/Special:MyLanguage/Extension_talk:Media_Viewer/About';
 
    protected static $helpLink =
        'https://mediawiki.org/wiki/Special:MyLanguage/Help:Extension:Media_Viewer';
 
    public static function onUserGetDefaultOptions( &$defaultOptions ) {
        global $wgMediaViewerEnableByDefault;
 
        if ( $wgMediaViewerEnableByDefault ) {
            $defaultOptions['multimediaviewer-enable'] = 1;
        }
 
        return true;
    }
 
    protected static function shouldHandleClicks( $user ) {
        global $wgMediaViewerIsInBeta, $wgMediaViewerEnableByDefaultForAnonymous,
            $wgMediaViewerEnableByDefault;
 
        if ( $wgMediaViewerIsInBeta && ExtensionRegistry::getInstance()->isLoaded( 'BetaFeatures' ) ) {
            return BetaFeatures::isFeatureEnabled( $user, 'multimedia-viewer' );
        }
 
        if ( $wgMediaViewerEnableByDefaultForAnonymous === null ) {
            $enableByDefaultForAnons = $wgMediaViewerEnableByDefault;
        } else {
            $enableByDefaultForAnons = $wgMediaViewerEnableByDefaultForAnonymous;
        }
 
        if ( !$user->isLoggedIn() ) {
            return (bool)$enableByDefaultForAnons;
        } else {
            return (bool)$user->getOption( 'multimediaviewer-enable' );
        }
    }
 
    protected static function getModules( &$out ) {
        $out->addModules( [ 'mmv.head', 'mmv.bootstrap.autostart' ] );
 
        return true;
    }
 
    public static function getModulesForArticle( &$out, &$skin ) {
        $pageHasThumbnails = count( $out->getFileSearchOptions() ) > 0;
        $pageIsFilePage = $out->getTitle()->inNamespace( NS_FILE );
        // TODO: Have Flow work out if there are any images on the page
        $pageIsFlowPage = ExtensionRegistry::getInstance()->isLoaded( 'Flow' ) &&
            // CONTENT_MODEL_FLOW_BOARD
            $out->getTitle()->getContentModel() === 'flow-board';
        $fileRelatedSpecialPages = [ 'NewFiles', 'ListFiles', 'MostLinkedFiles',
            'MostGloballyLinkedFiles', 'UncategorizedFiles', 'UnusedFiles', 'Search' ];
        $pageIsFileRelatedSpecialPage = $out->getTitle()->inNamespace( NS_SPECIAL )
            && in_array( $out->getTitle()->getText(), $fileRelatedSpecialPages );
 
        if ( $pageHasThumbnails || $pageIsFilePage || $pageIsFileRelatedSpecialPage || $pageIsFlowPage ) {
            return self::getModules( $out );
        }
 
        return true;
    }
 
    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;
    }
 
    public static function getBetaPreferences( $user, &$prefs ) {
        global $wgExtensionAssetsPath, $wgMediaViewerIsInBeta;
 
        if ( !$wgMediaViewerIsInBeta ) {
            return true;
        }
 
        $prefs['multimedia-viewer'] = [
            'label-message' => 'multimediaviewer-pref',
            'desc-message' => 'multimediaviewer-pref-desc',
            'info-link' => self::$infoLink,
            'discussion-link' => self::$discussionLink,
            'help-link' => self::$helpLink,
            'screenshot' => [
                'ltr' => "$wgExtensionAssetsPath/MultimediaViewer/viewer-ltr.svg",
                'rtl' => "$wgExtensionAssetsPath/MultimediaViewer/viewer-rtl.svg",
            ],
        ];
 
        return true;
    }
 
    public static function getPreferences( $user, &$prefs ) {
        global $wgMediaViewerIsInBeta;
 
        if ( !$wgMediaViewerIsInBeta ) {
            $prefs['multimediaviewer-enable'] = [
                'type' => 'toggle',
                'label-message' => 'multimediaviewer-optin-pref',
                'section' => 'rendering/files',
            ];
        }
 
        return true;
    }
 
    public static function resourceLoaderGetConfigVars( &$vars ) {
        global $wgMediaViewerActionLoggingSamplingFactorMap,
            $wgMediaViewerNetworkPerformanceSamplingFactor,
            $wgMediaViewerDurationLoggingSamplingFactor,
            $wgMediaViewerDurationLoggingLoggedinSamplingFactor,
            $wgMediaViewerAttributionLoggingSamplingFactor,
            $wgMediaViewerDimensionLoggingSamplingFactor,
            $wgMediaViewerIsInBeta, $wgMediaViewerUseThumbnailGuessing, $wgMediaViewerExtensions,
            $wgMediaViewerImageQueryParameter, $wgMediaViewerRecordVirtualViewBeaconURI;
 
        $vars['wgMultimediaViewer'] = [
            'infoLink' => self::$infoLink,
            'discussionLink' => self::$discussionLink,
            'helpLink' => self::$helpLink,
            'useThumbnailGuessing' => (bool)$wgMediaViewerUseThumbnailGuessing,
            'durationSamplingFactor' => $wgMediaViewerDurationLoggingSamplingFactor,
            'durationSamplingFactorLoggedin' => $wgMediaViewerDurationLoggingLoggedinSamplingFactor,
            'networkPerformanceSamplingFactor' => $wgMediaViewerNetworkPerformanceSamplingFactor,
            'actionLoggingSamplingFactorMap' => $wgMediaViewerActionLoggingSamplingFactorMap,
            'attributionSamplingFactor' => $wgMediaViewerAttributionLoggingSamplingFactor,
            'dimensionSamplingFactor' => $wgMediaViewerDimensionLoggingSamplingFactor,
            'imageQueryParameter' => $wgMediaViewerImageQueryParameter,
            'recordVirtualViewBeaconURI' => $wgMediaViewerRecordVirtualViewBeaconURI,
            'tooltipDelay' => 1000,
            'extensions' => $wgMediaViewerExtensions,
        ];
        $vars['wgMediaViewer'] = true;
        $vars['wgMediaViewerIsInBeta'] = $wgMediaViewerIsInBeta;
 
        return true;
    }
 
    public static function makeGlobalVariablesScript( &$vars, OutputPage $out ) {
        $defaultUserOptions = User::getDefaultOptions();
 
        $user = $out->getUser();
        $vars['wgMediaViewerOnClick'] = self::shouldHandleClicks( $user );
        // needed because of bug 69942; could be different for anon and logged-in
        $vars['wgMediaViewerEnabledByDefault'] =
            !empty( $defaultUserOptions['multimediaviewer-enable'] );
    }
 
    public static function thumbnailBeforeProduceHTML( ThumbnailImage $thumbnail, array &$attribs,
        &$linkAttribs
    ) {
        $file = $thumbnail->getFile();
 
        if ( $file ) {
            // At the moment all classes that extend File have getWidth() and getHeight()
            // but since the File class doesn't have these methods defined, this check
            // is more future-proof
 
            if ( method_exists( $file, 'getWidth' ) ) {
                $attribs['data-file-width'] = $file->getWidth();
            }
 
            if ( method_exists( $file, 'getHeight' ) ) {
                $attribs['data-file-height'] = $file->getHeight();
            }
        }
 
        return true;
    }
}