SpecialVersion.php

Go to the documentation of this file.

<?php
class SpecialVersion extends SpecialPage {
    protected $firstExtOpened = false;
 
    protected $coreId = '';
 
    protected static $extensionTypes = false;
 
    public function __construct() {
        parent::__construct( 'Version' );
    }
 
    public function execute( $par ) {
        global $IP, $wgExtensionCredits;
 
        $this->setHeaders();
        $this->outputHeader();
        $out = $this->getOutput();
        $out->allowClickjacking();
 
        // Explode the sub page information into useful bits
        $parts = explode( '/', (string)$par );
        $extNode = null;
        if ( isset( $parts[1] ) ) {
            $extName = str_replace( '_', ' ', $parts[1] );
            // Find it!
            foreach ( $wgExtensionCredits as $group => $extensions ) {
                foreach ( $extensions as $ext ) {
                    if ( isset( $ext['name'] ) && ( $ext['name'] === $extName ) ) {
                        $extNode = &$ext;
                        break 2;
                    }
                }
            }
            if ( !$extNode ) {
                $out->setStatusCode( 404 );
            }
        } else {
            $extName = 'MediaWiki';
        }
 
        // Now figure out what to do
        switch ( strtolower( $parts[0] ) ) {
            case 'credits':
                $out->addModuleStyles( 'mediawiki.special.version' );
 
                $wikiText = '{{int:version-credits-not-found}}';
                if ( $extName === 'MediaWiki' ) {
                    $wikiText = file_get_contents( $IP . '/CREDITS' );
                    // Put the contributor list into columns
                    $wikiText = str_replace(
                        [ '<!-- BEGIN CONTRIBUTOR LIST -->', '<!-- END CONTRIBUTOR LIST -->' ],
                        [ '<div class="mw-version-credits">', '</div>' ],
                        $wikiText );
                } elseif ( ( $extNode !== null ) && isset( $extNode['path'] ) ) {
                    $file = $this->getExtAuthorsFileName( dirname( $extNode['path'] ) );
                    if ( $file ) {
                        $wikiText = file_get_contents( $file );
                        if ( substr( $file, -4 ) === '.txt' ) {
                            $wikiText = Html::element(
                                'pre',
                                [
                                    'lang' => 'en',
                                    'dir' => 'ltr',
                                ],
                                $wikiText
                            );
                        }
                    }
                }
 
                $out->setPageTitle( $this->msg( 'version-credits-title', $extName ) );
                $out->addWikiText( $wikiText );
                break;
 
            case 'license':
                $wikiText = '{{int:version-license-not-found}}';
                if ( $extName === 'MediaWiki' ) {
                    $wikiText = file_get_contents( $IP . '/COPYING' );
                } elseif ( ( $extNode !== null ) && isset( $extNode['path'] ) ) {
                    $file = $this->getExtLicenseFileName( dirname( $extNode['path'] ) );
                    if ( $file ) {
                        $wikiText = file_get_contents( $file );
                        $wikiText = Html::element(
                            'pre',
                            [
                                'lang' => 'en',
                                'dir' => 'ltr',
                            ],
                            $wikiText
                        );
                    }
                }
 
                $out->setPageTitle( $this->msg( 'version-license-title', $extName ) );
                $out->addWikiText( $wikiText );
                break;
 
            default:
                $out->addModuleStyles( 'mediawiki.special.version' );
                $out->addWikiText(
                    $this->getMediaWikiCredits() .
                    $this->softwareInformation() .
                    $this->getEntryPointInfo()
                );
                $out->addHTML(
                    $this->getSkinCredits() .
                    $this->getExtensionCredits() .
                    $this->getExternalLibraries() .
                    $this->getParserTags() .
                    $this->getParserFunctionHooks()
                );
                $out->addWikiText( $this->getWgHooks() );
                $out->addHTML( $this->IPInfo() );
 
                break;
        }
    }
 
    private static function getMediaWikiCredits() {
        $ret = Xml::element(
            'h2',
            [ 'id' => 'mw-version-license' ],
            wfMessage( 'version-license' )->text()
        );
 
        // This text is always left-to-right.
        $ret .= '<div class="plainlinks">';
        $ret .= "__NOTOC__
        " . self::getCopyrightAndAuthorList() . "\n
        " . '<div class="mw-version-license-info">' .
        wfMessage( 'version-license-info' )->text() .
        '</div>';
        $ret .= '</div>';
 
        return str_replace( "\t\t", '', $ret ) . "\n";
    }
 
