Merge "Fix positioning of jQuery.tipsy tooltip arrows"
[mediawiki.git] / includes / installer / WebInstallerPage.php
blob0fcda7d087e6cc09109a7507263ab5abe06cef58
1 <?php
2 /**
3 * Base code for web installer pages.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
20 * @file
21 * @ingroup Deployment
24 /**
25 * Abstract class to define pages for the web installer.
27 * @ingroup Deployment
28 * @since 1.17
30 abstract class WebInstallerPage {
32 /**
33 * The WebInstaller object this WebInstallerPage belongs to.
35 * @var WebInstaller
37 public $parent;
39 /**
40 * @return string
42 abstract public function execute();
44 /**
45 * @param WebInstaller $parent
47 public function __construct( WebInstaller $parent ) {
48 $this->parent = $parent;
51 /**
52 * Is this a slow-running page in the installer? If so, WebInstaller will
53 * set_time_limit(0) before calling execute(). Right now this only applies
54 * to Install and Upgrade pages
56 * @return bool Always false in this default implementation.
58 public function isSlow() {
59 return false;
62 /**
63 * @param string $html
65 public function addHTML( $html ) {
66 $this->parent->output->addHTML( $html );
69 public function startForm() {
70 $this->addHTML(
71 "<div class=\"config-section\">\n" .
72 Html::openElement(
73 'form',
74 array(
75 'method' => 'post',
76 'action' => $this->parent->getUrl( array( 'page' => $this->getName() ) )
78 ) . "\n"
82 /**
83 * @param string|bool $continue
84 * @param string|bool $back
86 public function endForm( $continue = 'continue', $back = 'back' ) {
87 $s = "<div class=\"config-submit\">\n";
88 $id = $this->getId();
90 if ( $id === false ) {
91 $s .= Html::hidden( 'lastPage', $this->parent->request->getVal( 'lastPage' ) );
94 if ( $continue ) {
95 // Fake submit button for enter keypress (bug 26267)
96 // Messages: config-continue, config-restart, config-regenerate
97 $s .= Xml::submitButton(
98 wfMessage( "config-$continue" )->text(),
99 array(
100 'name' => "enter-$continue",
101 'style' => 'visibility:hidden;overflow:hidden;width:1px;margin:0'
103 ) . "\n";
106 if ( $back ) {
107 // Message: config-back
108 $s .= Xml::submitButton(
109 wfMessage( "config-$back" )->text(),
110 array(
111 'name' => "submit-$back",
112 'tabindex' => $this->parent->nextTabIndex()
114 ) . "\n";
117 if ( $continue ) {
118 // Messages: config-continue, config-restart, config-regenerate
119 $s .= Xml::submitButton(
120 wfMessage( "config-$continue" )->text(),
121 array(
122 'name' => "submit-$continue",
123 'tabindex' => $this->parent->nextTabIndex(),
125 ) . "\n";
128 $s .= "</div></form></div>\n";
129 $this->addHTML( $s );
133 * @return string
135 public function getName() {
136 return str_replace( 'WebInstaller', '', get_class( $this ) );
140 * @return string
142 protected function getId() {
143 return array_search( $this->getName(), $this->parent->pageSequence );
147 * @param string $var
148 * @param mixed $default
150 * @return mixed
152 public function getVar( $var, $default = null ) {
153 return $this->parent->getVar( $var, $default );
157 * @param string $name
158 * @param mixed $value
160 public function setVar( $name, $value ) {
161 $this->parent->setVar( $name, $value );
165 * Get the starting tags of a fieldset.
167 * @param string $legend Message name
169 * @return string
171 protected function getFieldsetStart( $legend ) {
172 return "\n<fieldset><legend>" . wfMessage( $legend )->escaped() . "</legend>\n";
176 * Get the end tag of a fieldset.
178 * @return string
180 protected function getFieldsetEnd() {
181 return "</fieldset>\n";
185 * Opens a textarea used to display the progress of a long operation
187 protected function startLiveBox() {
188 $this->addHTML(
189 '<div id="config-spinner" style="display:none;">' .
190 '<img src="images/ajax-loader.gif" /></div>' .
191 '<script>jQuery( "#config-spinner" ).show();</script>' .
192 '<div id="config-live-log">' .
193 '<textarea name="LiveLog" rows="10" cols="30" readonly="readonly">'
195 $this->parent->output->flush();
199 * Opposite to WebInstallerPage::startLiveBox
201 protected function endLiveBox() {
202 $this->addHTML( '</textarea></div>
203 <script>jQuery( "#config-spinner" ).hide()</script>' );
204 $this->parent->output->flush();
209 class WebInstallerLanguage extends WebInstallerPage {
212 * @return string|null
214 public function execute() {
215 global $wgLang;
216 $r = $this->parent->request;
217 $userLang = $r->getVal( 'uselang' );
218 $contLang = $r->getVal( 'ContLang' );
220 $languages = Language::fetchLanguageNames();
221 $lifetime = intval( ini_get( 'session.gc_maxlifetime' ) );
222 if ( !$lifetime ) {
223 $lifetime = 1440; // PHP default
226 if ( $r->wasPosted() ) {
227 # Do session test
228 if ( $this->parent->getSession( 'test' ) === null ) {
229 $requestTime = $r->getVal( 'LanguageRequestTime' );
230 if ( !$requestTime ) {
231 // The most likely explanation is that the user was knocked back
232 // from another page on POST due to session expiry
233 $msg = 'config-session-expired';
234 } elseif ( time() - $requestTime > $lifetime ) {
235 $msg = 'config-session-expired';
236 } else {
237 $msg = 'config-no-session';
239 $this->parent->showError( $msg, $wgLang->formatTimePeriod( $lifetime ) );
240 } else {
241 if ( isset( $languages[$userLang] ) ) {
242 $this->setVar( '_UserLang', $userLang );
244 if ( isset( $languages[$contLang] ) ) {
245 $this->setVar( 'wgLanguageCode', $contLang );
248 return 'continue';
250 } elseif ( $this->parent->showSessionWarning ) {
251 # The user was knocked back from another page to the start
252 # This probably indicates a session expiry
253 $this->parent->showError( 'config-session-expired',
254 $wgLang->formatTimePeriod( $lifetime ) );
257 $this->parent->setSession( 'test', true );
259 if ( !isset( $languages[$userLang] ) ) {
260 $userLang = $this->getVar( '_UserLang', 'en' );
262 if ( !isset( $languages[$contLang] ) ) {
263 $contLang = $this->getVar( 'wgLanguageCode', 'en' );
265 $this->startForm();
266 $s = Html::hidden( 'LanguageRequestTime', time() ) .
267 $this->getLanguageSelector( 'uselang', 'config-your-language', $userLang,
268 $this->parent->getHelpBox( 'config-your-language-help' ) ) .
269 $this->getLanguageSelector( 'ContLang', 'config-wiki-language', $contLang,
270 $this->parent->getHelpBox( 'config-wiki-language-help' ) );
271 $this->addHTML( $s );
272 $this->endForm( 'continue', false );
274 return null;
278 * Get a "<select>" for selecting languages.
280 * @param string $name
281 * @param string $label
282 * @param string $selectedCode
283 * @param string $helpHtml
285 * @return string
287 public function getLanguageSelector( $name, $label, $selectedCode, $helpHtml = '' ) {
288 global $wgDummyLanguageCodes;
290 $output = $helpHtml;
292 $select = new XmlSelect( $name, $name, $selectedCode );
293 $select->setAttribute( 'tabindex', $this->parent->nextTabIndex() );
295 $languages = Language::fetchLanguageNames();
296 ksort( $languages );
297 foreach ( $languages as $code => $lang ) {
298 if ( isset( $wgDummyLanguageCodes[$code] ) ) {
299 continue;
301 $select->addOption( "$code - $lang", $code );
304 $output .= $select->getHTML();
305 return $this->parent->label( $label, $name, $output );
310 class WebInstallerExistingWiki extends WebInstallerPage {
313 * @return string
315 public function execute() {
316 // If there is no LocalSettings.php, continue to the installer welcome page
317 $vars = Installer::getExistingLocalSettings();
318 if ( !$vars ) {
319 return 'skip';
322 // Check if the upgrade key supplied to the user has appeared in LocalSettings.php
323 if ( $vars['wgUpgradeKey'] !== false
324 && $this->getVar( '_UpgradeKeySupplied' )
325 && $this->getVar( 'wgUpgradeKey' ) === $vars['wgUpgradeKey']
327 // It's there, so the user is authorized
328 $status = $this->handleExistingUpgrade( $vars );
329 if ( $status->isOK() ) {
330 return 'skip';
331 } else {
332 $this->startForm();
333 $this->parent->showStatusBox( $status );
334 $this->endForm( 'continue' );
336 return 'output';
340 // If there is no $wgUpgradeKey, tell the user to add one to LocalSettings.php
341 if ( $vars['wgUpgradeKey'] === false ) {
342 if ( $this->getVar( 'wgUpgradeKey', false ) === false ) {
343 $secretKey = $this->getVar( 'wgSecretKey' ); // preserve $wgSecretKey
344 $this->parent->generateKeys();
345 $this->setVar( 'wgSecretKey', $secretKey );
346 $this->setVar( '_UpgradeKeySupplied', true );
348 $this->startForm();
349 $this->addHTML( $this->parent->getInfoBox(
350 wfMessage( 'config-upgrade-key-missing', "<pre dir=\"ltr\">\$wgUpgradeKey = '" .
351 $this->getVar( 'wgUpgradeKey' ) . "';</pre>" )->plain()
352 ) );
353 $this->endForm( 'continue' );
355 return 'output';
358 // If there is an upgrade key, but it wasn't supplied, prompt the user to enter it
360 $r = $this->parent->request;
361 if ( $r->wasPosted() ) {
362 $key = $r->getText( 'config_wgUpgradeKey' );
363 if ( !$key || $key !== $vars['wgUpgradeKey'] ) {
364 $this->parent->showError( 'config-localsettings-badkey' );
365 $this->showKeyForm();
367 return 'output';
369 // Key was OK
370 $status = $this->handleExistingUpgrade( $vars );
371 if ( $status->isOK() ) {
372 return 'continue';
373 } else {
374 $this->parent->showStatusBox( $status );
375 $this->showKeyForm();
377 return 'output';
379 } else {
380 $this->showKeyForm();
382 return 'output';
387 * Show the "enter key" form
389 protected function showKeyForm() {
390 $this->startForm();
391 $this->addHTML(
392 $this->parent->getInfoBox( wfMessage( 'config-localsettings-upgrade' )->plain() ) .
393 '<br />' .
394 $this->parent->getTextBox( array(
395 'var' => 'wgUpgradeKey',
396 'label' => 'config-localsettings-key',
397 'attribs' => array( 'autocomplete' => 'off' ),
400 $this->endForm( 'continue' );
404 * @param string[] $names
405 * @param mixed[] $vars
407 * @return Status
409 protected function importVariables( $names, $vars ) {
410 $status = Status::newGood();
411 foreach ( $names as $name ) {
412 if ( !isset( $vars[$name] ) ) {
413 $status->fatal( 'config-localsettings-incomplete', $name );
415 $this->setVar( $name, $vars[$name] );
418 return $status;
422 * Initiate an upgrade of the existing database
424 * @param mixed[] $vars Variables from LocalSettings.php
426 * @return Status
428 protected function handleExistingUpgrade( $vars ) {
429 // Check $wgDBtype
430 if ( !isset( $vars['wgDBtype'] ) ||
431 !in_array( $vars['wgDBtype'], Installer::getDBTypes() )
433 return Status::newFatal( 'config-localsettings-connection-error', '' );
436 // Set the relevant variables from LocalSettings.php
437 $requiredVars = array( 'wgDBtype' );
438 $status = $this->importVariables( $requiredVars, $vars );
439 $installer = $this->parent->getDBInstaller();
440 $status->merge( $this->importVariables( $installer->getGlobalNames(), $vars ) );
441 if ( !$status->isOK() ) {
442 return $status;
445 if ( isset( $vars['wgDBadminuser'] ) ) {
446 $this->setVar( '_InstallUser', $vars['wgDBadminuser'] );
447 } else {
448 $this->setVar( '_InstallUser', $vars['wgDBuser'] );
450 if ( isset( $vars['wgDBadminpassword'] ) ) {
451 $this->setVar( '_InstallPassword', $vars['wgDBadminpassword'] );
452 } else {
453 $this->setVar( '_InstallPassword', $vars['wgDBpassword'] );
456 // Test the database connection
457 $status = $installer->getConnection();
458 if ( !$status->isOK() ) {
459 // Adjust the error message to explain things correctly
460 $status->replaceMessage( 'config-connection-error',
461 'config-localsettings-connection-error' );
463 return $status;
466 // All good
467 $this->setVar( '_ExistingDBSettings', true );
469 return $status;
474 class WebInstallerWelcome extends WebInstallerPage {
477 * @return string
479 public function execute() {
480 if ( $this->parent->request->wasPosted() ) {
481 if ( $this->getVar( '_Environment' ) ) {
482 return 'continue';
485 $this->parent->output->addWikiText( wfMessage( 'config-welcome' )->plain() );
486 $status = $this->parent->doEnvironmentChecks();
487 if ( $status->isGood() ) {
488 $this->parent->output->addHTML( '<span class="success-message">' .
489 wfMessage( 'config-env-good' )->escaped() . '</span>' );
490 $this->parent->output->addWikiText( wfMessage( 'config-copyright',
491 SpecialVersion::getCopyrightAndAuthorList() )->plain() );
492 $this->startForm();
493 $this->endForm();
494 } else {
495 $this->parent->showStatusMessage( $status );
498 return '';
503 class WebInstallerDBConnect extends WebInstallerPage {
506 * @return string|null When string, "skip" or "continue"
508 public function execute() {
509 if ( $this->getVar( '_ExistingDBSettings' ) ) {
510 return 'skip';
513 $r = $this->parent->request;
514 if ( $r->wasPosted() ) {
515 $status = $this->submit();
517 if ( $status->isGood() ) {
518 $this->setVar( '_UpgradeDone', false );
520 return 'continue';
521 } else {
522 $this->parent->showStatusBox( $status );
526 $this->startForm();
528 $types = "<ul class=\"config-settings-block\">\n";
529 $settings = '';
530 $defaultType = $this->getVar( 'wgDBtype' );
532 // Messages: config-dbsupport-mysql, config-dbsupport-postgres, config-dbsupport-oracle,
533 // config-dbsupport-sqlite, config-dbsupport-mssql
534 $dbSupport = '';
535 foreach ( Installer::getDBTypes() as $type ) {
536 $dbSupport .= wfMessage( "config-dbsupport-$type" )->plain() . "\n";
538 $this->addHTML( $this->parent->getInfoBox(
539 wfMessage( 'config-support-info', trim( $dbSupport ) )->text() ) );
541 // It's possible that the library for the default DB type is not compiled in.
542 // In that case, instead select the first supported DB type in the list.
543 $compiledDBs = $this->parent->getCompiledDBs();
544 if ( !in_array( $defaultType, $compiledDBs ) ) {
545 $defaultType = $compiledDBs[0];
548 foreach ( $compiledDBs as $type ) {
549 $installer = $this->parent->getDBInstaller( $type );
550 $types .=
551 '<li>' .
552 Xml::radioLabel(
553 $installer->getReadableName(),
554 'DBType',
555 $type,
556 "DBType_$type",
557 $type == $defaultType,
558 array( 'class' => 'dbRadio', 'rel' => "DB_wrapper_$type" )
560 "</li>\n";
562 // Messages: config-header-mysql, config-header-postgres, config-header-oracle,
563 // config-header-sqlite
564 $settings .= Html::openElement(
565 'div',
566 array(
567 'id' => 'DB_wrapper_' . $type,
568 'class' => 'dbWrapper'
571 Html::element( 'h3', array(), wfMessage( 'config-header-' . $type )->text() ) .
572 $installer->getConnectForm() .
573 "</div>\n";
576 $types .= "</ul><br style=\"clear: left\"/>\n";
578 $this->addHTML( $this->parent->label( 'config-db-type', false, $types ) . $settings );
579 $this->endForm();
581 return null;
585 * @return Status
587 public function submit() {
588 $r = $this->parent->request;
589 $type = $r->getVal( 'DBType' );
590 if ( !$type ) {
591 return Status::newFatal( 'config-invalid-db-type' );
593 $this->setVar( 'wgDBtype', $type );
594 $installer = $this->parent->getDBInstaller( $type );
595 if ( !$installer ) {
596 return Status::newFatal( 'config-invalid-db-type' );
599 return $installer->submitConnectForm();
604 class WebInstallerUpgrade extends WebInstallerPage {
607 * @return bool Always true.
609 public function isSlow() {
610 return true;
614 * @return string|null
616 public function execute() {
617 if ( $this->getVar( '_UpgradeDone' ) ) {
618 // Allow regeneration of LocalSettings.php, unless we are working
619 // from a pre-existing LocalSettings.php file and we want to avoid
620 // leaking its contents
621 if ( $this->parent->request->wasPosted() && !$this->getVar( '_ExistingDBSettings' ) ) {
622 // Done message acknowledged
623 return 'continue';
624 } else {
625 // Back button click
626 // Show the done message again
627 // Make them click back again if they want to do the upgrade again
628 $this->showDoneMessage();
630 return 'output';
634 // wgDBtype is generally valid here because otherwise the previous page
635 // (connect) wouldn't have declared its happiness
636 $type = $this->getVar( 'wgDBtype' );
637 $installer = $this->parent->getDBInstaller( $type );
639 if ( !$installer->needsUpgrade() ) {
640 return 'skip';
643 if ( $this->parent->request->wasPosted() ) {
644 $installer->preUpgrade();
646 $this->startLiveBox();
647 $result = $installer->doUpgrade();
648 $this->endLiveBox();
650 if ( $result ) {
651 // If they're going to possibly regenerate LocalSettings, we
652 // need to create the upgrade/secret keys. Bug 26481
653 if ( !$this->getVar( '_ExistingDBSettings' ) ) {
654 $this->parent->generateKeys();
656 $this->setVar( '_UpgradeDone', true );
657 $this->showDoneMessage();
659 return 'output';
663 $this->startForm();
664 $this->addHTML( $this->parent->getInfoBox(
665 wfMessage( 'config-can-upgrade', $GLOBALS['wgVersion'] )->plain() ) );
666 $this->endForm();
668 return null;
671 public function showDoneMessage() {
672 $this->startForm();
673 $regenerate = !$this->getVar( '_ExistingDBSettings' );
674 if ( $regenerate ) {
675 $msg = 'config-upgrade-done';
676 } else {
677 $msg = 'config-upgrade-done-no-regenerate';
679 $this->parent->disableLinkPopups();
680 $this->addHTML(
681 $this->parent->getInfoBox(
682 wfMessage( $msg,
683 $this->getVar( 'wgServer' ) .
684 $this->getVar( 'wgScriptPath' ) . '/index.php'
685 )->plain(), 'tick-32.png'
688 $this->parent->restoreLinkPopups();
689 $this->endForm( $regenerate ? 'regenerate' : false, false );
694 class WebInstallerDBSettings extends WebInstallerPage {
697 * @return string|null
699 public function execute() {
700 $installer = $this->parent->getDBInstaller( $this->getVar( 'wgDBtype' ) );
702 $r = $this->parent->request;
703 if ( $r->wasPosted() ) {
704 $status = $installer->submitSettingsForm();
705 if ( $status === false ) {
706 return 'skip';
707 } elseif ( $status->isGood() ) {
708 return 'continue';
709 } else {
710 $this->parent->showStatusBox( $status );
714 $form = $installer->getSettingsForm();
715 if ( $form === false ) {
716 return 'skip';
719 $this->startForm();
720 $this->addHTML( $form );
721 $this->endForm();
723 return null;
728 class WebInstallerName extends WebInstallerPage {
731 * @return string
733 public function execute() {
734 $r = $this->parent->request;
735 if ( $r->wasPosted() ) {
736 if ( $this->submit() ) {
737 return 'continue';
741 $this->startForm();
743 // Encourage people to not name their site 'MediaWiki' by blanking the
744 // field. I think that was the intent with the original $GLOBALS['wgSitename']
745 // but these two always were the same so had the effect of making the
746 // installer forget $wgSitename when navigating back to this page.
747 if ( $this->getVar( 'wgSitename' ) == 'MediaWiki' ) {
748 $this->setVar( 'wgSitename', '' );
751 // Set wgMetaNamespace to something valid before we show the form.
752 // $wgMetaNamespace defaults to $wgSiteName which is 'MediaWiki'
753 $metaNS = $this->getVar( 'wgMetaNamespace' );
754 $this->setVar(
755 'wgMetaNamespace',
756 wfMessage( 'config-ns-other-default' )->inContentLanguage()->text()
759 $this->addHTML(
760 $this->parent->getTextBox( array(
761 'var' => 'wgSitename',
762 'label' => 'config-site-name',
763 'help' => $this->parent->getHelpBox( 'config-site-name-help' )
764 ) ) .
765 // getRadioSet() builds a set of labeled radio buttons.
766 // For grep: The following messages are used as the item labels:
767 // config-ns-site-name, config-ns-generic, config-ns-other
768 $this->parent->getRadioSet( array(
769 'var' => '_NamespaceType',
770 'label' => 'config-project-namespace',
771 'itemLabelPrefix' => 'config-ns-',
772 'values' => array( 'site-name', 'generic', 'other' ),
773 'commonAttribs' => array( 'class' => 'enableForOther',
774 'rel' => 'config_wgMetaNamespace' ),
775 'help' => $this->parent->getHelpBox( 'config-project-namespace-help' )
776 ) ) .
777 $this->parent->getTextBox( array(
778 'var' => 'wgMetaNamespace',
779 'label' => '', // @todo Needs a label?
780 'attribs' => array( 'readonly' => 'readonly', 'class' => 'enabledByOther' )
781 ) ) .
782 $this->getFieldSetStart( 'config-admin-box' ) .
783 $this->parent->getTextBox( array(
784 'var' => '_AdminName',
785 'label' => 'config-admin-name',
786 'help' => $this->parent->getHelpBox( 'config-admin-help' )
787 ) ) .
788 $this->parent->getPasswordBox( array(
789 'var' => '_AdminPassword',
790 'label' => 'config-admin-password',
791 ) ) .
792 $this->parent->getPasswordBox( array(
793 'var' => '_AdminPasswordConfirm',
794 'label' => 'config-admin-password-confirm'
795 ) ) .
796 $this->parent->getTextBox( array(
797 'var' => '_AdminEmail',
798 'attribs' => array(
799 'dir' => 'ltr',
801 'label' => 'config-admin-email',
802 'help' => $this->parent->getHelpBox( 'config-admin-email-help' )
803 ) ) .
804 $this->parent->getCheckBox( array(
805 'var' => '_Subscribe',
806 'label' => 'config-subscribe',
807 'help' => $this->parent->getHelpBox( 'config-subscribe-help' )
808 ) ) .
809 $this->getFieldSetEnd() .
810 $this->parent->getInfoBox( wfMessage( 'config-almost-done' )->text() ) .
811 // getRadioSet() builds a set of labeled radio buttons.
812 // For grep: The following messages are used as the item labels:
813 // config-optional-continue, config-optional-skip
814 $this->parent->getRadioSet( array(
815 'var' => '_SkipOptional',
816 'itemLabelPrefix' => 'config-optional-',
817 'values' => array( 'continue', 'skip' )
821 // Restore the default value
822 $this->setVar( 'wgMetaNamespace', $metaNS );
824 $this->endForm();
826 return 'output';
830 * @return bool
832 public function submit() {
833 global $wgPasswordPolicy;
835 $retVal = true;
836 $this->parent->setVarsFromRequest( array( 'wgSitename', '_NamespaceType',
837 '_AdminName', '_AdminPassword', '_AdminPasswordConfirm', '_AdminEmail',
838 '_Subscribe', '_SkipOptional', 'wgMetaNamespace' ) );
840 // Validate site name
841 if ( strval( $this->getVar( 'wgSitename' ) ) === '' ) {
842 $this->parent->showError( 'config-site-name-blank' );
843 $retVal = false;
846 // Fetch namespace
847 $nsType = $this->getVar( '_NamespaceType' );
848 if ( $nsType == 'site-name' ) {
849 $name = $this->getVar( 'wgSitename' );
850 // Sanitize for namespace
851 // This algorithm should match the JS one in WebInstallerOutput.php
852 $name = preg_replace( '/[\[\]\{\}|#<>%+? ]/', '_', $name );
853 $name = str_replace( '&', '&amp;', $name );
854 $name = preg_replace( '/__+/', '_', $name );
855 $name = ucfirst( trim( $name, '_' ) );
856 } elseif ( $nsType == 'generic' ) {
857 $name = wfMessage( 'config-ns-generic' )->text();
858 } else { // other
859 $name = $this->getVar( 'wgMetaNamespace' );
862 // Validate namespace
863 if ( strpos( $name, ':' ) !== false ) {
864 $good = false;
865 } else {
866 // Title-style validation
867 $title = Title::newFromText( $name );
868 if ( !$title ) {
869 $good = $nsType == 'site-name';
870 } else {
871 $name = $title->getDBkey();
872 $good = true;
875 if ( !$good ) {
876 $this->parent->showError( 'config-ns-invalid', $name );
877 $retVal = false;
880 // Make sure it won't conflict with any existing namespaces
881 global $wgContLang;
882 $nsIndex = $wgContLang->getNsIndex( $name );
883 if ( $nsIndex !== false && $nsIndex !== NS_PROJECT ) {
884 $this->parent->showError( 'config-ns-conflict', $name );
885 $retVal = false;
888 $this->setVar( 'wgMetaNamespace', $name );
890 // Validate username for creation
891 $name = $this->getVar( '_AdminName' );
892 if ( strval( $name ) === '' ) {
893 $this->parent->showError( 'config-admin-name-blank' );
894 $cname = $name;
895 $retVal = false;
896 } else {
897 $cname = User::getCanonicalName( $name, 'creatable' );
898 if ( $cname === false ) {
899 $this->parent->showError( 'config-admin-name-invalid', $name );
900 $retVal = false;
901 } else {
902 $this->setVar( '_AdminName', $cname );
906 // Validate password
907 $msg = false;
908 $pwd = $this->getVar( '_AdminPassword' );
909 $user = User::newFromName( $cname );
910 if ( $user ) {
911 $upp = new UserPasswordPolicy(
912 $wgPasswordPolicy['policies'],
913 $wgPasswordPolicy['checks']
915 $status = $upp->checkUserPasswordForGroups(
916 $user,
917 $pwd,
918 array( 'bureaucrat', 'sysop' ) // per Installer::createSysop()
920 $valid = $status->isGood() ? true : $status->getMessage();
921 } else {
922 $valid = 'config-admin-name-invalid';
924 if ( strval( $pwd ) === '' ) {
925 // Provide a more specific and helpful message if password field is left blank
926 $msg = 'config-admin-password-blank';
927 } elseif ( $pwd !== $this->getVar( '_AdminPasswordConfirm' ) ) {
928 $msg = 'config-admin-password-mismatch';
929 } elseif ( $valid !== true ) {
930 $msg = $valid;
932 if ( $msg !== false ) {
933 call_user_func( array( $this->parent, 'showError' ), $msg );
934 $this->setVar( '_AdminPassword', '' );
935 $this->setVar( '_AdminPasswordConfirm', '' );
936 $retVal = false;
939 // Validate e-mail if provided
940 $email = $this->getVar( '_AdminEmail' );
941 if ( $email && !Sanitizer::validateEmail( $email ) ) {
942 $this->parent->showError( 'config-admin-error-bademail' );
943 $retVal = false;
945 // If they asked to subscribe to mediawiki-announce but didn't give
946 // an e-mail, show an error. Bug 29332
947 if ( !$email && $this->getVar( '_Subscribe' ) ) {
948 $this->parent->showError( 'config-subscribe-noemail' );
949 $retVal = false;
952 return $retVal;
957 class WebInstallerOptions extends WebInstallerPage {
960 * @return string|null
962 public function execute() {
963 if ( $this->getVar( '_SkipOptional' ) == 'skip' ) {
964 $this->submitSkins();
965 return 'skip';
967 if ( $this->parent->request->wasPosted() ) {
968 if ( $this->submit() ) {
969 return 'continue';
973 $emailwrapperStyle = $this->getVar( 'wgEnableEmail' ) ? '' : 'display: none';
974 $this->startForm();
975 $this->addHTML(
976 # User Rights
977 // getRadioSet() builds a set of labeled radio buttons.
978 // For grep: The following messages are used as the item labels:
979 // config-profile-wiki, config-profile-no-anon, config-profile-fishbowl, config-profile-private
980 $this->parent->getRadioSet( array(
981 'var' => '_RightsProfile',
982 'label' => 'config-profile',
983 'itemLabelPrefix' => 'config-profile-',
984 'values' => array_keys( $this->parent->rightsProfiles ),
985 ) ) .
986 $this->parent->getInfoBox( wfMessage( 'config-profile-help' )->plain() ) .
988 # Licensing
989 // getRadioSet() builds a set of labeled radio buttons.
990 // For grep: The following messages are used as the item labels:
991 // config-license-cc-by, config-license-cc-by-sa, config-license-cc-by-nc-sa,
992 // config-license-cc-0, config-license-pd, config-license-gfdl,
993 // config-license-none, config-license-cc-choose
994 $this->parent->getRadioSet( array(
995 'var' => '_LicenseCode',
996 'label' => 'config-license',
997 'itemLabelPrefix' => 'config-license-',
998 'values' => array_keys( $this->parent->licenses ),
999 'commonAttribs' => array( 'class' => 'licenseRadio' ),
1000 ) ) .
1001 $this->getCCChooser() .
1002 $this->parent->getHelpBox( 'config-license-help' ) .
1004 # E-mail
1005 $this->getFieldSetStart( 'config-email-settings' ) .
1006 $this->parent->getCheckBox( array(
1007 'var' => 'wgEnableEmail',
1008 'label' => 'config-enable-email',
1009 'attribs' => array( 'class' => 'showHideRadio', 'rel' => 'emailwrapper' ),
1010 ) ) .
1011 $this->parent->getHelpBox( 'config-enable-email-help' ) .
1012 "<div id=\"emailwrapper\" style=\"$emailwrapperStyle\">" .
1013 $this->parent->getTextBox( array(
1014 'var' => 'wgPasswordSender',
1015 'label' => 'config-email-sender'
1016 ) ) .
1017 $this->parent->getHelpBox( 'config-email-sender-help' ) .
1018 $this->parent->getCheckBox( array(
1019 'var' => 'wgEnableUserEmail',
1020 'label' => 'config-email-user',
1021 ) ) .
1022 $this->parent->getHelpBox( 'config-email-user-help' ) .
1023 $this->parent->getCheckBox( array(
1024 'var' => 'wgEnotifUserTalk',
1025 'label' => 'config-email-usertalk',
1026 ) ) .
1027 $this->parent->getHelpBox( 'config-email-usertalk-help' ) .
1028 $this->parent->getCheckBox( array(
1029 'var' => 'wgEnotifWatchlist',
1030 'label' => 'config-email-watchlist',
1031 ) ) .
1032 $this->parent->getHelpBox( 'config-email-watchlist-help' ) .
1033 $this->parent->getCheckBox( array(
1034 'var' => 'wgEmailAuthentication',
1035 'label' => 'config-email-auth',
1036 ) ) .
1037 $this->parent->getHelpBox( 'config-email-auth-help' ) .
1038 "</div>" .
1039 $this->getFieldSetEnd()
1042 $skins = $this->parent->findExtensions( 'skins' );
1043 $skinHtml = $this->getFieldSetStart( 'config-skins' );
1045 $skinNames = array_map( 'strtolower', $skins );
1046 $chosenSkinName = $this->getVar( 'wgDefaultSkin', $this->parent->getDefaultSkin( $skinNames ) );
1048 if ( $skins ) {
1049 $radioButtons = $this->parent->getRadioElements( array(
1050 'var' => 'wgDefaultSkin',
1051 'itemLabels' => array_fill_keys( $skinNames, 'config-skins-use-as-default' ),
1052 'values' => $skinNames,
1053 'value' => $chosenSkinName,
1054 ) );
1056 foreach ( $skins as $skin ) {
1057 $skinHtml .=
1058 '<div class="config-skins-item">' .
1059 $this->parent->getCheckBox( array(
1060 'var' => "skin-$skin",
1061 'rawtext' => $skin,
1062 'value' => $this->getVar( "skin-$skin", true ), // all found skins enabled by default
1063 ) ) .
1064 '<div class="config-skins-use-as-default">' . $radioButtons[strtolower( $skin )] . '</div>' .
1065 '</div>';
1067 } else {
1068 $skinHtml .=
1069 $this->parent->getWarningBox( wfMessage( 'config-skins-missing' )->plain() ) .
1070 Html::hidden( 'config_wgDefaultSkin', $chosenSkinName );
1073 $skinHtml .= $this->parent->getHelpBox( 'config-skins-help' ) .
1074 $this->getFieldSetEnd();
1075 $this->addHTML( $skinHtml );
1077 $extensions = $this->parent->findExtensions();
1079 if ( $extensions ) {
1080 $extHtml = $this->getFieldSetStart( 'config-extensions' );
1082 foreach ( $extensions as $ext ) {
1083 $extHtml .= $this->parent->getCheckBox( array(
1084 'var' => "ext-$ext",
1085 'rawtext' => $ext,
1086 ) );
1089 $extHtml .= $this->parent->getHelpBox( 'config-extensions-help' ) .
1090 $this->getFieldSetEnd();
1091 $this->addHTML( $extHtml );
1094 // Having / in paths in Windows looks funny :)
1095 $this->setVar( 'wgDeletedDirectory',
1096 str_replace(
1097 '/', DIRECTORY_SEPARATOR,
1098 $this->getVar( 'wgDeletedDirectory' )
1102 $uploadwrapperStyle = $this->getVar( 'wgEnableUploads' ) ? '' : 'display: none';
1103 $this->addHTML(
1104 # Uploading
1105 $this->getFieldSetStart( 'config-upload-settings' ) .
1106 $this->parent->getCheckBox( array(
1107 'var' => 'wgEnableUploads',
1108 'label' => 'config-upload-enable',
1109 'attribs' => array( 'class' => 'showHideRadio', 'rel' => 'uploadwrapper' ),
1110 'help' => $this->parent->getHelpBox( 'config-upload-help' )
1111 ) ) .
1112 '<div id="uploadwrapper" style="' . $uploadwrapperStyle . '">' .
1113 $this->parent->getTextBox( array(
1114 'var' => 'wgDeletedDirectory',
1115 'label' => 'config-upload-deleted',
1116 'attribs' => array( 'dir' => 'ltr' ),
1117 'help' => $this->parent->getHelpBox( 'config-upload-deleted-help' )
1118 ) ) .
1119 '</div>' .
1120 $this->parent->getTextBox( array(
1121 'var' => 'wgLogo',
1122 'label' => 'config-logo',
1123 'attribs' => array( 'dir' => 'ltr' ),
1124 'help' => $this->parent->getHelpBox( 'config-logo-help' )
1127 $this->addHTML(
1128 $this->parent->getCheckBox( array(
1129 'var' => 'wgUseInstantCommons',
1130 'label' => 'config-instantcommons',
1131 'help' => $this->parent->getHelpBox( 'config-instantcommons-help' )
1132 ) ) .
1133 $this->getFieldSetEnd()
1136 $caches = array( 'none' );
1137 if ( count( $this->getVar( '_Caches' ) ) ) {
1138 $caches[] = 'accel';
1140 $caches[] = 'memcached';
1142 // We'll hide/show this on demand when the value changes, see config.js.
1143 $cacheval = $this->getVar( '_MainCacheType' );
1144 if ( !$cacheval ) {
1145 // We need to set a default here; but don't hardcode it
1146 // or we lose it every time we reload the page for validation
1147 // or going back!
1148 $cacheval = 'none';
1150 $hidden = ( $cacheval == 'memcached' ) ? '' : 'display: none';
1151 $this->addHTML(
1152 # Advanced settings
1153 $this->getFieldSetStart( 'config-advanced-settings' ) .
1154 # Object cache settings
1155 // getRadioSet() builds a set of labeled radio buttons.
1156 // For grep: The following messages are used as the item labels:
1157 // config-cache-none, config-cache-accel, config-cache-memcached
1158 $this->parent->getRadioSet( array(
1159 'var' => '_MainCacheType',
1160 'label' => 'config-cache-options',
1161 'itemLabelPrefix' => 'config-cache-',
1162 'values' => $caches,
1163 'value' => $cacheval,
1164 ) ) .
1165 $this->parent->getHelpBox( 'config-cache-help' ) .
1166 "<div id=\"config-memcachewrapper\" style=\"$hidden\">" .
1167 $this->parent->getTextArea( array(
1168 'var' => '_MemCachedServers',
1169 'label' => 'config-memcached-servers',
1170 'help' => $this->parent->getHelpBox( 'config-memcached-help' )
1171 ) ) .
1172 '</div>' .
1173 $this->getFieldSetEnd()
1175 $this->endForm();
1177 return null;
1181 * @return string
1183 public function getCCPartnerUrl() {
1184 $server = $this->getVar( 'wgServer' );
1185 $exitUrl = $server . $this->parent->getUrl( array(
1186 'page' => 'Options',
1187 'SubmitCC' => 'indeed',
1188 'config__LicenseCode' => 'cc',
1189 'config_wgRightsUrl' => '[license_url]',
1190 'config_wgRightsText' => '[license_name]',
1191 'config_wgRightsIcon' => '[license_button]',
1192 ) );
1193 $styleUrl = $server . dirname( dirname( $this->parent->getUrl() ) ) .
1194 '/mw-config/config-cc.css';
1195 $iframeUrl = '//creativecommons.org/license/?' .
1196 wfArrayToCgi( array(
1197 'partner' => 'MediaWiki',
1198 'exit_url' => $exitUrl,
1199 'lang' => $this->getVar( '_UserLang' ),
1200 'stylesheet' => $styleUrl,
1201 ) );
1203 return $iframeUrl;
1207 * @return string
1209 public function getCCChooser() {
1210 $iframeAttribs = array(
1211 'class' => 'config-cc-iframe',
1212 'name' => 'config-cc-iframe',
1213 'id' => 'config-cc-iframe',
1214 'frameborder' => 0,
1215 'width' => '100%',
1216 'height' => '100%',
1218 if ( $this->getVar( '_CCDone' ) ) {
1219 $iframeAttribs['src'] = $this->parent->getUrl( array( 'ShowCC' => 'yes' ) );
1220 } else {
1221 $iframeAttribs['src'] = $this->getCCPartnerUrl();
1223 $wrapperStyle = ( $this->getVar( '_LicenseCode' ) == 'cc-choose' ) ? '' : 'display: none';
1225 return "<div class=\"config-cc-wrapper\" id=\"config-cc-wrapper\" style=\"$wrapperStyle\">\n" .
1226 Html::element( 'iframe', $iframeAttribs, '', false /* not short */ ) .
1227 "</div>\n";
1231 * @return string
1233 public function getCCDoneBox() {
1234 $js = "parent.document.getElementById('config-cc-wrapper').style.height = '$1';";
1235 // If you change this height, also change it in config.css
1236 $expandJs = str_replace( '$1', '54em', $js );
1237 $reduceJs = str_replace( '$1', '70px', $js );
1239 return '<p>' .
1240 Html::element( 'img', array( 'src' => $this->getVar( 'wgRightsIcon' ) ) ) .
1241 '&#160;&#160;' .
1242 htmlspecialchars( $this->getVar( 'wgRightsText' ) ) .
1243 "</p>\n" .
1244 "<p style=\"text-align: center;\">" .
1245 Html::element( 'a',
1246 array(
1247 'href' => $this->getCCPartnerUrl(),
1248 'onclick' => $expandJs,
1250 wfMessage( 'config-cc-again' )->text()
1252 "</p>\n" .
1253 "<script>\n" .
1254 # Reduce the wrapper div height
1255 htmlspecialchars( $reduceJs ) .
1256 "\n" .
1257 "</script>\n";
1260 public function submitCC() {
1261 $newValues = $this->parent->setVarsFromRequest(
1262 array( 'wgRightsUrl', 'wgRightsText', 'wgRightsIcon' ) );
1263 if ( count( $newValues ) != 3 ) {
1264 $this->parent->showError( 'config-cc-error' );
1266 return;
1268 $this->setVar( '_CCDone', true );
1269 $this->addHTML( $this->getCCDoneBox() );
1273 * If the user skips this installer page, we still need to set up the default skins, but ignore
1274 * everything else.
1276 * @return bool
1278 public function submitSkins() {
1279 $skins = $this->parent->findExtensions( 'skins' );
1280 $this->parent->setVar( '_Skins', $skins );
1282 if ( $skins ) {
1283 $skinNames = array_map( 'strtolower', $skins );
1284 $this->parent->setVar( 'wgDefaultSkin', $this->parent->getDefaultSkin( $skinNames ) );
1287 return true;
1291 * @return bool
1293 public function submit() {
1294 $this->parent->setVarsFromRequest( array( '_RightsProfile', '_LicenseCode',
1295 'wgEnableEmail', 'wgPasswordSender', 'wgEnableUploads', 'wgLogo',
1296 'wgEnableUserEmail', 'wgEnotifUserTalk', 'wgEnotifWatchlist',
1297 'wgEmailAuthentication', '_MainCacheType', '_MemCachedServers',
1298 'wgUseInstantCommons', 'wgDefaultSkin' ) );
1300 $retVal = true;
1302 if ( !array_key_exists( $this->getVar( '_RightsProfile' ), $this->parent->rightsProfiles ) ) {
1303 reset( $this->parent->rightsProfiles );
1304 $this->setVar( '_RightsProfile', key( $this->parent->rightsProfiles ) );
1307 $code = $this->getVar( '_LicenseCode' );
1308 if ( $code == 'cc-choose' ) {
1309 if ( !$this->getVar( '_CCDone' ) ) {
1310 $this->parent->showError( 'config-cc-not-chosen' );
1311 $retVal = false;
1313 } elseif ( array_key_exists( $code, $this->parent->licenses ) ) {
1314 // Messages:
1315 // config-license-cc-by, config-license-cc-by-sa, config-license-cc-by-nc-sa,
1316 // config-license-cc-0, config-license-pd, config-license-gfdl, config-license-none,
1317 // config-license-cc-choose
1318 $entry = $this->parent->licenses[$code];
1319 if ( isset( $entry['text'] ) ) {
1320 $this->setVar( 'wgRightsText', $entry['text'] );
1321 } else {
1322 $this->setVar( 'wgRightsText', wfMessage( 'config-license-' . $code )->text() );
1324 $this->setVar( 'wgRightsUrl', $entry['url'] );
1325 $this->setVar( 'wgRightsIcon', $entry['icon'] );
1326 } else {
1327 $this->setVar( 'wgRightsText', '' );
1328 $this->setVar( 'wgRightsUrl', '' );
1329 $this->setVar( 'wgRightsIcon', '' );
1332 $skinsAvailable = $this->parent->findExtensions( 'skins' );
1333 $skinsToInstall = array();
1334 foreach ( $skinsAvailable as $skin ) {
1335 $this->parent->setVarsFromRequest( array( "skin-$skin" ) );
1336 if ( $this->getVar( "skin-$skin" ) ) {
1337 $skinsToInstall[] = $skin;
1340 $this->parent->setVar( '_Skins', $skinsToInstall );
1342 if ( !$skinsToInstall && $skinsAvailable ) {
1343 $this->parent->showError( 'config-skins-must-enable-some' );
1344 $retVal = false;
1346 $defaultSkin = $this->getVar( 'wgDefaultSkin' );
1347 $skinsToInstallLowercase = array_map( 'strtolower', $skinsToInstall );
1348 if ( $skinsToInstall && array_search( $defaultSkin, $skinsToInstallLowercase ) === false ) {
1349 $this->parent->showError( 'config-skins-must-enable-default' );
1350 $retVal = false;
1353 $extsAvailable = $this->parent->findExtensions();
1354 $extsToInstall = array();
1355 foreach ( $extsAvailable as $ext ) {
1356 $this->parent->setVarsFromRequest( array( "ext-$ext" ) );
1357 if ( $this->getVar( "ext-$ext" ) ) {
1358 $extsToInstall[] = $ext;
1361 $this->parent->setVar( '_Extensions', $extsToInstall );
1363 if ( $this->getVar( '_MainCacheType' ) == 'memcached' ) {
1364 $memcServers = explode( "\n", $this->getVar( '_MemCachedServers' ) );
1365 if ( !$memcServers ) {
1366 $this->parent->showError( 'config-memcache-needservers' );
1367 $retVal = false;
1370 foreach ( $memcServers as $server ) {
1371 $memcParts = explode( ":", $server, 2 );
1372 if ( !isset( $memcParts[0] )
1373 || ( !IP::isValid( $memcParts[0] )
1374 && ( gethostbyname( $memcParts[0] ) == $memcParts[0] ) )
1376 $this->parent->showError( 'config-memcache-badip', $memcParts[0] );
1377 $retVal = false;
1378 } elseif ( !isset( $memcParts[1] ) ) {
1379 $this->parent->showError( 'config-memcache-noport', $memcParts[0] );
1380 $retVal = false;
1381 } elseif ( $memcParts[1] < 1 || $memcParts[1] > 65535 ) {
1382 $this->parent->showError( 'config-memcache-badport', 1, 65535 );
1383 $retVal = false;
1388 return $retVal;
1393 class WebInstallerInstall extends WebInstallerPage {
1396 * @return bool Always true.
1398 public function isSlow() {
1399 return true;
1403 * @return string|bool
1405 public function execute() {
1406 if ( $this->getVar( '_UpgradeDone' ) ) {
1407 return 'skip';
1408 } elseif ( $this->getVar( '_InstallDone' ) ) {
1409 return 'continue';
1410 } elseif ( $this->parent->request->wasPosted() ) {
1411 $this->startForm();
1412 $this->addHTML( "<ul>" );
1413 $results = $this->parent->performInstallation(
1414 array( $this, 'startStage' ),
1415 array( $this, 'endStage' )
1417 $this->addHTML( "</ul>" );
1418 // PerformInstallation bails on a fatal, so make sure the last item
1419 // completed before giving 'next.' Likewise, only provide back on failure
1420 $lastStep = end( $results );
1421 $continue = $lastStep->isOK() ? 'continue' : false;
1422 $back = $lastStep->isOK() ? false : 'back';
1423 $this->endForm( $continue, $back );
1424 } else {
1425 $this->startForm();
1426 $this->addHTML( $this->parent->getInfoBox( wfMessage( 'config-install-begin' )->plain() ) );
1427 $this->endForm();
1430 return true;
1434 * @param string $step
1436 public function startStage( $step ) {
1437 // Messages: config-install-database, config-install-tables, config-install-interwiki,
1438 // config-install-stats, config-install-keys, config-install-sysop, config-install-mainpage
1439 $this->addHTML( "<li>" . wfMessage( "config-install-$step" )->escaped() .
1440 wfMessage( 'ellipsis' )->escaped() );
1442 if ( $step == 'extension-tables' ) {
1443 $this->startLiveBox();
1448 * @param string $step
1449 * @param Status $status
1451 public function endStage( $step, $status ) {
1452 if ( $step == 'extension-tables' ) {
1453 $this->endLiveBox();
1455 $msg = $status->isOk() ? 'config-install-step-done' : 'config-install-step-failed';
1456 $html = wfMessage( 'word-separator' )->escaped() . wfMessage( $msg )->escaped();
1457 if ( !$status->isOk() ) {
1458 $html = "<span class=\"error\">$html</span>";
1460 $this->addHTML( $html . "</li>\n" );
1461 if ( !$status->isGood() ) {
1462 $this->parent->showStatusBox( $status );
1468 class WebInstallerComplete extends WebInstallerPage {
1470 public function execute() {
1471 // Pop up a dialog box, to make it difficult for the user to forget
1472 // to download the file
1473 $lsUrl = $this->getVar( 'wgServer' ) . $this->parent->getURL( array( 'localsettings' => 1 ) );
1474 if ( isset( $_SERVER['HTTP_USER_AGENT'] ) &&
1475 strpos( $_SERVER['HTTP_USER_AGENT'], 'MSIE' ) !== false
1477 // JS appears to be the only method that works consistently with IE7+
1478 $this->addHtml( "\n<script>jQuery( function () { location.href = " .
1479 Xml::encodeJsVar( $lsUrl ) . "; } );</script>\n" );
1480 } else {
1481 $this->parent->request->response()->header( "Refresh: 0;url=$lsUrl" );
1484 $this->startForm();
1485 $this->parent->disableLinkPopups();
1486 $this->addHTML(
1487 $this->parent->getInfoBox(
1488 wfMessage( 'config-install-done',
1489 $lsUrl,
1490 $this->getVar( 'wgServer' ) .
1491 $this->getVar( 'wgScriptPath' ) . '/index.php',
1492 '<downloadlink/>'
1493 )->plain(), 'tick-32.png'
1496 $this->addHTML( $this->parent->getInfoBox(
1497 wfMessage( 'config-extension-link' )->text() ) );
1499 $this->parent->restoreLinkPopups();
1500 $this->endForm( false, false );
1505 class WebInstallerRestart extends WebInstallerPage {
1508 * @return string|null
1510 public function execute() {
1511 $r = $this->parent->request;
1512 if ( $r->wasPosted() ) {
1513 $really = $r->getVal( 'submit-restart' );
1514 if ( $really ) {
1515 $this->parent->reset();
1518 return 'continue';
1521 $this->startForm();
1522 $s = $this->parent->getWarningBox( wfMessage( 'config-help-restart' )->plain() );
1523 $this->addHTML( $s );
1524 $this->endForm( 'restart' );
1526 return null;
1531 abstract class WebInstallerDocument extends WebInstallerPage {
1534 * @return string
1536 abstract protected function getFileName();
1538 public function execute() {
1539 $text = $this->getFileContents();
1540 $text = InstallDocFormatter::format( $text );
1541 $this->parent->output->addWikiText( $text );
1542 $this->startForm();
1543 $this->endForm( false );
1547 * @return string
1549 public function getFileContents() {
1550 $file = __DIR__ . '/../../' . $this->getFileName();
1551 if ( !file_exists( $file ) ) {
1552 return wfMessage( 'config-nofile', $file )->plain();
1555 return file_get_contents( $file );
1560 class WebInstallerReadme extends WebInstallerDocument {
1563 * @return string
1565 protected function getFileName() {
1566 return 'README';
1571 class WebInstallerReleaseNotes extends WebInstallerDocument {
1574 * @throws MWException
1575 * @return string
1577 protected function getFileName() {
1578 global $wgVersion;
1580 if ( !preg_match( '/^(\d+)\.(\d+).*/i', $wgVersion, $result ) ) {
1581 throw new MWException( 'Variable $wgVersion has an invalid value.' );
1584 return 'RELEASE-NOTES-' . $result[1] . '.' . $result[2];
1589 class WebInstallerUpgradeDoc extends WebInstallerDocument {
1592 * @return string
1594 protected function getFileName() {
1595 return 'UPGRADE';
1600 class WebInstallerCopying extends WebInstallerDocument {
1603 * @return string
1605 protected function getFileName() {
1606 return 'COPYING';