includes/specials/SpecialVersion.php

   1 <?php
   2 /**
   3  * Implements Special:Version
   4  *
   5  * Copyright © 2005 Ævar Arnfjörð Bjarmason
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  20  * http://www.gnu.org/copyleft/gpl.html
  21  *
  22  * @file
  23  * @ingroup SpecialPage
  24  */
  25
  26 /**
  27  * Give information about the version of MediaWiki, PHP, the DB and extensions
  28  *
  29  * @ingroup SpecialPage
  30  */
  31 class SpecialVersion extends SpecialPage {
  32         protected $firstExtOpened = false;
  33
  34         /**
  35          * Stores the current rev id/SHA hash of MediaWiki core
  36          */
  37         protected $coreId = '';
  38
  39         protected static $extensionTypes = false;
  40
  41         protected static $viewvcUrls = array(
  42                 'svn+ssh://svn.wikimedia.org/svnroot/mediawiki' => 'http://svn.wikimedia.org/viewvc/mediawiki',
  43                 'http://svn.wikimedia.org/svnroot/mediawiki' => 'http://svn.wikimedia.org/viewvc/mediawiki',
  44                 'https://svn.wikimedia.org/svnroot/mediawiki' => 'https://svn.wikimedia.org/viewvc/mediawiki',
  45         );
  46
  47         public function __construct() {
  48                 parent::__construct( 'Version' );
  49         }
  50
  51         /**
  52          * main()
  53          * @param string|null $par
  54          */
  55         public function execute( $par ) {
  56                 global $IP, $wgExtensionCredits;
  57
  58                 $this->setHeaders();
  59                 $this->outputHeader();
  60                 $out = $this->getOutput();
  61                 $out->allowClickjacking();
  62
  63                 // Explode the sub page information into useful bits
  64                 $parts = explode( '/', (string)$par );
  65                 $extNode = null;
  66                 if ( isset( $parts[1] ) ) {
  67                         $extName = str_replace( '_', ' ', $parts[1] );
  68                         // Find it!
  69                         foreach ( $wgExtensionCredits as $group => $extensions ) {
  70                                 foreach ( $extensions as $ext ) {
  71                                         if ( isset( $ext['name'] ) && ( $ext['name'] === $extName ) ) {
  72                                                 $extNode = &$ext;
  73                                                 break 2;
  74                                         }
  75                                 }
  76                         }
  77                         if ( !$extNode ) {
  78                                 $out->setStatusCode( 404 );
  79                         }
  80                 } else {
  81                         $extName = 'MediaWiki';
  82                 }
  83
  84                 // Now figure out what to do
  85                 switch ( strtolower( $parts[0] ) ) {
  86                         case 'credits':
  87                                 $wikiText = '{{int:version-credits-not-found}}';
  88                                 if ( $extName === 'MediaWiki' ) {
  89                                         $wikiText = file_get_contents( $IP . '/CREDITS' );
  90                                 } elseif ( ( $extNode !== null ) && isset( $extNode['path'] ) ) {
  91                                         $file = $this->getExtAuthorsFileName( dirname( $extNode['path'] ) );
  92                                         if ( $file ) {
  93                                                 $wikiText = file_get_contents( $file );
  94                                                 if ( substr( $file, -4 ) === '.txt' ) {
  95                                                         $wikiText = Html::element( 'pre', array(), $wikiText );
  96                                                 }
  97                                         }
  98                                 }
  99
 100                                 $out->setPageTitle( $this->msg( 'version-credits-title', $extName ) );
 101                                 $out->addWikiText( $wikiText );
 102                                 break;
 103
 104                         case 'license':
 105                                 $wikiText = '{{int:version-license-not-found}}';
 106                                 if ( $extName === 'MediaWiki' ) {
 107                                         $wikiText = file_get_contents( $IP . '/COPYING' );
 108                                 } elseif ( ( $extNode !== null ) && isset( $extNode['path'] ) ) {
 109                                         $file = $this->getExtLicenseFileName( dirname( $extNode['path'] ) );
 110                                         if ( $file ) {
 111                                                 $wikiText = file_get_contents( $file );
 112                                                 if ( !isset( $extNode['license-name'] ) ) {
 113                                                         // If the developer did not explicitly set license-name they probably
 114                                                         // are unaware that we're now sucking this file in and thus it's probably
 115                                                         // not wikitext friendly.
 116                                                         $wikiText = "<pre>$wikiText</pre>";
 117                                                 }
 118                                         }
 119                                 }
 120
 121                                 $out->setPageTitle( $this->msg( 'version-license-title', $extName ) );
 122                                 $out->addWikiText( $wikiText );
 123                                 break;
 124
 125                         default:
 126                                 $out->addModules( 'mediawiki.special.version' );
 127                                 $out->addWikiText(
 128                                         $this->getMediaWikiCredits() .
 129                                         $this->softwareInformation() .
 130                                         $this->getEntryPointInfo()
 131                                 );
 132                                 $out->addHtml(
 133                                         $this->getSkinCredits() .
 134                                         $this->getExtensionCredits() .
 135                                         $this->getParserTags() .
 136                                         $this->getParserFunctionHooks()
 137                                 );
 138                                 $out->addWikiText( $this->getWgHooks() );
 139                                 $out->addHTML( $this->IPInfo() );
 140
 141                                 break;
 142                 }
 143         }
 144
 145         /**
 146          * Returns wiki text showing the license information.
 147          *
 148          * @return string
 149          */
 150         private static function getMediaWikiCredits() {
 151                 $ret = Xml::element(
 152                         'h2',
 153                         array( 'id' => 'mw-version-license' ),
 154                         wfMessage( 'version-license' )->text()
 155                 );
 156
 157                 // This text is always left-to-right.
 158                 $ret .= '<div class="plainlinks">';
 159                 $ret .= "__NOTOC__
 160                 " . self::getCopyrightAndAuthorList() . "\n
 161                 " . wfMessage( 'version-license-info' )->text();
 162                 $ret .= '</div>';
 163
 164                 return str_replace( "\t\t", '', $ret ) . "\n";
 165         }
 166
 167         /**
 168          * Get the "MediaWiki is copyright 2001-20xx by lots of cool guys" text
 169          *
 170          * @return string
 171          */
 172         public static function getCopyrightAndAuthorList() {
 173                 global $wgLang;
 174
 175                 if ( defined( 'MEDIAWIKI_INSTALL' ) ) {
 176                         $othersLink = '[//www.mediawiki.org/wiki/Special:Version/Credits ' .
 177                                 wfMessage( 'version-poweredby-others' )->text() . ']';
 178                 } else {
 179                         $othersLink = '[[Special:Version/Credits|' .
 180                                 wfMessage( 'version-poweredby-others' )->text() . ']]';
 181                 }
 182
 183                 $translatorsLink = '[//translatewiki.net/wiki/Translating:MediaWiki/Credits ' .
 184                         wfMessage( 'version-poweredby-translators' )->text() . ']';
 185
 186                 $authorList = array(
 187                         'Magnus Manske', 'Brion Vibber', 'Lee Daniel Crocker',
 188                         'Tim Starling', 'Erik Möller', 'Gabriel Wicke', 'Ævar Arnfjörð Bjarmason',
 189                         'Niklas Laxström', 'Domas Mituzas', 'Rob Church', 'Yuri Astrakhan',
 190                         'Aryeh Gregor', 'Aaron Schulz', 'Andrew Garrett', 'Raimond Spekking',
 191                         'Alexandre Emsenhuber', 'Siebrand Mazeland', 'Chad Horohoe',
 192                         'Roan Kattouw', 'Trevor Parscal', 'Bryan Tong Minh', 'Sam Reed',
 193                         'Victor Vasiliev', 'Rotem Liss', 'Platonides', 'Antoine Musso',
 194                         'Timo Tijhof', 'Daniel Kinzler', 'Jeroen De Dauw', $othersLink,
 195                         $translatorsLink
 196                 );
 197
 198                 return wfMessage( 'version-poweredby-credits', MWTimestamp::getLocalInstance()->format( 'Y' ),
 199                         $wgLang->listToText( $authorList ) )->text();
 200         }
 201
 202         /**
 203          * Returns wiki text showing the third party software versions (apache, php, mysql).
 204          *
 205          * @return string
 206          */
 207         public static function softwareInformation() {
 208                 $dbr = wfGetDB( DB_SLAVE );
 209
 210                 // Put the software in an array of form 'name' => 'version'. All messages should
 211                 // be loaded here, so feel free to use wfMessage in the 'name'. Raw HTML or
 212                 // wikimarkup can be used.
 213                 $software = array();
 214                 $software['[https://www.mediawiki.org/ MediaWiki]'] = self::getVersionLinked();
 215                 if ( wfIsHHVM() ) {
 216                         $software['[http://hhvm.com/ HHVM]'] = HHVM_VERSION . " (" . PHP_SAPI . ")";
 217                 } else {
 218                         $software['[https://php.net/ PHP]'] = PHP_VERSION . " (" . PHP_SAPI . ")";
 219                 }
 220                 $software[$dbr->getSoftwareLink()] = $dbr->getServerInfo();
 221
 222                 // Allow a hook to add/remove items.
 223                 wfRunHooks( 'SoftwareInfo', array( &$software ) );
 224
 225                 $out = Xml::element(
 226                                 'h2',
 227                                 array( 'id' => 'mw-version-software' ),
 228                                 wfMessage( 'version-software' )->text()
 229                         ) .
 230                                 Xml::openElement( 'table', array( 'class' => 'wikitable plainlinks', 'id' => 'sv-software' ) ) .
 231                                 "<tr>
 232                                         <th>" . wfMessage( 'version-software-product' )->text() . "</th>
 233                                         <th>" . wfMessage( 'version-software-version' )->text() . "</th>
 234                                 </tr>\n";
 235
 236                 foreach ( $software as $name => $version ) {
 237                         $out .= "<tr>
 238                                         <td>" . $name . "</td>
 239                                         <td dir=\"ltr\">" . $version . "</td>
 240                                 </tr>\n";
 241                 }
 242
 243                 return $out . Xml::closeElement( 'table' );
 244         }
 245
 246         /**
 247          * Return a string of the MediaWiki version with SVN revision if available.
 248          *
 249          * @param string $flags
 250          * @return mixed
 251          */
 252         public static function getVersion( $flags = '' ) {
 253                 global $wgVersion, $IP;
 254                 wfProfileIn( __METHOD__ );
 255
 256                 $gitInfo = self::getGitHeadSha1( $IP );
 257                 $svnInfo = self::getSvnInfo( $IP );
 258                 if ( !$svnInfo && !$gitInfo ) {
 259                         $version = $wgVersion;
 260                 } elseif ( $gitInfo && $flags === 'nodb' ) {
 261                         $shortSha1 = substr( $gitInfo, 0, 7 );
 262                         $version = "$wgVersion ($shortSha1)";
 263                 } elseif ( $gitInfo ) {
 264                         $shortSha1 = substr( $gitInfo, 0, 7 );
 265                         $shortSha1 = wfMessage( 'parentheses' )->params( $shortSha1 )->escaped();
 266                         $version = "$wgVersion $shortSha1";
 267                 } elseif ( $flags === 'nodb' ) {
 268                         $version = "$wgVersion (r{$svnInfo['checkout-rev']})";
 269                 } else {
 270                         $version = $wgVersion . ' ' .
 271                                 wfMessage(
 272                                         'version-svn-revision',
 273                                         isset( $info['directory-rev'] ) ? $info['directory-rev'] : '',
 274                                         $info['checkout-rev']
 275                                 )->text();
 276                 }
 277
 278                 wfProfileOut( __METHOD__ );
 279
 280                 return $version;
 281         }
 282
 283         /**
 284          * Return a wikitext-formatted string of the MediaWiki version with a link to
 285          * the SVN revision or the git SHA1 of head if available.
 286          * Git is prefered over Svn
 287          * The fallback is just $wgVersion
 288          *
 289          * @return mixed
 290          */
 291         public static function getVersionLinked() {
 292                 global $wgVersion;
 293                 wfProfileIn( __METHOD__ );
 294
 295                 $gitVersion = self::getVersionLinkedGit();
 296                 if ( $gitVersion ) {
 297                         $v = $gitVersion;
 298                 } else {
 299                         $svnVersion = self::getVersionLinkedSvn();
 300                         if ( $svnVersion ) {
 301                                 $v = $svnVersion;
 302                         } else {
 303                                 $v = $wgVersion; // fallback
 304                         }
 305                 }
 306
 307                 wfProfileOut( __METHOD__ );
 308
 309                 return $v;
 310         }
 311
 312         /**
 313          * @return string Global wgVersion + a link to subversion revision of svn BASE
 314          */
 315         private static function getVersionLinkedSvn() {
 316                 global $IP;
 317
 318                 $info = self::getSvnInfo( $IP );
 319                 if ( !isset( $info['checkout-rev'] ) ) {
 320                         return false;
 321                 }
 322
 323                 $linkText = wfMessage(
 324                         'version-svn-revision',
 325                         isset( $info['directory-rev'] ) ? $info['directory-rev'] : '',
 326                         $info['checkout-rev']
 327                 )->text();
 328
 329                 if ( isset( $info['viewvc-url'] ) ) {
 330                         $version = "[{$info['viewvc-url']} $linkText]";
 331                 } else {
 332                         $version = $linkText;
 333                 }
 334
 335                 return self::getwgVersionLinked() . " $version";
 336         }
 337
 338         /**
 339          * @return string
 340          */
 341         private static function getwgVersionLinked() {
 342                 global $wgVersion;
 343                 $versionUrl = "";
 344                 if ( wfRunHooks( 'SpecialVersionVersionUrl', array( $wgVersion, &$versionUrl ) ) ) {
 345                         $versionParts = array();
 346                         preg_match( "/^(\d+\.\d+)/", $wgVersion, $versionParts );
 347                         $versionUrl = "https://www.mediawiki.org/wiki/MediaWiki_{$versionParts[1]}";
 348                 }
 349
 350                 return "[$versionUrl $wgVersion]";
 351         }
 352
 353         /**
 354          * @since 1.22 Returns the HEAD date in addition to the sha1 and link
 355          * @return bool|string Global wgVersion + HEAD sha1 stripped to the first 7 chars
 356          *   with link and date, or false on failure
 357          */
 358         private static function getVersionLinkedGit() {
 359                 global $IP, $wgLang;
 360
 361                 $gitInfo = new GitInfo( $IP );
 362                 $headSHA1 = $gitInfo->getHeadSHA1();
 363                 if ( !$headSHA1 ) {
 364                         return false;
 365                 }
 366
 367                 $shortSHA1 = '(' . substr( $headSHA1, 0, 7 ) . ')';
 368
 369                 $gitHeadUrl = $gitInfo->getHeadViewUrl();
 370                 if ( $gitHeadUrl !== false ) {
 371                         $shortSHA1 = "[$gitHeadUrl $shortSHA1]";
 372                 }
 373
 374                 $gitHeadCommitDate = $gitInfo->getHeadCommitDate();
 375                 if ( $gitHeadCommitDate ) {
 376                         $shortSHA1 .= Html::element( 'br' ) . $wgLang->timeanddate( $gitHeadCommitDate, true );
 377                 }
 378
 379                 return self::getwgVersionLinked() . " $shortSHA1";
 380         }
 381
 382         /**
 383          * Returns an array with the base extension types.
 384          * Type is stored as array key, the message as array value.
 385          *
 386          * TODO: ideally this would return all extension types.
 387          *
 388          * @since 1.17
 389          *
 390          * @return array
 391          */
 392         public static function getExtensionTypes() {
 393                 if ( self::$extensionTypes === false ) {
 394                         self::$extensionTypes = array(
 395                                 'specialpage' => wfMessage( 'version-specialpages' )->text(),
 396                                 'parserhook' => wfMessage( 'version-parserhooks' )->text(),
 397                                 'variable' => wfMessage( 'version-variables' )->text(),
 398                                 'media' => wfMessage( 'version-mediahandlers' )->text(),
 399                                 'antispam' => wfMessage( 'version-antispam' )->text(),
 400                                 'skin' => wfMessage( 'version-skins' )->text(),
 401                                 'api' => wfMessage( 'version-api' )->text(),
 402                                 'other' => wfMessage( 'version-other' )->text(),
 403                         );
 404
 405                         wfRunHooks( 'ExtensionTypes', array( &self::$extensionTypes ) );
 406                 }
 407
 408                 return self::$extensionTypes;
 409         }
 410
 411         /**
 412          * Returns the internationalized name for an extension type.
 413          *
 414          * @since 1.17
 415          *
 416          * @param string $type
 417          *
 418          * @return string
 419          */
 420         public static function getExtensionTypeName( $type ) {
 421                 $types = self::getExtensionTypes();
 422
 423                 return isset( $types[$type] ) ? $types[$type] : $types['other'];
 424         }
 425
 426         /**
 427          * Generate wikitext showing the name, URL, author and description of each extension.
 428          *
 429          * @return string Wikitext
 430          */
 431         public function getExtensionCredits() {
 432                 global $wgExtensionCredits;
 433
 434                 if (
 435                         count( $wgExtensionCredits ) === 0 ||
 436                         // Skins are displayed separately, see getSkinCredits()
 437                         ( count( $wgExtensionCredits ) === 1 && isset( $wgExtensionCredits['skin'] ) )
 438                 ) {
 439                         return '';
 440                 }
 441
 442                 $extensionTypes = self::getExtensionTypes();
 443
 444                 $out = Xml::element(
 445                                 'h2',
 446                                 array( 'id' => 'mw-version-ext' ),
 447                                 $this->msg( 'version-extensions' )->text()
 448                         ) .
 449                         Xml::openElement( 'table', array( 'class' => 'wikitable plainlinks', 'id' => 'sv-ext' ) );
 450
 451                 // Make sure the 'other' type is set to an array.
 452                 if ( !array_key_exists( 'other', $wgExtensionCredits ) ) {
 453                         $wgExtensionCredits['other'] = array();
 454                 }
 455
 456                 // Find all extensions that do not have a valid type and give them the type 'other'.
 457                 foreach ( $wgExtensionCredits as $type => $extensions ) {
 458                         if ( !array_key_exists( $type, $extensionTypes ) ) {
 459                                 $wgExtensionCredits['other'] = array_merge( $wgExtensionCredits['other'], $extensions );
 460                         }
 461                 }
 462
 463                 $this->firstExtOpened = false;
 464                 // Loop through the extension categories to display their extensions in the list.
 465                 foreach ( $extensionTypes as $type => $message ) {
 466                         // Skins have a separate section
 467                         if ( $type !== 'other' && $type !== 'skin' ) {
 468                                 $out .= $this->getExtensionCategory( $type, $message );
 469                         }
 470                 }
 471
 472                 // We want the 'other' type to be last in the list.
 473                 $out .= $this->getExtensionCategory( 'other', $extensionTypes['other'] );
 474
 475                 $out .= Xml::closeElement( 'table' );
 476
 477                 return $out;
 478         }
 479
 480         /**
 481          * Generate wikitext showing the name, URL, author and description of each skin.
 482          *
 483          * @return string Wikitext
 484          */
 485         public function getSkinCredits() {
 486                 global $wgExtensionCredits;
 487                 if ( !isset( $wgExtensionCredits['skin'] ) || count( $wgExtensionCredits['skin'] ) === 0 ) {
 488                         return '';
 489                 }
 490
 491                 $out = Xml::element(
 492                                 'h2',
 493                                 array( 'id' => 'mw-version-skin' ),
 494                                 $this->msg( 'version-skins' )->text()
 495                         ) .
 496                         Xml::openElement( 'table', array( 'class' => 'wikitable plainlinks', 'id' => 'sv-skin' ) );
 497
 498                 $this->firstExtOpened = false;
 499                 $out .= $this->getExtensionCategory( 'skin', null );
 500
 501                 $out .= Xml::closeElement( 'table' );
 502
 503                 return $out;
 504         }
 505
 506         /**
 507          * Obtains a list of installed parser tags and the associated H2 header
 508          *
 509          * @return string HTML output
 510          */
 511         protected function getParserTags() {
 512                 global $wgParser;
 513
 514                 $tags = $wgParser->getTags();
 515
 516                 if ( count( $tags ) ) {
 517                         $out = Html::rawElement(
 518                                 'h2',
 519                                 array( 'class' => 'mw-headline' ),
 520                                 Linker::makeExternalLink(
 521                                         '//www.mediawiki.org/wiki/Special:MyLanguage/Manual:Tag_extensions',
 522                                         $this->msg( 'version-parser-extensiontags' )->parse(),
 523                                         false /* msg()->parse() already escapes */
 524                                 )
 525                         );
 526
 527                         array_walk( $tags, function ( &$value ) {
 528                                 // Bidirectional isolation improves readability in RTL wikis
 529                                 $value = Html::element(
 530                                         'bdi',
 531                                         // Prevent < and > from slipping to another line
 532                                         array(
 533                                                 'style' => 'white-space: nowrap;',
 534                                         ),
 535                                         "<$value>"
 536                                 );
 537                         } );
 538
 539                         $out .= $this->listToText( $tags );
 540                 } else {
 541                         $out = '';
 542                 }
 543
 544                 return $out;
 545         }
 546
 547         /**
 548          * Obtains a list of installed parser function hooks and the associated H2 header
 549          *
 550          * @return string HTML output
 551          */
 552         protected function getParserFunctionHooks() {
 553                 global $wgParser;
 554
 555                 $fhooks = $wgParser->getFunctionHooks();
 556                 if ( count( $fhooks ) ) {
 557                         $out = Html::rawElement( 'h2', array( 'class' => 'mw-headline' ), Linker::makeExternalLink(
 558                                 '//www.mediawiki.org/wiki/Special:MyLanguage/Manual:Parser_functions',
 559                                 $this->msg( 'version-parser-function-hooks' )->parse(),
 560                                 false /* msg()->parse() already escapes */
 561                         ) );
 562
 563                         $out .= $this->listToText( $fhooks );
 564                 } else {
 565                         $out = '';
 566                 }
 567
 568                 return $out;
 569         }
 570
 571         /**
 572          * Creates and returns the HTML for a single extension category.
 573          *
 574          * @since 1.17
 575          *
 576          * @param string $type
 577          * @param string $message
 578          *
 579          * @return string
 580          */
 581         protected function getExtensionCategory( $type, $message ) {
 582                 global $wgExtensionCredits;
 583
 584                 $out = '';
 585
 586                 if ( array_key_exists( $type, $wgExtensionCredits ) && count( $wgExtensionCredits[$type] ) > 0 ) {
 587                         $out .= $this->openExtType( $message, 'credits-' . $type );
 588
 589                         usort( $wgExtensionCredits[$type], array( $this, 'compare' ) );
 590
 591                         foreach ( $wgExtensionCredits[$type] as $extension ) {
 592                                 $out .= $this->getCreditsForExtension( $extension );
 593                         }
 594                 }
 595
 596                 return $out;
 597         }
 598
 599         /**
 600          * Callback to sort extensions by type.
 601          * @param array $a
 602          * @param array $b
 603          * @return int
 604          */
 605         public function compare( $a, $b ) {
 606                 if ( $a['name'] === $b['name'] ) {
 607                         return 0;
 608                 } else {
 609                         return $this->getLanguage()->lc( $a['name'] ) > $this->getLanguage()->lc( $b['name'] )
 610                                 ? 1
 611                                 : -1;
 612                 }
 613         }
 614
 615         /**
 616          * Creates and formats a version line for a single extension.
 617          *
 618          * Information for five columns will be created. Parameters required in the
 619          * $extension array for part rendering are indicated in ()
 620          *  - The name of (name), and URL link to (url), the extension
 621          *  - Official version number (version) and if available version control system
 622          *    revision (path), link, and date
 623          *  - If available the short name of the license (license-name) and a linke
 624          *    to ((LICENSE)|(COPYING))(\.txt)? if it exists.
 625          *  - Description of extension (descriptionmsg or description)
 626          *  - List of authors (author) and link to a ((AUTHORS)|(CREDITS))(\.txt)? file if it exists
 627          *
 628          * @param array $extension
 629          *
 630          * @return string Raw HTML
 631          */
 632         public function getCreditsForExtension( array $extension ) {
 633                 $out = $this->getOutput();
 634
 635                 // We must obtain the information for all the bits and pieces!
 636                 // ... such as extension names and links
 637                 if ( isset( $extension['namemsg'] ) ) {
 638                         // Localized name of extension
 639                         $extensionName = $this->msg( $extension['namemsg'] )->text();
 640                 } elseif ( isset( $extension['name'] ) ) {
 641                         // Non localized version
 642                         $extensionName = $extension['name'];
 643                 } else {
 644                         $extensionName = $this->msg( 'version-no-ext-name' )->text();
 645                 }
 646
 647                 if ( isset( $extension['url'] ) ) {
 648                         $extensionNameLink = Linker::makeExternalLink(
 649                                 $extension['url'],
 650                                 $extensionName,
 651                                 true,
 652                                 '',
 653                                 array( 'class' => 'mw-version-ext-name' )
 654                         );
 655                 } else {
 656                         $extensionNameLink = $extensionName;
 657                 }
 658
 659                 // ... and the version information
 660                 // If the extension path is set we will check that directory for GIT and SVN
 661                 // metadata in an attempt to extract date and vcs commit metadata.
 662                 $canonicalVersion = '&ndash;';
 663                 $extensionPath = null;
 664                 $vcsVersion = null;
 665                 $vcsLink = null;
 666                 $vcsDate = null;
 667
 668                 if ( isset( $extension['version'] ) ) {
 669                         $canonicalVersion = $out->parseInline( $extension['version'] );
 670                 }
 671
 672                 if ( isset( $extension['path'] ) ) {
 673                         global $IP;
 674                         $extensionPath = dirname( $extension['path'] );
 675                         if ( $this->coreId == '' ) {
 676                                 wfDebug( 'Looking up core head id' );
 677                                 $coreHeadSHA1 = self::getGitHeadSha1( $IP );
 678                                 if ( $coreHeadSHA1 ) {
 679                                         $this->coreId = $coreHeadSHA1;
 680                                 } else {
 681                                         $svnInfo = self::getSvnInfo( $IP );
 682                                         if ( $svnInfo !== false ) {
 683                                                 $this->coreId = $svnInfo['checkout-rev'];
 684                                         }
 685                                 }
 686                         }
 687                         $cache = wfGetCache( CACHE_ANYTHING );
 688                         $memcKey = wfMemcKey( 'specialversion-ext-version-text', $extension['path'], $this->coreId );
 689                         list( $vcsVersion, $vcsLink, $vcsDate ) = $cache->get( $memcKey );
 690
 691                         if ( !$vcsVersion ) {
 692                                 wfDebug( "Getting VCS info for extension $extensionName" );
 693                                 $gitInfo = new GitInfo( $extensionPath );
 694                                 $vcsVersion = $gitInfo->getHeadSHA1();
 695                                 if ( $vcsVersion !== false ) {
 696                                         $vcsVersion = substr( $vcsVersion, 0, 7 );
 697                                         $vcsLink = $gitInfo->getHeadViewUrl();
 698                                         $vcsDate = $gitInfo->getHeadCommitDate();
 699                                 } else {
 700                                         $svnInfo = self::getSvnInfo( $extensionPath );
 701                                         if ( $svnInfo !== false ) {
 702                                                 $vcsVersion = $this->msg( 'version-svn-revision', $svnInfo['checkout-rev'] )->text();
 703                                                 $vcsLink = isset( $svnInfo['viewvc-url'] ) ? $svnInfo['viewvc-url'] : '';
 704                                         }
 705                                 }
 706                                 $cache->set( $memcKey, array( $vcsVersion, $vcsLink, $vcsDate ), 60 * 60 * 24 );
 707                         } else {
 708                                 wfDebug( "Pulled VCS info for extension $extensionName from cache" );
 709                         }
 710                 }
 711
 712                 $versionString = Html::rawElement(
 713                         'span',
 714                         array( 'class' => 'mw-version-ext-version' ),
 715                         $canonicalVersion
 716                 );
 717
 718                 if ( $vcsVersion ) {
 719                         if ( $vcsLink ) {
 720                                 $vcsVerString = Linker::makeExternalLink(
 721                                         $vcsLink,
 722                                         $this->msg( 'version-version', $vcsVersion ),
 723                                         true,
 724                                         '',
 725                                         array( 'class' => 'mw-version-ext-vcs-version' )
 726                                 );
 727                         } else {
 728                                 $vcsVerString = Html::element( 'span',
 729                                         array( 'class' => 'mw-version-ext-vcs-version' ),
 730                                         "({$vcsVersion})"
 731                                 );
 732                         }
 733                         $versionString .= " {$vcsVerString}";
 734
 735                         if ( $vcsDate ) {
 736                                 $vcsTimeString = Html::element( 'span',
 737                                         array( 'class' => 'mw-version-ext-vcs-timestamp' ),
 738                                         $this->getLanguage()->timeanddate( $vcsDate, true )
 739                                 );
 740                                 $versionString .= " {$vcsTimeString}";
 741                         }
 742                         $versionString = Html::rawElement( 'span',
 743                                 array( 'class' => 'mw-version-ext-meta-version' ),
 744                                 $versionString
 745                         );
 746                 }
 747
 748                 // ... and license information; if a license file exists we
 749                 // will link to it
 750                 $licenseLink = '';
 751                 if ( isset( $extension['license-name'] ) ) {
 752                         $licenseLink = Linker::link(
 753                                 $this->getPageTitle( 'License/' . $extensionName ),
 754                                 $out->parseInline( $extension['license-name'] ),
 755                                 array( 'class' => 'mw-version-ext-license' )
 756                         );
 757                 } elseif ( $this->getExtLicenseFileName( $extensionPath ) ) {
 758                         $licenseLink = Linker::link(
 759                                 $this->getPageTitle( 'License/' . $extensionName ),
 760                                 $this->msg( 'version-ext-license' ),
 761                                 array( 'class' => 'mw-version-ext-license' )
 762                         );
 763                 }
 764
 765                 // ... and generate the description; which can be a parameterized l10n message
 766                 // in the form array( <msgname>, <parameter>, <parameter>... ) or just a straight
 767                 // up string
 768                 if ( isset( $extension['descriptionmsg'] ) ) {
 769                         // Localized description of extension
 770                         $descriptionMsg = $extension['descriptionmsg'];
 771
 772                         if ( is_array( $descriptionMsg ) ) {
 773                                 $descriptionMsgKey = $descriptionMsg[0]; // Get the message key
 774                                 array_shift( $descriptionMsg ); // Shift out the message key to get the parameters only
 775                                 array_map( "htmlspecialchars", $descriptionMsg ); // For sanity
 776                                 $description = $this->msg( $descriptionMsgKey, $descriptionMsg )->text();
 777                         } else {
 778                                 $description = $this->msg( $descriptionMsg )->text();
 779                         }
 780                 } elseif ( isset( $extension['description'] ) ) {
 781                         // Non localized version
 782                         $description = $extension['description'];
 783                 } else {
 784                         $description = '';
 785                 }
 786                 $description = $out->parseInline( $description );
 787
 788                 // ... now get the authors for this extension
 789                 $authors = isset( $extension['author'] ) ? $extension['author'] : array();
 790                 $authors = $this->listAuthors( $authors, $extensionName, $extensionPath );
 791
 792                 // Finally! Create the table
 793                 $html = Html::openElement( 'tr', array(
 794                                 'class' => 'mw-version-ext',
 795                                 'id' => "mw-version-ext-{$extensionName}"
 796                         )
 797                 );
 798
 799                 $html .= Html::rawElement( 'td', array(), $extensionNameLink );
 800                 $html .= Html::rawElement( 'td', array(), $versionString );
 801                 $html .= Html::rawElement( 'td', array(), $licenseLink );
 802                 $html .= Html::rawElement( 'td', array( 'class' => 'mw-version-ext-description' ), $description );
 803                 $html .= Html::rawElement( 'td', array( 'class' => 'mw-version-ext-authors' ), $authors );
 804
 805                 $html .= Html::closeElement( 'td' );
 806
 807                 return $html;
 808         }
 809
 810         /**
 811          * Generate wikitext showing hooks in $wgHooks.
 812          *
 813          * @return string Wikitext
 814          */
 815         private function getWgHooks() {
 816                 global $wgSpecialVersionShowHooks, $wgHooks;
 817
 818                 if ( $wgSpecialVersionShowHooks && count( $wgHooks ) ) {
 819                         $myWgHooks = $wgHooks;
 820                         ksort( $myWgHooks );
 821
 822                         $ret = array();
 823                         $ret[] = '== {{int:version-hooks}} ==';
 824                         $ret[] = Html::openElement( 'table', array( 'class' => 'wikitable', 'id' => 'sv-hooks' ) );
 825                         $ret[] = Html::openElement( 'tr' );
 826                         $ret[] = Html::element( 'th', array(), $this->msg( 'version-hook-name' )->text() );
 827                         $ret[] = Html::element( 'th', array(), $this->msg( 'version-hook-subscribedby' )->text() );
 828                         $ret[] = Html::closeElement( 'tr' );
 829
 830                         foreach ( $myWgHooks as $hook => $hooks ) {
 831                                 $ret[] = Html::openElement( 'tr' );
 832                                 $ret[] = Html::element( 'td', array(), $hook );
 833                                 $ret[] = Html::element( 'td', array(), $this->listToText( $hooks ) );
 834                                 $ret[] = Html::closeElement( 'tr' );
 835                         }
 836
 837                         $ret[] = Html::closeElement( 'table' );
 838
 839                         return implode( "\n", $ret );
 840                 } else {
 841                         return '';
 842                 }
 843         }
 844
 845         private function openExtType( $text = null, $name = null ) {
 846                 $out = '';
 847
 848                 $opt = array( 'colspan' => 5 );
 849                 if ( $this->firstExtOpened ) {
 850                         // Insert a spacing line
 851                         $out .= Html::rawElement( 'tr', array( 'class' => 'sv-space' ),
 852                                 Html::element( 'td', $opt )
 853                         );
 854                 }
 855                 $this->firstExtOpened = true;
 856
 857                 if ( $name ) {
 858                         $opt['id'] = "sv-$name";
 859                 }
 860
 861                 if ( $text !== null ) {
 862                         $out .= Html::rawElement( 'tr', array(),
 863                                 Html::element( 'th', $opt, $text )
 864                         );
 865                 }
 866
 867                 $firstHeadingMsg = ( $name === 'credits-skin' )
 868                         ? 'version-skin-colheader-name'
 869                         : 'version-ext-colheader-name';
 870                 $out .= Html::openElement( 'tr' );
 871                 $out .= Html::element( 'th', array( 'class' => 'mw-version-ext-col-label' ),
 872                         $this->msg( $firstHeadingMsg )->text() );
 873                 $out .= Html::element( 'th', array( 'class' => 'mw-version-ext-col-label' ),
 874                         $this->msg( 'version-ext-colheader-version' )->text() );
 875                 $out .= Html::element( 'th', array( 'class' => 'mw-version-ext-col-label' ),
 876                         $this->msg( 'version-ext-colheader-license' )->text() );
 877                 $out .= Html::element( 'th', array( 'class' => 'mw-version-ext-col-label' ),
 878                         $this->msg( 'version-ext-colheader-description' )->text() );
 879                 $out .= Html::element( 'th', array( 'class' => 'mw-version-ext-col-label' ),
 880                         $this->msg( 'version-ext-colheader-credits' )->text() );
 881                 $out .= Html::closeElement( 'tr' );
 882
 883                 return $out;
 884         }
 885
 886         /**
 887          * Get information about client's IP address.
 888          *
 889          * @return string HTML fragment
 890          */
 891         private function IPInfo() {
 892                 $ip = str_replace( '--', ' - ', htmlspecialchars( $this->getRequest()->getIP() ) );
 893
 894                 return "<!-- visited from $ip -->\n<span style='display:none'>visited from $ip</span>";
 895         }
 896
 897         /**
 898          * Return a formatted unsorted list of authors
 899          *
 900          * 'And Others'
 901          *   If an item in the $authors array is '...' it is assumed to indicate an
 902          *   'and others' string which will then be linked to an ((AUTHORS)|(CREDITS))(\.txt)?
 903          *   file if it exists in $dir.
 904          *
 905          *   Similarly an entry ending with ' ...]' is assumed to be a link to an
 906          *   'and others' page.
 907          *
 908          *   If no '...' string variant is found, but an authors file is found an
 909          *   'and others' will be added to the end of the credits.
 910          *
 911          * @param string|array $authors
 912          * @param string $extName Name of the extension for link creation
 913          * @param string $extDir Path to the extension root directory
 914          *
 915          * @return string HTML fragment
 916          */
 917         public function listAuthors( $authors, $extName, $extDir ) {
 918                 $hasOthers = false;
 919
 920                 $list = array();
 921                 foreach ( (array)$authors as $item ) {
 922                         if ( $item == '...' ) {
 923                                 $hasOthers = true;
 924
 925                                 if ( $this->getExtAuthorsFileName( $extDir ) ) {
 926                                         $text = Linker::link(
 927                                                 $this->getPageTitle( "Credits/$extName" ),
 928                                                 $this->msg( 'version-poweredby-others' )->text()
 929                                         );
 930                                 } else {
 931                                         $text = $this->msg( 'version-poweredby-others' )->text();
 932                                 }
 933                                 $list[] = $text;
 934                         } elseif ( substr( $item, -5 ) == ' ...]' ) {
 935                                 $hasOthers = true;
 936                                 $list[] = $this->getOutput()->parseInline(
 937                                         substr( $item, 0, -4 ) . $this->msg( 'version-poweredby-others' )->text() . "]"
 938                                 );
 939                         } else {
 940                                 $list[] = $this->getOutput()->parseInline( $item );
 941                         }
 942                 }
 943
 944                 if ( !$hasOthers && $this->getExtAuthorsFileName( $extDir ) ) {
 945                         $list[] = $text = Linker::link(
 946                                 $this->getPageTitle( "Credits/$extName" ),
 947                                 $this->msg( 'version-poweredby-others' )->text()
 948                         );
 949                 }
 950
 951                 return $this->listToText( $list, false );
 952         }
 953
 954         /**
 955          * Obtains the full path of an extensions authors or credits file if
 956          * one exists.
 957          *
 958          * @param string $extDir Path to the extensions root directory
 959          *
 960          * @since 1.23
 961          *
 962          * @return bool|string False if no such file exists, otherwise returns
 963          * a path to it.
 964          */
 965         public static function getExtAuthorsFileName( $extDir ) {
 966                 if ( !$extDir ) {
 967                         return false;
 968                 }
 969
 970                 foreach ( scandir( $extDir ) as $file ) {
 971                         $fullPath = $extDir . DIRECTORY_SEPARATOR . $file;
 972                         if ( preg_match( '/^((AUTHORS)|(CREDITS))(\.txt)?$/', $file ) &&
 973                                 is_readable( $fullPath ) &&
 974                                 is_file( $fullPath )
 975                         ) {
 976                                 return $fullPath;
 977                         }
 978                 }
 979
 980                 return false;
 981         }
 982
 983         /**
 984          * Obtains the full path of an extensions copying or license file if
 985          * one exists.
 986          *
 987          * @param string $extDir Path to the extensions root directory
 988          *
 989          * @since 1.23
 990          *
 991          * @return bool|string False if no such file exists, otherwise returns
 992          * a path to it.
 993          */
 994         public static function getExtLicenseFileName( $extDir ) {
 995                 if ( !$extDir ) {
 996                         return false;
 997                 }
 998
 999                 foreach ( scandir( $extDir ) as $file ) {
1000                         $fullPath = $extDir . DIRECTORY_SEPARATOR . $file;
1001                         if ( preg_match( '/^((COPYING)|(LICENSE))(\.txt)?$/', $file ) &&
1002                                 is_readable( $fullPath ) &&
1003                                 is_file( $fullPath )
1004                         ) {
1005                                 return $fullPath;
1006                         }
1007                 }
1008
1009                 return false;
1010         }
1011
1012         /**
1013          * Convert an array of items into a list for display.
1014          *
1015          * @param array $list List of elements to display
1016          * @param bool $sort Whether to sort the items in $list
1017          *
1018          * @return string
1019          */
1020         public function listToText( $list, $sort = true ) {
1021                 if ( !count( $list ) ) {
1022                         return '';
1023                 }
1024                 if ( $sort ) {
1025                         sort( $list );
1026                 }
1027
1028                 return $this->getLanguage()
1029                         ->listToText( array_map( array( __CLASS__, 'arrayToString' ), $list ) );
1030         }
1031
1032         /**
1033          * Convert an array or object to a string for display.
1034          *
1035          * @param mixed $list Will convert an array to string if given and return
1036          *   the paramater unaltered otherwise
1037          *
1038          * @return mixed
1039          */
1040         public static function arrayToString( $list ) {
1041                 if ( is_array( $list ) && count( $list ) == 1 ) {
1042                         $list = $list[0];
1043                 }
1044                 if ( is_object( $list ) ) {
1045                         $class = wfMessage( 'parentheses' )->params( get_class( $list ) )->escaped();
1046
1047                         return $class;
1048                 } elseif ( !is_array( $list ) ) {
1049                         return $list;
1050                 } else {
1051                         if ( is_object( $list[0] ) ) {
1052                                 $class = get_class( $list[0] );
1053                         } else {
1054                                 $class = $list[0];
1055                         }
1056
1057                         return wfMessage( 'parentheses' )->params( "$class, {$list[1]}" )->escaped();
1058                 }
1059         }
1060
1061         /**
1062          * Get an associative array of information about a given path, from its .svn
1063          * subdirectory. Returns false on error, such as if the directory was not
1064          * checked out with subversion.
1065          *
1066          * Returned keys are:
1067          *    Required:
1068          *        checkout-rev          The revision which was checked out
1069          *    Optional:
1070          *        directory-rev         The revision when the directory was last modified
1071          *        url                   The subversion URL of the directory
1072          *        repo-url              The base URL of the repository
1073          *        viewvc-url            A ViewVC URL pointing to the checked-out revision
1074          * @param string $dir
1075          * @return array|bool
1076          */
1077         public static function getSvnInfo( $dir ) {
1078                 // http://svnbook.red-bean.com/nightly/en/svn.developer.insidewc.html
1079                 $entries = $dir . '/.svn/entries';
1080
1081                 if ( !file_exists( $entries ) ) {
1082                         return false;
1083                 }
1084
1085                 $lines = file( $entries );
1086                 if ( !count( $lines ) ) {
1087                         return false;
1088                 }
1089
1090                 // check if file is xml (subversion release <= 1.3) or not (subversion release = 1.4)
1091                 if ( preg_match( '/^<\?xml/', $lines[0] ) ) {
1092                         // subversion is release <= 1.3
1093                         if ( !function_exists( 'simplexml_load_file' ) ) {
1094                                 // We could fall back to expat... YUCK
1095                                 return false;
1096                         }
1097
1098                         // SimpleXml whines about the xmlns...
1099                         wfSuppressWarnings();
1100                         $xml = simplexml_load_file( $entries );
1101                         wfRestoreWarnings();
1102
1103                         if ( $xml ) {
1104                                 foreach ( $xml->entry as $entry ) {
1105                                         if ( $xml->entry[0]['name'] == '' ) {
1106                                                 // The directory entry should always have a revision marker.
1107                                                 if ( $entry['revision'] ) {
1108                                                         return array( 'checkout-rev' => intval( $entry['revision'] ) );
1109                                                 }
1110                                         }
1111                                 }
1112                         }
1113
1114                         return false;
1115                 }
1116
1117                 // Subversion is release 1.4 or above.
1118                 if ( count( $lines ) < 11 ) {
1119                         return false;
1120                 }
1121
1122                 $info = array(
1123                         'checkout-rev' => intval( trim( $lines[3] ) ),
1124                         'url' => trim( $lines[4] ),
1125                         'repo-url' => trim( $lines[5] ),
1126                         'directory-rev' => intval( trim( $lines[10] ) )
1127                 );
1128
1129                 if ( isset( self::$viewvcUrls[$info['repo-url']] ) ) {
1130                         $viewvc = str_replace(
1131                                 $info['repo-url'],
1132                                 self::$viewvcUrls[$info['repo-url']],
1133                                 $info['url']
1134                         );
1135
1136                         $viewvc .= '/?pathrev=';
1137                         $viewvc .= urlencode( $info['checkout-rev'] );
1138                         $info['viewvc-url'] = $viewvc;
1139                 }
1140
1141                 return $info;
1142         }
1143
1144         /**
1145          * Retrieve the revision number of a Subversion working directory.
1146          *
1147          * @param string $dir Directory of the svn checkout
1148          *
1149          * @return int Revision number
1150          */
1151         public static function getSvnRevision( $dir ) {
1152                 $info = self::getSvnInfo( $dir );
1153
1154                 if ( $info === false ) {
1155                         return false;
1156                 } elseif ( isset( $info['checkout-rev'] ) ) {
1157                         return $info['checkout-rev'];
1158                 } else {
1159                         return false;
1160                 }
1161         }
1162
1163         /**
1164          * @param string $dir Directory of the git checkout
1165          * @return bool|string Sha1 of commit HEAD points to
1166          */
1167         public static function getGitHeadSha1( $dir ) {
1168                 $repo = new GitInfo( $dir );
1169
1170                 return $repo->getHeadSHA1();
1171         }
1172
1173         /**
1174          * @param string $dir Directory of the git checkout
1175          * @return bool|string Branch currently checked out
1176          */
1177         public static function getGitCurrentBranch( $dir ) {
1178                 $repo = new GitInfo( $dir );
1179                 return $repo->getCurrentBranch();
1180         }
1181
1182         /**
1183          * Get the list of entry points and their URLs
1184          * @return string Wikitext
1185          */
1186         public function getEntryPointInfo() {
1187                 global $wgArticlePath, $wgScriptPath;
1188                 $scriptPath = $wgScriptPath ? $wgScriptPath : "/";
1189                 $entryPoints = array(
1190                         'version-entrypoints-articlepath' => $wgArticlePath,
1191                         'version-entrypoints-scriptpath' => $scriptPath,
1192                         'version-entrypoints-index-php' => wfScript( 'index' ),
1193                         'version-entrypoints-api-php' => wfScript( 'api' ),
1194                         'version-entrypoints-load-php' => wfScript( 'load' ),
1195                 );
1196
1197                 $language = $this->getLanguage();
1198                 $thAttribures = array(
1199                         'dir' => $language->getDir(),
1200                         'lang' => $language->getCode()
1201                 );
1202                 $out = Html::element(
1203                                 'h2',
1204                                 array( 'id' => 'mw-version-entrypoints' ),
1205                                 $this->msg( 'version-entrypoints' )->text()
1206                         ) .
1207                         Html::openElement( 'table',
1208                                 array(
1209                                         'class' => 'wikitable plainlinks',
1210                                         'id' => 'mw-version-entrypoints-table',
1211                                         'dir' => 'ltr',
1212                                         'lang' => 'en'
1213                                 )
1214                         ) .
1215                         Html::openElement( 'tr' ) .
1216                         Html::element(
1217                                 'th',
1218                                 $thAttribures,
1219                                 $this->msg( 'version-entrypoints-header-entrypoint' )->text()
1220                         ) .
1221                         Html::element(
1222                                 'th',
1223                                 $thAttribures,
1224                                 $this->msg( 'version-entrypoints-header-url' )->text()
1225                         ) .
1226                         Html::closeElement( 'tr' );
1227
1228                 foreach ( $entryPoints as $message => $value ) {
1229                         $url = wfExpandUrl( $value, PROTO_RELATIVE );
1230                         $out .= Html::openElement( 'tr' ) .
1231                                 // ->text() looks like it should be ->parse(), but this function
1232                                 // returns wikitext, not HTML, boo
1233                                 Html::rawElement( 'td', array(), $this->msg( $message )->text() ) .
1234                                 Html::rawElement( 'td', array(), Html::rawElement( 'code', array(), "[$url $value]" ) ) .
1235                                 Html::closeElement( 'tr' );
1236                 }
1237
1238                 $out .= Html::closeElement( 'table' );
1239
1240                 return $out;
1241         }
1242
1243         protected function getGroupName() {
1244                 return 'wiki';
1245         }
1246 }