    public static function getCopyrightAndAuthorList() {
        global $wgLang;
 
        if ( defined( 'MEDIAWIKI_INSTALL' ) ) {
            $othersLink = '[https://www.mediawiki.org/wiki/Special:Version/Credits ' .
                wfMessage( 'version-poweredby-others' )->text() . ']';
        } else {
            $othersLink = '[[Special:Version/Credits|' .
                wfMessage( 'version-poweredby-others' )->text() . ']]';
        }
 
        $translatorsLink = '[https://translatewiki.net/wiki/Translating:MediaWiki/Credits ' .
            wfMessage( 'version-poweredby-translators' )->text() . ']';
 
        $authorList = [
            'Magnus Manske', 'Brion Vibber', 'Lee Daniel Crocker',
            'Tim Starling', 'Erik Möller', 'Gabriel Wicke', 'Ævar Arnfjörð Bjarmason',
            'Niklas Laxström', 'Domas Mituzas', 'Rob Church', 'Yuri Astrakhan',
            'Aryeh Gregor', 'Aaron Schulz', 'Andrew Garrett', 'Raimond Spekking',
            'Alexandre Emsenhuber', 'Siebrand Mazeland', 'Chad Horohoe',
            'Roan Kattouw', 'Trevor Parscal', 'Bryan Tong Minh', 'Sam Reed',
            'Victor Vasiliev', 'Rotem Liss', 'Platonides', 'Antoine Musso',
            'Timo Tijhof', 'Daniel Kinzler', 'Jeroen De Dauw', 'Brad Jorsch',
            'Bartosz Dziewoński', 'Ed Sanders', 'Moriel Schottlender',
            $othersLink, $translatorsLink
        ];
 
        return wfMessage( 'version-poweredby-credits', MWTimestamp::getLocalInstance()->format( 'Y' ),
            $wgLang->listToText( $authorList ) )->text();
    }
 
    public static function softwareInformation() {
        $dbr = wfGetDB( DB_REPLICA );
 
        // Put the software in an array of form 'name' => 'version'. All messages should
        // be loaded here, so feel free to use wfMessage in the 'name'. Raw HTML or
        // wikimarkup can be used.
        $software = [];
        $software['[https://www.mediawiki.org/ MediaWiki]'] = self::getVersionLinked();
        if ( wfIsHHVM() ) {
            $software['[http://hhvm.com/ HHVM]'] = HHVM_VERSION . " (" . PHP_SAPI . ")";
        } else {
            $software['[https://php.net/ PHP]'] = PHP_VERSION . " (" . PHP_SAPI . ")";
        }
        $software[$dbr->getSoftwareLink()] = $dbr->getServerInfo();
 
        if ( IcuCollation::getICUVersion() ) {
            $software['[http://site.icu-project.org/ ICU]'] = IcuCollation::getICUVersion();
        }
 
        // Allow a hook to add/remove items.
        Hooks::run( 'SoftwareInfo', [ &$software ] );
 
        $out = Xml::element(
                'h2',
                [ 'id' => 'mw-version-software' ],
                wfMessage( 'version-software' )->text()
            ) .
                Xml::openElement( 'table', [ 'class' => 'wikitable plainlinks', 'id' => 'sv-software' ] ) .
                "<tr>
                    <th>" . wfMessage( 'version-software-product' )->text() . "</th>
                    <th>" . wfMessage( 'version-software-version' )->text() . "</th>
                </tr>\n";
 
        foreach ( $software as $name => $version ) {
            $out .= "<tr>
                    <td>" . $name . "</td>
                    <td dir=\"ltr\">" . $version . "</td>
                </tr>\n";
        }
 
        return $out . Xml::closeElement( 'table' );
    }
 
    public static function getVersion( $flags = '', $lang = null ) {
        global $wgVersion, $IP;
 
        $gitInfo = self::getGitHeadSha1( $IP );
        if ( !$gitInfo ) {
            $version = $wgVersion;
        } elseif ( $flags === 'nodb' ) {
            $shortSha1 = substr( $gitInfo, 0, 7 );
            $version = "$wgVersion ($shortSha1)";
        } else {
            $shortSha1 = substr( $gitInfo, 0, 7 );
            $msg = wfMessage( 'parentheses' );
            if ( $lang !== null ) {
                $msg->inLanguage( $lang );
            }
            $shortSha1 = $msg->params( $shortSha1 )->escaped();
            $version = "$wgVersion $shortSha1";
        }
 
        return $version;
    }
 
