<?php
+/**
+ * Implements Special:Version
+ *
+ * Copyright © 2005 Ævar Arnfjörð Bjarmason
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup SpecialPage
+ */
/**
* Give information about the version of MediaWiki, PHP, the DB and extensions
*
* @ingroup SpecialPage
- *
- * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
- * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
- * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
*/
class SpecialVersion extends SpecialPage {
- private $firstExtOpened = true;
+ protected $firstExtOpened = false;
+
+ /**
+ * Stores the current rev id/SHA hash of MediaWiki core
+ */
+ protected $coreId = '';
- static $viewvcUrls = array(
- 'svn+ssh://svn.wikimedia.org/svnroot/mediawiki' => 'http://svn.wikimedia.org/viewvc/mediawiki',
- 'http://svn.wikimedia.org/svnroot/mediawiki' => 'http://svn.wikimedia.org/viewvc/mediawiki',
- # Doesn't work at the time of writing but maybe some day:
- 'https://svn.wikimedia.org/viewvc/mediawiki' => 'http://svn.wikimedia.org/viewvc/mediawiki',
- );
+ protected static $extensionTypes = false;
- function __construct(){
+ public function __construct() {
parent::__construct( 'Version' );
}
/**
* main()
+ * @param string|null $par
*/
- function execute( $par ) {
- global $wgOut, $wgMessageCache, $wgSpecialVersionShowHooks, $wgContLang;
- $wgMessageCache->loadAllMessages();
+ public function execute( $par ) {
+ global $IP, $wgExtensionCredits;
$this->setHeaders();
$this->outputHeader();
+ $out = $this->getOutput();
+ $out->allowClickjacking();
- $wgOut->addHTML( Xml::openElement( 'div',
- array( 'dir' => $wgContLang->getDir() ) ) );
- $text =
- $this->MediaWikiCredits() .
- $this->softwareInformation() .
- $this->extensionCredits();
- if ( $wgSpecialVersionShowHooks ) {
- $text .= $this->wgHooks();
- }
- $wgOut->addWikiText( $text );
- $wgOut->addHTML( $this->IPInfo() );
- $wgOut->addHTML( '</div>' );
- }
+ // 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';
+ }
- /**#@+
- * @private
- */
+ // 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;
+ }
+ }
/**
- * @return wiki text showing the license information
+ * Returns wiki text showing the license information.
+ *
+ * @return string
*/
- static function MediaWikiCredits() {
- global $wgContLang;
-
- $ret = Xml::element( 'h2', array( 'id' => 'mw-version-license' ), wfMsg( 'version-license' ) );
+ 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 dir="ltr">';
+ $ret .= '<div class="plainlinks">';
$ret .= "__NOTOC__
- This wiki is powered by '''[http://www.mediawiki.org/ MediaWiki]''',
- copyright © 2001-2010 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 and others.
-
- MediaWiki is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
- (at your option) any later version.
-
- MediaWiki is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received [{{SERVER}}{{SCRIPTPATH}}/COPYING a copy of the GNU General Public License]
- along with this program; if not, write to the Free Software
- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
- or [http://www.gnu.org/licenses/old-licenses/gpl-2.0.html read it online].
- ";
+ " . self::getCopyrightAndAuthorList() . "\n
+ " . wfMessage( 'version-license-info' )->text();
$ret .= '</div>';
return str_replace( "\t\t", '', $ret ) . "\n";
}
/**
- * @return wiki text showing the third party software versions (apache, php, mysql).
+ * Get the "MediaWiki is copyright 2001-20xx by lots of cool guys" text
+ *
+ * @return string
*/
- static function softwareInformation() {
- $dbr = wfGetDB( DB_SLAVE );
+ 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();
+ }
+
+ /**
+ * Returns wiki text showing the third party software versions (apache, php, mysql).
+ *
+ * @return string
+ */
+ 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 wfMsg*() in the 'name'. Raw HTML or wikimarkup
- // can be used
- $software = array();
- $software['[http://www.mediawiki.org/ MediaWiki]'] = self::getVersionLinked();
- $software['[http://www.php.net/ PHP]'] = phpversion() . " (" . php_sapi_name() . ")";
- $software[$dbr->getSoftwareLink()] = $dbr->getServerVersion();
-
- // Allow a hook to add/remove items
- wfRunHooks( 'SoftwareInfo', array( &$software ) );
-
- $out = Xml::element( 'h2', array( 'id' => 'mw-version-software' ), wfMsg( 'version-software' ) ) .
- Xml::openElement( 'table', array( 'class' => 'wikitable', 'id' => 'sv-software' ) ) .
+ // 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>" . wfMsg( 'version-software-product' ) . "</th>
- <th>" . wfMsg( 'version-software-version' ) . "</th>
+ <th>" . wfMessage( 'version-software-product' )->text() . "</th>
+ <th>" . wfMessage( 'version-software-version' )->text() . "</th>
</tr>\n";
- foreach( $software as $name => $version ) {
+
+ foreach ( $software as $name => $version ) {
$out .= "<tr>
<td>" . $name . "</td>
- <td>" . $version . "</td>
+ <td dir=\"ltr\">" . $version . "</td>
</tr>\n";
- }
+ }
+
return $out . Xml::closeElement( 'table' );
}
/**
- * Return a string of the MediaWiki version with SVN revision if available
+ * Return a string of the MediaWiki version with Git revision if available.
*
+ * @param string $flags
+ * @param Language|string|null $lang
* @return mixed
*/
- public static function getVersion( $flags = '' ) {
+ public static function getVersion( $flags = '', $lang = null ) {
global $wgVersion, $IP;
- wfProfileIn( __METHOD__ );
- $info = self::getSvnInfo( $IP );
- if ( !$info ) {
+ $gitInfo = self::getGitHeadSha1( $IP );
+ if ( !$gitInfo ) {
$version = $wgVersion;
- } elseif( $flags === 'nodb' ) {
- $version = "$wgVersion (r{$info['checkout-rev']})";
+ } elseif ( $flags === 'nodb' ) {
+ $shortSha1 = substr( $gitInfo, 0, 7 );
+ $version = "$wgVersion ($shortSha1)";
} else {
- $version = $wgVersion . ' ' .
- wfMsg(
- 'version-svn-revision',
- isset( $info['directory-rev'] ) ? $info['directory-rev'] : '',
- $info['checkout-rev']
- );
+ $shortSha1 = substr( $gitInfo, 0, 7 );
+ $msg = wfMessage( 'parentheses' );
+ if ( $lang !== null ) {
+ $msg->inLanguage( $lang );
+ }
+ $shortSha1 = $msg->params( $shortSha1 )->escaped();
+ $version = "$wgVersion $shortSha1";
}
- wfProfileOut( __METHOD__ );
return $version;
}
-
+
/**
* Return a wikitext-formatted string of the MediaWiki version with a link to
- * the SVN revision if available
+ * the Git SHA1 of head if available.
+ * The fallback is just $wgVersion
*
* @return mixed
*/
public static function getVersionLinked() {
- global $wgVersion, $IP;
- wfProfileIn( __METHOD__ );
- $info = self::getSvnInfo( $IP );
- if ( isset( $info['checkout-rev'] ) ) {
- $linkText = wfMsg(
- 'version-svn-revision',
- isset( $info['directory-rev'] ) ? $info['directory-rev'] : '',
- $info['checkout-rev']
- );
- if ( isset( $info['viewvc-url'] ) ) {
- $version = "$wgVersion [{$info['viewvc-url']} $linkText]";
- } else {
- $version = "$wgVersion $linkText";
- }
+ global $wgVersion;
+
+ $gitVersion = self::getVersionLinkedGit();
+ if ( $gitVersion ) {
+ $v = $gitVersion;
} else {
- $version = $wgVersion;
+ $v = $wgVersion; // fallback
}
- wfProfileOut( __METHOD__ );
- return $version;
+
+ return $v;
+ }
+
+ /**
+ * @return string
+ */
+ 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]";
}
- /** Generate wikitext showing extensions name, URL, author and description */
- function extensionCredits() {
- global $wgExtensionCredits, $wgExtensionFunctions, $wgParser, $wgSkinExtensionFunctions;
+ /**
+ * @since 1.22 Returns the HEAD date in addition to the sha1 and link
+ * @return bool|string Global wgVersion + HEAD sha1 stripped to the first 7 chars
+ * with link and date, or false on failure
+ */
+ 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]";
+ }
- if ( ! count( $wgExtensionCredits ) && ! count( $wgExtensionFunctions ) && ! count( $wgSkinExtensionFunctions ) )
+ $gitHeadCommitDate = $gitInfo->getHeadCommitDate();
+ if ( $gitHeadCommitDate ) {
+ $shortSHA1 .= Html::element( 'br' ) . $wgLang->timeanddate( $gitHeadCommitDate, true );
+ }
+
+ return self::getwgVersionLinked() . " $shortSHA1";
+ }
+
+ /**
+ * Returns an array with the base extension types.
+ * Type is stored as array key, the message as array value.
+ *
+ * TODO: ideally this would return all extension types.
+ *
+ * @since 1.17
+ *
+ * @return array
+ */
+ public static function getExtensionTypes() {
+ if ( self::$extensionTypes === false ) {
+ self::$extensionTypes = [
+ 'specialpage' => wfMessage( 'version-specialpages' )->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;
+ }
+
+ /**
+ * Returns the internationalized name for an extension type.
+ *
+ * @since 1.17
+ *
+ * @param string $type
+ *
+ * @return string
+ */
+ public static function getExtensionTypeName( $type ) {
+ $types = self::getExtensionTypes();
+
+ return isset( $types[$type] ) ? $types[$type] : $types['other'];
+ }
+
+ /**
+ * Generate wikitext showing the name, URL, author and description of each extension.
+ *
+ * @return string Wikitext
+ */
+ public function getExtensionCredits() {
+ global $wgExtensionCredits;
+
+ if (
+ count( $wgExtensionCredits ) === 0 ||
+ // Skins are displayed separately, see getSkinCredits()
+ ( count( $wgExtensionCredits ) === 1 && isset( $wgExtensionCredits['skin'] ) )
+ ) {
return '';
+ }
- $extensionTypes = array(
- 'specialpage' => wfMsg( 'version-specialpages' ),
- 'parserhook' => wfMsg( 'version-parserhooks' ),
- 'variable' => wfMsg( 'version-variables' ),
- 'media' => wfMsg( 'version-mediahandlers' ),
- 'other' => wfMsg( 'version-other' ),
- );
- wfRunHooks( 'SpecialVersionExtensionTypes', array( &$this, &$extensionTypes ) );
+ $extensionTypes = self::getExtensionTypes();
- $out = Xml::element( 'h2', array( 'id' => 'mw-version-ext' ), wfMsg( 'version-extensions' ) ) .
- Xml::openElement( 'table', array( 'class' => 'wikitable', 'id' => 'sv-ext' ) );
+ $out = Xml::element(
+ 'h2',
+ [ 'id' => 'mw-version-ext' ],
+ $this->msg( 'version-extensions' )->text()
+ ) .
+ Xml::openElement( 'table', [ 'class' => 'wikitable plainlinks', 'id' => 'sv-ext' ] );
- foreach ( $extensionTypes as $type => $text ) {
- if ( isset ( $wgExtensionCredits[$type] ) && count ( $wgExtensionCredits[$type] ) ) {
- $out .= $this->openExtType( $text, 'credits-' . $type );
+ // Make sure the 'other' type is set to an array.
+ if ( !array_key_exists( 'other', $wgExtensionCredits ) ) {
+ $wgExtensionCredits['other'] = [];
+ }
- usort( $wgExtensionCredits[$type], array( $this, 'compare' ) );
+ // 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 );
+ }
+ }
- foreach ( $wgExtensionCredits[$type] as $extension ) {
- $out .= $this->formatCredits( $extension );
- }
+ $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 );
}
}
- if ( count( $wgExtensionFunctions ) ) {
- $out .= $this->openExtType( wfMsg( 'version-extension-functions' ), 'extension-functions' );
- $out .= '<tr><td colspan="4">' . $this->listToText( $wgExtensionFunctions ) . "</td></tr>\n";
+ // We want the 'other' type to be last in the list.
+ $out .= $this->getExtensionCategory( 'other', $extensionTypes['other'] );
+
+ $out .= Xml::closeElement( 'table' );
+
+ return $out;
+ }
+
+ /**
+ * Generate wikitext showing the name, URL, author and description of each skin.
+ *
+ * @return string Wikitext
+ */
+ public function getSkinCredits() {
+ global $wgExtensionCredits;
+ if ( !isset( $wgExtensionCredits['skin'] ) || count( $wgExtensionCredits['skin'] ) === 0 ) {
+ return '';
}
- if ( $cnt = count( $tags = $wgParser->getTags() ) ) {
- for ( $i = 0; $i < $cnt; ++$i )
- $tags[$i] = "<{$tags[$i]}>";
- $out .= $this->openExtType( wfMsg( 'version-parser-extensiontags' ), 'parser-tags' );
- $out .= '<tr><td colspan="4">' . $this->listToText( $tags ). "</td></tr>\n";
+ $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;
+ }
+
+ /**
+ * Generate an HTML table for external libraries that are installed
+ *
+ * @return string
+ */
+ protected function getExternalLibraries() {
+ global $IP;
+ $path = "$IP/vendor/composer/installed.json";
+ if ( !file_exists( $path ) ) {
+ return '';
}
- if( $cnt = count( $fhooks = $wgParser->getFunctionHooks() ) ) {
- $out .= $this->openExtType( wfMsg( 'version-parser-function-hooks' ), 'parser-function-hooks' );
- $out .= '<tr><td colspan="4">' . $this->listToText( $fhooks ) . "</td></tr>\n";
+ $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;
+ }
- if ( count( $wgSkinExtensionFunctions ) ) {
- $out .= $this->openExtType( wfMsg( 'version-skin-extension-functions' ), 'skin-extension-functions' );
- $out .= '<tr><td colspan="4">' . $this->listToText( $wgSkinExtensionFunctions ) . "</td></tr>\n";
+ /**
+ * Obtains a list of installed parser tags and the associated H2 header
+ *
+ * @return string HTML output
+ */
+ 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 = '';
}
- $out .= Xml::closeElement( 'table' );
+
return $out;
}
- /** Callback to sort extensions by type */
- function compare( $a, $b ) {
- global $wgLang;
- if( $a['name'] === $b['name'] ) {
+ /**
+ * Obtains a list of installed parser function hooks and the associated H2 header
+ *
+ * @return string HTML output
+ */
+ 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;
+ }
+
+ /**
+ * Creates and returns the HTML for a single extension category.
+ *
+ * @since 1.17
+ *
+ * @param string $type
+ * @param string $message
+ *
+ * @return string
+ */
+ 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;
+ }
+
+ /**
+ * Callback to sort extensions by type.
+ * @param array $a
+ * @param array $b
+ * @return int
+ */
+ public function compare( $a, $b ) {
+ if ( $a['name'] === $b['name'] ) {
return 0;
} else {
- return $wgLang->lc( $a['name'] ) > $wgLang->lc( $b['name'] )
+ return $this->getLanguage()->lc( $a['name'] ) > $this->getLanguage()->lc( $b['name'] )
? 1
: -1;
}
}
- function formatCredits( $extension ) {
- $name = isset( $extension['name'] ) ? $extension['name'] : '[no name]';
- if ( isset( $extension['path'] ) ) {
- $svnInfo = self::getSvnInfo( dirname($extension['path']) );
- $directoryRev = isset( $svnInfo['directory-rev'] ) ? $svnInfo['directory-rev'] : null;
- $checkoutRev = isset( $svnInfo['checkout-rev'] ) ? $svnInfo['checkout-rev'] : null;
- $viewvcUrl = isset( $svnInfo['viewvc-url'] ) ? $svnInfo['viewvc-url'] : null;
+ /**
+ * Creates and formats a version line for a single extension.
+ *
+ * Information for five columns will be created. Parameters required in the
+ * $extension array for part rendering are indicated in ()
+ * - The name of (name), and URL link to (url), the extension
+ * - Official version number (version) and if available version control system
+ * revision (path), link, and date
+ * - If available the short name of the license (license-name) and a link
+ * to ((LICENSE)|(COPYING))(\.txt)? if it exists.
+ * - Description of extension (descriptionmsg or description)
+ * - List of authors (author) and link to a ((AUTHORS)|(CREDITS))(\.txt)? file if it exists
+ *
+ * @param string $type Category name of the extension
+ * @param array $extension
+ *
+ * @return string Raw HTML
+ */
+ 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 {
- $directoryRev = null;
- $checkoutRev = null;
- $viewvcUrl = null;
+ $extensionName = $this->msg( 'version-no-ext-name' )->text();
}
- # Make main link (or just the name if there is no URL)
if ( isset( $extension['url'] ) ) {
- $mainLink = "[{$extension['url']} $name]";
+ $extensionNameLink = Linker::makeExternalLink(
+ $extension['url'],
+ $extensionName,
+ true,
+ '',
+ [ 'class' => 'mw-version-ext-name' ]
+ );
} else {
- $mainLink = $name;
+ $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 = '–';
+ $extensionPath = null;
+ $vcsVersion = null;
+ $vcsLink = null;
+ $vcsDate = null;
+
if ( isset( $extension['version'] ) ) {
- $versionText = '<span class="mw-version-ext-version">' .
- wfMsg( 'version-version', $extension['version'] ) .
- '</span>';
- } else {
- $versionText = '';
+ $canonicalVersion = $out->parseInline( $extension['version'] );
}
- # Make subversion text/link
- if ( $checkoutRev ) {
- $svnText = wfMsg( 'version-svn-revision', $directoryRev, $checkoutRev );
- $svnText = isset( $viewvcUrl ) ? "[$viewvcUrl $svnText]" : $svnText;
- } else {
- $svnText = false;
+ 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" );
+ }
}
- # Make description text
- $description = isset ( $extension['description'] ) ? $extension['description'] : '';
- if( isset ( $extension['descriptionmsg'] ) ) {
- # Look for a localized description
+ $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 ) ) {
+
+ 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
- $msg = wfMsg( $descriptionMsgKey, $descriptionMsg );
+ $description = $this->msg( $descriptionMsgKey, $descriptionMsg )->text();
} else {
- $msg = wfMsg( $descriptionMsg );
+ $description = $this->msg( $descriptionMsg )->text();
}
- if ( !wfEmptyMsg( $descriptionMsg, $msg ) && $msg != '' ) {
- $description = $msg;
- }
+ } elseif ( isset( $extension['description'] ) ) {
+ // Non localized version
+ $description = $extension['description'];
+ } else {
+ $description = '';
}
+ $description = $out->parseInline( $description );
- if ( $svnText !== false ) {
- $extNameVer = "<tr>
- <td><em>$mainLink $versionText</em></td>
- <td><em>$svnText</em></td>";
- } else {
- $extNameVer = "<tr>
- <td colspan=\"2\"><em>$mainLink $versionText</em></td>";
- }
- $author = isset ( $extension['author'] ) ? $extension['author'] : array();
- $extDescAuthor = "<td>$description</td>
- <td>" . $this->listToText( (array)$author, false ) . "</td>
- </tr>\n";
- return $extNameVer . $extDescAuthor;
+ // ... 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;
}
/**
- * @return string
+ * Generate wikitext showing hooks in $wgHooks.
+ *
+ * @return string Wikitext
*/
- function wgHooks() {
- global $wgHooks;
+ private function getWgHooks() {
+ global $wgSpecialVersionShowHooks, $wgHooks;
- if ( count( $wgHooks ) ) {
+ if ( $wgSpecialVersionShowHooks && count( $wgHooks ) ) {
$myWgHooks = $wgHooks;
ksort( $myWgHooks );
- $ret = Xml::element( 'h2', array( 'id' => 'mw-version-hooks' ), wfMsg( 'version-hooks' ) ) .
- Xml::openElement( 'table', array( 'class' => 'wikitable', 'id' => 'sv-hooks' ) ) .
- "<tr>
- <th>" . wfMsg( 'version-hook-name' ) . "</th>
- <th>" . wfMsg( 'version-hook-subscribedby' ) . "</th>
- </tr>\n";
+ $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' );
+ }
- foreach ( $myWgHooks as $hook => $hooks )
- $ret .= "<tr>
- <td>$hook</td>
- <td>" . $this->listToText( $hooks ) . "</td>
- </tr>\n";
+ $ret[] = Html::closeElement( 'table' );
- $ret .= Xml::closeElement( 'table' );
- return $ret;
- } else
+ return implode( "\n", $ret );
+ } else {
return '';
+ }
}
- private function openExtType( $text, $name = null ) {
- $opt = array( 'colspan' => 4 );
+ private function openExtType( $text = null, $name = null ) {
$out = '';
- if( !$this->firstExtOpened ) {
+ $opt = [ 'colspan' => 5 ];
+ if ( $this->firstExtOpened ) {
// Insert a spacing line
- $out .= '<tr class="sv-space">' . Xml::element( 'td', $opt ) . "</tr>\n";
+ $out .= Html::rawElement( 'tr', [ 'class' => 'sv-space' ],
+ Html::element( 'td', $opt )
+ );
}
- $this->firstExtOpened = false;
+ $this->firstExtOpened = true;
- if( $name )
+ 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' );
- $out .= "<tr>" . Xml::element( 'th', $opt, $text ) . "</tr>\n";
return $out;
}
/**
- * @return string
+ * Get information about client's IP address.
+ *
+ * @return string HTML fragment
*/
- function IPInfo() {
- $ip = str_replace( '--', ' - ', htmlspecialchars( wfGetIP() ) );
- return "<!-- visited from $ip -->\n" .
- "<span style='display:none'>visited from $ip</span>";
+ private function IPInfo() {
+ $ip = str_replace( '--', ' - ', htmlspecialchars( $this->getRequest()->getIP() ) );
+
+ return "<!-- visited from $ip -->\n<span style='display:none'>visited from $ip</span>";
}
/**
- * @param array $list
- * @param bool $sort
- * @return string
+ * Return a formatted unsorted list of authors
+ *
+ * 'And Others'
+ * If an item in the $authors array is '...' it is assumed to indicate an
+ * 'and others' string which will then be linked to an ((AUTHORS)|(CREDITS))(\.txt)?
+ * file if it exists in $dir.
+ *
+ * Similarly an entry ending with ' ...]' is assumed to be a link to an
+ * 'and others' page.
+ *
+ * If no '...' string variant is found, but an authors file is found an
+ * 'and others' will be added to the end of the credits.
+ *
+ * @param string|array $authors
+ * @param string|bool $extName Name of the extension for link creation,
+ * false if no links should be created
+ * @param string $extDir Path to the extension root directory
+ *
+ * @return string HTML fragment
*/
- function listToText( $list, $sort = true ) {
- $cnt = count( $list );
+ public function listAuthors( $authors, $extName, $extDir ) {
+ $hasOthers = false;
+ $linkRenderer = $this->getLinkRenderer();
- if ( $cnt == 1 ) {
- // Enforce always returning a string
- return (string)self::arrayToString( $list[0] );
- } elseif ( $cnt == 0 ) {
- return '';
- } else {
- global $wgLang;
- if ( $sort ) {
- sort( $list );
+ $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 );
}
- return $wgLang->listToText( array_map( array( __CLASS__, 'arrayToString' ), $list ) );
}
- }
- /**
- * @param mixed $list Will convert an array to string if given and return
- * the paramater unaltered otherwise
- * @return mixed
- */
- static function arrayToString( $list ) {
- if( is_array( $list ) && count( $list ) == 1 )
- $list = $list[0];
- if( is_object( $list ) ) {
- $class = get_class( $list );
- return "($class)";
- } elseif ( !is_array( $list ) ) {
- return $list;
- } else {
- if( is_object( $list[0] ) )
- $class = get_class( $list[0] );
- else
- $class = $list[0];
- return "($class, {$list[1]})";
+ 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 );
}
/**
- * Get an associative array of information about a given path, from its .svn
- * subdirectory. Returns false on error, such as if the directory was not
- * checked out with subversion.
- *
- * Returned keys are:
- * Required:
- * checkout-rev The revision which was checked out
- * Optional:
- * directory-rev The revision when the directory was last modified
- * url The subversion URL of the directory
- * repo-url The base URL of the repository
- * viewvc-url A ViewVC URL pointing to the checked-out revision
+ * Obtains the full path of an extensions authors or credits file if
+ * one exists.
+ *
+ * @param string $extDir Path to the extensions root directory
+ *
+ * @since 1.23
+ *
+ * @return bool|string False if no such file exists, otherwise returns
+ * a path to it.
*/
- public static function getSvnInfo( $dir ) {
- // http://svnbook.red-bean.com/nightly/en/svn.developer.insidewc.html
- $entries = $dir . '/.svn/entries';
-
- if( !file_exists( $entries ) ) {
+ public static function getExtAuthorsFileName( $extDir ) {
+ if ( !$extDir ) {
return false;
}
- $lines = file( $entries );
- if ( !count( $lines ) ) {
- 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;
+ }
}
- // check if file is xml (subversion release <= 1.3) or not (subversion release = 1.4)
- if( preg_match( '/^<\?xml/', $lines[0] ) ) {
- // subversion is release <= 1.3
- if( !function_exists( 'simplexml_load_file' ) ) {
- // We could fall back to expat... YUCK
- return false;
- }
+ return false;
+ }
- // SimpleXml whines about the xmlns...
- wfSuppressWarnings();
- $xml = simplexml_load_file( $entries );
- wfRestoreWarnings();
-
- if( $xml ) {
- foreach( $xml->entry as $entry ) {
- if( $xml->entry[0]['name'] == '' ) {
- // The directory entry should always have a revision marker.
- if( $entry['revision'] ) {
- return array( 'checkout-rev' => intval( $entry['revision'] ) );
- }
- }
- }
- }
+ /**
+ * Obtains the full path of an extensions copying or license file if
+ * one exists.
+ *
+ * @param string $extDir Path to the extensions root directory
+ *
+ * @since 1.23
+ *
+ * @return bool|string False if no such file exists, otherwise returns
+ * a path to it.
+ */
+ public static function getExtLicenseFileName( $extDir ) {
+ if ( !$extDir ) {
return false;
}
- // subversion is release 1.4 or above
- if ( count( $lines ) < 11 ) {
- 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;
+ }
}
- $info = array(
- 'checkout-rev' => intval( trim( $lines[3] ) ),
- 'url' => trim( $lines[4] ),
- 'repo-url' => trim( $lines[5] ),
- 'directory-rev' => intval( trim( $lines[10] ) )
- );
- if ( isset( self::$viewvcUrls[$info['repo-url']] ) ) {
- $viewvc = str_replace(
- $info['repo-url'],
- self::$viewvcUrls[$info['repo-url']],
- $info['url']
- );
- $pathRelativeToRepo = substr( $info['url'], strlen( $info['repo-url'] ) );
- $viewvc .= '/?pathrev=';
- $viewvc .= urlencode( $info['checkout-rev'] );
- $info['viewvc-url'] = $viewvc;
+
+ return false;
+ }
+
+ /**
+ * Convert an array of items into a list for display.
+ *
+ * @param array $list List of elements to display
+ * @param bool $sort Whether to sort the items in $list
+ *
+ * @return string
+ */
+ public function listToText( $list, $sort = true ) {
+ if ( !count( $list ) ) {
+ return '';
+ }
+ if ( $sort ) {
+ sort( $list );
}
- return $info;
+
+ return $this->getLanguage()
+ ->listToText( array_map( [ __CLASS__, 'arrayToString' ], $list ) );
}
/**
- * Retrieve the revision number of a Subversion working directory.
+ * Convert an array or object to a string for display.
+ *
+ * @param mixed $list Will convert an array to string if given and return
+ * the parameter unaltered otherwise
*
- * @param String $dir Directory of the svn checkout
- * @return int revision number as int
+ * @return mixed
*/
- public static function getSvnRevision( $dir ) {
- $info = self::getSvnInfo( $dir );
- if ( $info === false ) {
- return false;
- } elseif ( isset( $info['checkout-rev'] ) ) {
- return $info['checkout-rev'];
+ 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 {
- return false;
+ if ( is_object( $list[0] ) ) {
+ $class = get_class( $list[0] );
+ } else {
+ $class = $list[0];
+ }
+
+ return wfMessage( 'parentheses' )->params( "$class, {$list[1]}" )->escaped();
+ }
+ }
+
+ /**
+ * @param string $dir Directory of the git checkout
+ * @return bool|string Sha1 of commit HEAD points to
+ */
+ public static function getGitHeadSha1( $dir ) {
+ $repo = new GitInfo( $dir );
+
+ return $repo->getHeadSHA1();
+ }
+
+ /**
+ * @param string $dir Directory of the git checkout
+ * @return bool|string Branch currently checked out
+ */
+ public static function getGitCurrentBranch( $dir ) {
+ $repo = new GitInfo( $dir );
+ return $repo->getCurrentBranch();
+ }
+
+ /**
+ * Get the list of entry points and their URLs
+ * @return string Wikitext
+ */
+ 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';
+ }
}
scripts.mit.edu / autoinstallsdev / mediawiki.git / blobdiff