    public static function getVersionLinked() {
        global $wgVersion;
 
        $gitVersion = self::getVersionLinkedGit();
        if ( $gitVersion ) {
            $v = $gitVersion;
        } else {
            $v = $wgVersion; // fallback
        }
 
        return $v;
    }
 
    private static function getwgVersionLinked() {
        global $wgVersion;
        $versionUrl = "";
        if ( Hooks::run( 'SpecialVersionVersionUrl', [ $wgVersion, &$versionUrl ] ) ) {
            $versionParts = [];
            preg_match( "/^(\d+\.\d+)/", $wgVersion, $versionParts );
            $versionUrl = "https://www.mediawiki.org/wiki/MediaWiki_{$versionParts[1]}";
        }
 
        return "[$versionUrl $wgVersion]";
    }
 
    private static function getVersionLinkedGit() {
        global $IP, $wgLang;
 
        $gitInfo = new GitInfo( $IP );
        $headSHA1 = $gitInfo->getHeadSHA1();
        if ( !$headSHA1 ) {
            return false;
        }
 
        $shortSHA1 = '(' . substr( $headSHA1, 0, 7 ) . ')';
 
        $gitHeadUrl = $gitInfo->getHeadViewUrl();
        if ( $gitHeadUrl !== false ) {
            $shortSHA1 = "[$gitHeadUrl $shortSHA1]";
        }
 
        $gitHeadCommitDate = $gitInfo->getHeadCommitDate();
        if ( $gitHeadCommitDate ) {
            $shortSHA1 .= Html::element( 'br' ) . $wgLang->timeanddate( $gitHeadCommitDate, true );
        }
 
        return self::getwgVersionLinked() . " $shortSHA1";
    }
 
    public static function getExtensionTypes() {
        if ( self::$extensionTypes === false ) {
            self::$extensionTypes = [
                'specialpage' => wfMessage( 'version-specialpages' )->text(),
                'editor' => wfMessage( 'version-editors' )->text(),
                'parserhook' => wfMessage( 'version-parserhooks' )->text(),
                'variable' => wfMessage( 'version-variables' )->text(),
                'media' => wfMessage( 'version-mediahandlers' )->text(),
                'antispam' => wfMessage( 'version-antispam' )->text(),
                'skin' => wfMessage( 'version-skins' )->text(),
                'api' => wfMessage( 'version-api' )->text(),
                'other' => wfMessage( 'version-other' )->text(),
            ];
 
            Hooks::run( 'ExtensionTypes', [ &self::$extensionTypes ] );
        }
 
        return self::$extensionTypes;
    }
 
    public static function getExtensionTypeName( $type ) {
        $types = self::getExtensionTypes();
 
        return isset( $types[$type] ) ? $types[$type] : $types['other'];
    }
 
    public function getExtensionCredits() {
        global $wgExtensionCredits;
 
        if (
            count( $wgExtensionCredits ) === 0 ||
            // Skins are displayed separately, see getSkinCredits()
            ( count( $wgExtensionCredits ) === 1 && isset( $wgExtensionCredits['skin'] ) )
        ) {
            return '';
        }
 
        $extensionTypes = self::getExtensionTypes();
 
        $out = Xml::element(
                'h2',
                [ 'id' => 'mw-version-ext' ],
                $this->msg( 'version-extensions' )->text()
            ) .
            Xml::openElement( 'table', [ 'class' => 'wikitable plainlinks', 'id' => 'sv-ext' ] );
 
        // Make sure the 'other' type is set to an array.
        if ( !array_key_exists( 'other', $wgExtensionCredits ) ) {
            $wgExtensionCredits['other'] = [];
        }
 
        // Find all extensions that do not have a valid type and give them the type 'other'.
        foreach ( $wgExtensionCredits as $type => $extensions ) {
            if ( !array_key_exists( $type, $extensionTypes ) ) {
                $wgExtensionCredits['other'] = array_merge( $wgExtensionCredits['other'], $extensions );
            }
        }
 
        $this->firstExtOpened = false;
        // Loop through the extension categories to display their extensions in the list.
        foreach ( $extensionTypes as $type => $message ) {
            // Skins have a separate section
            if ( $type !== 'other' && $type !== 'skin' ) {
                $out .= $this->getExtensionCategory( $type, $message );
            }
        }
 
        // We want the 'other' type to be last in the list.
        $out .= $this->getExtensionCategory( 'other', $extensionTypes['other'] );
 
        $out .= Xml::closeElement( 'table' );
 
        return $out;
    }
 
    public function getSkinCredits() {
        global $wgExtensionCredits;
        if ( !isset( $wgExtensionCredits['skin'] ) || count( $wgExtensionCredits['skin'] ) === 0 ) {
            return '';
        }
 
        $out = Xml::element(
                'h2',
                [ 'id' => 'mw-version-skin' ],
                $this->msg( 'version-skins' )->text()
            ) .
            Xml::openElement( 'table', [ 'class' => 'wikitable plainlinks', 'id' => 'sv-skin' ] );
 
        $this->firstExtOpened = false;
        $out .= $this->getExtensionCategory( 'skin', null );
 
        $out .= Xml::closeElement( 'table' );
 
        return $out;
    }
 
    protected function getExternalLibraries() {
        global $IP;
        $path = "$IP/vendor/composer/installed.json";
        if ( !file_exists( $path ) ) {
            return '';
        }
 
        $installed = new ComposerInstalled( $path );
        $out = Html::element(
            'h2',
            [ 'id' => 'mw-version-libraries' ],
            $this->msg( 'version-libraries' )->text()
        );
        $out .= Html::openElement(
            'table',
            [ 'class' => 'wikitable plainlinks', 'id' => 'sv-libraries' ]
        );
        $out .= Html::openElement( 'tr' )
            . Html::element( 'th', [], $this->msg( 'version-libraries-library' )->text() )
            . Html::element( 'th', [], $this->msg( 'version-libraries-version' )->text() )
            . Html::element( 'th', [], $this->msg( 'version-libraries-license' )->text() )
            . Html::element( 'th', [], $this->msg( 'version-libraries-description' )->text() )
            . Html::element( 'th', [], $this->msg( 'version-libraries-authors' )->text() )
            . Html::closeElement( 'tr' );
 
        foreach ( $installed->getInstalledDependencies() as $name => $info ) {
            if ( strpos( $info['type'], 'mediawiki-' ) === 0 ) {
                // Skip any extensions or skins since they'll be listed
                // in their proper section
                continue;
            }
            $authors = array_map( function ( $arr ) {
                // If a homepage is set, link to it
                if ( isset( $arr['homepage'] ) ) {
                    return "[{$arr['homepage']} {$arr['name']}]";
                }
                return $arr['name'];
            }, $info['authors'] );
            $authors = $this->listAuthors( $authors, false, "$IP/vendor/$name" );
 
            // We can safely assume that the libraries' names and descriptions
            // are written in English and aren't going to be translated,
            // so set appropriate lang and dir attributes
            $out .= Html::openElement( 'tr' )
                . Html::rawElement(
                    'td',
                    [],
                    Linker::makeExternalLink(
                        "https://packagist.org/packages/$name", $name,
                        true, '',
                        [ 'class' => 'mw-version-library-name' ]
                    )
                )
                . Html::element( 'td', [ 'dir' => 'auto' ], $info['version'] )
                . Html::element( 'td', [ 'dir' => 'auto' ], $this->listToText( $info['licenses'] ) )
                . Html::element( 'td', [ 'lang' => 'en', 'dir' => 'ltr' ], $info['description'] )
                . Html::rawElement( 'td', [], $authors )
                . Html::closeElement( 'tr' );
        }
        $out .= Html::closeElement( 'table' );
 
        return $out;
    }
 
    protected function getParserTags() {
        global $wgParser;
 
        $tags = $wgParser->getTags();
 
        if ( count( $tags ) ) {
            $out = Html::rawElement(
                'h2',
                [
                    'class' => 'mw-headline plainlinks',
                    'id' => 'mw-version-parser-extensiontags',
                ],
                Linker::makeExternalLink(
                    'https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Tag_extensions',
                    $this->msg( 'version-parser-extensiontags' )->parse(),
                    false /* msg()->parse() already escapes */
                )
            );
 
            array_walk( $tags, function ( &$value ) {
                // Bidirectional isolation improves readability in RTL wikis
                $value = Html::element(
                    'bdi',
                    // Prevent < and > from slipping to another line
                    [
                        'style' => 'white-space: nowrap;',
                    ],
                    "<$value>"
                );
            } );
 
            $out .= $this->listToText( $tags );
        } else {
            $out = '';
        }
 
        return $out;
    }
 
    protected function getParserFunctionHooks() {
        global $wgParser;
 
        $fhooks = $wgParser->getFunctionHooks();
        if ( count( $fhooks ) ) {
            $out = Html::rawElement(
                'h2',
                [
                    'class' => 'mw-headline plainlinks',
                    'id' => 'mw-version-parser-function-hooks',
                ],
                Linker::makeExternalLink(
                    'https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Parser_functions',
                    $this->msg( 'version-parser-function-hooks' )->parse(),
                    false /* msg()->parse() already escapes */
                )
            );
 
            $out .= $this->listToText( $fhooks );
        } else {
            $out = '';
        }
 
        return $out;
    }
 
    protected function getExtensionCategory( $type, $message ) {
        global $wgExtensionCredits;
 
        $out = '';
 
        if ( array_key_exists( $type, $wgExtensionCredits ) && count( $wgExtensionCredits[$type] ) > 0 ) {
            $out .= $this->openExtType( $message, 'credits-' . $type );
 
            usort( $wgExtensionCredits[$type], [ $this, 'compare' ] );
 
            foreach ( $wgExtensionCredits[$type] as $extension ) {
                $out .= $this->getCreditsForExtension( $type, $extension );
            }
        }
 
        return $out;
    }
 
    public function compare( $a, $b ) {
        if ( $a['name'] === $b['name'] ) {
            return 0;
        } else {
            return $this->getLanguage()->lc( $a['name'] ) > $this->getLanguage()->lc( $b['name'] )
                ? 1
                : -1;
        }
    }
 
    public function getCreditsForExtension( $type, array $extension ) {
        $out = $this->getOutput();
 
        // We must obtain the information for all the bits and pieces!
        // ... such as extension names and links
        if ( isset( $extension['namemsg'] ) ) {
            // Localized name of extension
            $extensionName = $this->msg( $extension['namemsg'] )->text();
        } elseif ( isset( $extension['name'] ) ) {
            // Non localized version
            $extensionName = $extension['name'];
        } else {
            $extensionName = $this->msg( 'version-no-ext-name' )->text();
        }
 
        if ( isset( $extension['url'] ) ) {
            $extensionNameLink = Linker::makeExternalLink(
                $extension['url'],
                $extensionName,
                true,
                '',
                [ 'class' => 'mw-version-ext-name' ]
            );
        } else {
            $extensionNameLink = $extensionName;
        }
 
        // ... and the version information
        // If the extension path is set we will check that directory for GIT
        // metadata in an attempt to extract date and vcs commit metadata.
        $canonicalVersion = '&ndash;';
        $extensionPath = null;
        $vcsVersion = null;
        $vcsLink = null;
        $vcsDate = null;
 
        if ( isset( $extension['version'] ) ) {
            $canonicalVersion = $out->parseInline( $extension['version'] );
        }
 
        if ( isset( $extension['path'] ) ) {
            global $IP;
            $extensionPath = dirname( $extension['path'] );
            if ( $this->coreId == '' ) {
                wfDebug( 'Looking up core head id' );
                $coreHeadSHA1 = self::getGitHeadSha1( $IP );
                if ( $coreHeadSHA1 ) {
                    $this->coreId = $coreHeadSHA1;
                }
            }
            $cache = wfGetCache( CACHE_ANYTHING );
            $memcKey = $cache->makeKey(
                'specialversion-ext-version-text', $extension['path'], $this->coreId
            );
            list( $vcsVersion, $vcsLink, $vcsDate ) = $cache->get( $memcKey );
 
            if ( !$vcsVersion ) {
                wfDebug( "Getting VCS info for extension {$extension['name']}" );
                $gitInfo = new GitInfo( $extensionPath );
                $vcsVersion = $gitInfo->getHeadSHA1();
                if ( $vcsVersion !== false ) {
                    $vcsVersion = substr( $vcsVersion, 0, 7 );
                    $vcsLink = $gitInfo->getHeadViewUrl();
                    $vcsDate = $gitInfo->getHeadCommitDate();
                }
                $cache->set( $memcKey, [ $vcsVersion, $vcsLink, $vcsDate ], 60 * 60 * 24 );
            } else {
                wfDebug( "Pulled VCS info for extension {$extension['name']} from cache" );
            }
        }
 
        $versionString = Html::rawElement(
            'span',
            [ 'class' => 'mw-version-ext-version' ],
            $canonicalVersion
        );
 
        if ( $vcsVersion ) {
            if ( $vcsLink ) {
                $vcsVerString = Linker::makeExternalLink(
                    $vcsLink,
                    $this->msg( 'version-version', $vcsVersion ),
                    true,
                    '',
                    [ 'class' => 'mw-version-ext-vcs-version' ]
                );
            } else {
                $vcsVerString = Html::element( 'span',
                    [ 'class' => 'mw-version-ext-vcs-version' ],
                    "({$vcsVersion})"
                );
            }
            $versionString .= " {$vcsVerString}";
 
            if ( $vcsDate ) {
                $vcsTimeString = Html::element( 'span',
                    [ 'class' => 'mw-version-ext-vcs-timestamp' ],
                    $this->getLanguage()->timeanddate( $vcsDate, true )
                );
                $versionString .= " {$vcsTimeString}";
            }
            $versionString = Html::rawElement( 'span',
                [ 'class' => 'mw-version-ext-meta-version' ],
                $versionString
            );
        }
 
        // ... and license information; if a license file exists we
        // will link to it
        $licenseLink = '';
        if ( isset( $extension['name'] ) ) {
            $licenseName = null;
            if ( isset( $extension['license-name'] ) ) {
                $licenseName = new HtmlArmor( $out->parseInline( $extension['license-name'] ) );
            } elseif ( $this->getExtLicenseFileName( $extensionPath ) ) {
                $licenseName = $this->msg( 'version-ext-license' )->text();
            }
            if ( $licenseName !== null ) {
                $licenseLink = $this->getLinkRenderer()->makeLink(
                    $this->getPageTitle( 'License/' . $extension['name'] ),
                    $licenseName,
                    [
                        'class' => 'mw-version-ext-license',
                        'dir' => 'auto',
                    ]
                );
            }
        }
 
        // ... and generate the description; which can be a parameterized l10n message
        // in the form array( <msgname>, <parameter>, <parameter>... ) or just a straight
        // up string
        if ( isset( $extension['descriptionmsg'] ) ) {
            // Localized description of extension
            $descriptionMsg = $extension['descriptionmsg'];
 
            if ( is_array( $descriptionMsg ) ) {
                $descriptionMsgKey = $descriptionMsg[0]; // Get the message key
                array_shift( $descriptionMsg ); // Shift out the message key to get the parameters only
                array_map( "htmlspecialchars", $descriptionMsg ); // For sanity
                $description = $this->msg( $descriptionMsgKey, $descriptionMsg )->text();
            } else {
                $description = $this->msg( $descriptionMsg )->text();
            }
        } elseif ( isset( $extension['description'] ) ) {
            // Non localized version
            $description = $extension['description'];
        } else {
            $description = '';
        }
        $description = $out->parseInline( $description );
 
        // ... now get the authors for this extension
        $authors = isset( $extension['author'] ) ? $extension['author'] : [];
        $authors = $this->listAuthors( $authors, $extension['name'], $extensionPath );
 
        // Finally! Create the table
        $html = Html::openElement( 'tr', [
                'class' => 'mw-version-ext',
                'id' => Sanitizer::escapeIdForAttribute( 'mw-version-ext-' . $type . '-' . $extension['name'] )
            ]
        );
 
        $html .= Html::rawElement( 'td', [], $extensionNameLink );
        $html .= Html::rawElement( 'td', [], $versionString );
        $html .= Html::rawElement( 'td', [], $licenseLink );
        $html .= Html::rawElement( 'td', [ 'class' => 'mw-version-ext-description' ], $description );
        $html .= Html::rawElement( 'td', [ 'class' => 'mw-version-ext-authors' ], $authors );
 
        $html .= Html::closeElement( 'tr' );
 
        return $html;
    }
 
    private function getWgHooks() {
        global $wgSpecialVersionShowHooks, $wgHooks;
 
        if ( $wgSpecialVersionShowHooks && count( $wgHooks ) ) {
            $myWgHooks = $wgHooks;
            ksort( $myWgHooks );
 
            $ret = [];
            $ret[] = '== {{int:version-hooks}} ==';
            $ret[] = Html::openElement( 'table', [ 'class' => 'wikitable', 'id' => 'sv-hooks' ] );
            $ret[] = Html::openElement( 'tr' );
            $ret[] = Html::element( 'th', [], $this->msg( 'version-hook-name' )->text() );
            $ret[] = Html::element( 'th', [], $this->msg( 'version-hook-subscribedby' )->text() );
            $ret[] = Html::closeElement( 'tr' );
 
            foreach ( $myWgHooks as $hook => $hooks ) {
                $ret[] = Html::openElement( 'tr' );
                $ret[] = Html::element( 'td', [], $hook );
                $ret[] = Html::element( 'td', [], $this->listToText( $hooks ) );
                $ret[] = Html::closeElement( 'tr' );
            }
 
            $ret[] = Html::closeElement( 'table' );
 
            return implode( "\n", $ret );
        } else {
            return '';
        }
    }
 
    private function openExtType( $text = null, $name = null ) {
        $out = '';
 
        $opt = [ 'colspan' => 5 ];
        if ( $this->firstExtOpened ) {
            // Insert a spacing line
            $out .= Html::rawElement( 'tr', [ 'class' => 'sv-space' ],
                Html::element( 'td', $opt )
            );
        }
        $this->firstExtOpened = true;
 
        if ( $name ) {
            $opt['id'] = "sv-$name";
        }
 
        if ( $text !== null ) {
            $out .= Html::rawElement( 'tr', [],
                Html::element( 'th', $opt, $text )
            );
        }
 
        $firstHeadingMsg = ( $name === 'credits-skin' )
            ? 'version-skin-colheader-name'
            : 'version-ext-colheader-name';
        $out .= Html::openElement( 'tr' );
        $out .= Html::element( 'th', [ 'class' => 'mw-version-ext-col-label' ],
            $this->msg( $firstHeadingMsg )->text() );
        $out .= Html::element( 'th', [ 'class' => 'mw-version-ext-col-label' ],
            $this->msg( 'version-ext-colheader-version' )->text() );
        $out .= Html::element( 'th', [ 'class' => 'mw-version-ext-col-label' ],
            $this->msg( 'version-ext-colheader-license' )->text() );
        $out .= Html::element( 'th', [ 'class' => 'mw-version-ext-col-label' ],
            $this->msg( 'version-ext-colheader-description' )->text() );
        $out .= Html::element( 'th', [ 'class' => 'mw-version-ext-col-label' ],
            $this->msg( 'version-ext-colheader-credits' )->text() );
        $out .= Html::closeElement( 'tr' );
 
        return $out;
    }
 
    private function IPInfo() {
        $ip = str_replace( '--', ' - ', htmlspecialchars( $this->getRequest()->getIP() ) );
 
        return "<!-- visited from $ip -->\n<span style='display:none'>visited from $ip</span>";
    }
 
    public function listAuthors( $authors, $extName, $extDir ) {
        $hasOthers = false;
        $linkRenderer = $this->getLinkRenderer();
 
        $list = [];
        foreach ( (array)$authors as $item ) {
            if ( $item == '...' ) {
                $hasOthers = true;
 
                if ( $extName && $this->getExtAuthorsFileName( $extDir ) ) {
                    $text = $linkRenderer->makeLink(
                        $this->getPageTitle( "Credits/$extName" ),
                        $this->msg( 'version-poweredby-others' )->text()
                    );
                } else {
                    $text = $this->msg( 'version-poweredby-others' )->escaped();
                }
                $list[] = $text;
            } elseif ( substr( $item, -5 ) == ' ...]' ) {
                $hasOthers = true;
                $list[] = $this->getOutput()->parseInline(
                    substr( $item, 0, -4 ) . $this->msg( 'version-poweredby-others' )->text() . "]"
                );
            } else {
                $list[] = $this->getOutput()->parseInline( $item );
            }
        }
 
        if ( $extName && !$hasOthers && $this->getExtAuthorsFileName( $extDir ) ) {
            $list[] = $text = $linkRenderer->makeLink(
                $this->getPageTitle( "Credits/$extName" ),
                $this->msg( 'version-poweredby-others' )->text()
            );
        }
 
        return $this->listToText( $list, false );
    }
 
    public static function getExtAuthorsFileName( $extDir ) {
        if ( !$extDir ) {
            return false;
        }
 
        foreach ( scandir( $extDir ) as $file ) {
            $fullPath = $extDir . DIRECTORY_SEPARATOR . $file;
            if ( preg_match( '/^((AUTHORS)|(CREDITS))(\.txt|\.wiki|\.mediawiki)?$/', $file ) &&
                is_readable( $fullPath ) &&
                is_file( $fullPath )
            ) {
                return $fullPath;
            }
        }
 
        return false;
    }
 
    public static function getExtLicenseFileName( $extDir ) {
        if ( !$extDir ) {
            return false;
        }
 
        foreach ( scandir( $extDir ) as $file ) {
            $fullPath = $extDir . DIRECTORY_SEPARATOR . $file;
            if ( preg_match( '/^((COPYING)|(LICENSE))(\.txt)?$/', $file ) &&
                is_readable( $fullPath ) &&
                is_file( $fullPath )
            ) {
                return $fullPath;
            }
        }
 
        return false;
    }
 
    public function listToText( $list, $sort = true ) {
        if ( !count( $list ) ) {
            return '';
        }
        if ( $sort ) {
            sort( $list );
        }
 
        return $this->getLanguage()
            ->listToText( array_map( [ __CLASS__, 'arrayToString' ], $list ) );
    }
 
    public static function arrayToString( $list ) {
        if ( is_array( $list ) && count( $list ) == 1 ) {
            $list = $list[0];
        }
        if ( $list instanceof Closure ) {
            // Don't output stuff like "Closure$;1028376090#8$48499d94fe0147f7c633b365be39952b$"
            return 'Closure';
        } elseif ( is_object( $list ) ) {
            $class = wfMessage( 'parentheses' )->params( get_class( $list ) )->escaped();
 
            return $class;
        } elseif ( !is_array( $list ) ) {
            return $list;
        } else {
            if ( is_object( $list[0] ) ) {
                $class = get_class( $list[0] );
            } else {
                $class = $list[0];
            }
 
            return wfMessage( 'parentheses' )->params( "$class, {$list[1]}" )->escaped();
        }
    }
 
    public static function getGitHeadSha1( $dir ) {
        $repo = new GitInfo( $dir );
 
        return $repo->getHeadSHA1();
    }
 
    public static function getGitCurrentBranch( $dir ) {
        $repo = new GitInfo( $dir );
        return $repo->getCurrentBranch();
    }
 
    public function getEntryPointInfo() {
        global $wgArticlePath, $wgScriptPath;
        $scriptPath = $wgScriptPath ? $wgScriptPath : "/";
        $entryPoints = [
            'version-entrypoints-articlepath' => $wgArticlePath,
            'version-entrypoints-scriptpath' => $scriptPath,
            'version-entrypoints-index-php' => wfScript( 'index' ),
            'version-entrypoints-api-php' => wfScript( 'api' ),
            'version-entrypoints-load-php' => wfScript( 'load' ),
        ];
 
        $language = $this->getLanguage();
        $thAttribures = [
            'dir' => $language->getDir(),
            'lang' => $language->getHtmlCode()
        ];
        $out = Html::element(
                'h2',
                [ 'id' => 'mw-version-entrypoints' ],
                $this->msg( 'version-entrypoints' )->text()
            ) .
            Html::openElement( 'table',
                [
                    'class' => 'wikitable plainlinks',
                    'id' => 'mw-version-entrypoints-table',
                    'dir' => 'ltr',
                    'lang' => 'en'
                ]
            ) .
            Html::openElement( 'tr' ) .
            Html::element(
                'th',
                $thAttribures,
                $this->msg( 'version-entrypoints-header-entrypoint' )->text()
            ) .
            Html::element(
                'th',
                $thAttribures,
                $this->msg( 'version-entrypoints-header-url' )->text()
            ) .
            Html::closeElement( 'tr' );
 
        foreach ( $entryPoints as $message => $value ) {
            $url = wfExpandUrl( $value, PROTO_RELATIVE );
            $out .= Html::openElement( 'tr' ) .
                // ->text() looks like it should be ->parse(), but this function
                // returns wikitext, not HTML, boo
                Html::rawElement( 'td', [], $this->msg( $message )->text() ) .
                Html::rawElement( 'td', [], Html::rawElement( 'code', [], "[$url $value]" ) ) .
                Html::closeElement( 'tr' );
        }
 
        $out .= Html::closeElement( 'table' );
 
        return $out;
    }
 
    protected function getGroupName() {
        return 'wiki';
    }
}