SpecialPreferences.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Context\IContextSource;
use MediaWiki\Exception\PermissionsError;
use MediaWiki\Html\Html;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\MediaWikiServices;
use MediaWiki\Preferences\PreferencesFactory;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\User\Options\UserOptionsManager;
use MediaWiki\User\User;
use OOUI\FieldLayout;
use OOUI\SearchInputWidget;
use PreferencesFormOOUI;
 
class SpecialPreferences extends SpecialPage {
 
    private PreferencesFactory $preferencesFactory;
    private UserOptionsManager $userOptionsManager;
 
    public function __construct(
        ?PreferencesFactory $preferencesFactory = null,
        ?UserOptionsManager $userOptionsManager = null
    ) {
        parent::__construct( 'Preferences' );
        // This class is extended and therefore falls back to global state - T265924
        $services = MediaWikiServices::getInstance();
        $this->preferencesFactory = $preferencesFactory ?? $services->getPreferencesFactory();
        $this->userOptionsManager = $userOptionsManager ?? $services->getUserOptionsManager();
    }
 
    public function doesWrites() {
        return true;
    }
 
    public function execute( $par ) {
        $this->setHeaders();
        $this->outputHeader();
        $out = $this->getOutput();
        $out->disallowUserJs(); # Prevent hijacked user scripts from sniffing passwords etc.
 
        $this->requireNamedUser( 'prefsnologintext2' );
        $this->checkReadOnly();
 
        if ( $par == 'reset' ) {
            $this->showResetForm();
 
            return;
        }
 
        $out->addModules( 'mediawiki.special.preferences.ooui' );
        $out->addModuleStyles( [
            'mediawiki.special.preferences.styles.ooui',
            'oojs-ui-widgets.styles',
        ] );
 
        $session = $this->getRequest()->getSession();
        if ( $session->get( 'specialPreferencesSaveSuccess' ) ) {
            // Remove session data for the success message
            $session->remove( 'specialPreferencesSaveSuccess' );
            $out->addModuleStyles( [
                'mediawiki.codex.messagebox.styles',
                'mediawiki.notification.convertmessagebox.styles'
            ] );
 
            $out->addHTML(
                Html::successBox(
                    Html::element(
                        'p',
                        [],
                        $this->msg( 'savedprefs' )->text()
                    ),
                    'mw-preferences-messagebox mw-notify-success'
                )
            );
        }
 
        $this->addHelpLink( 'Help:Preferences' );
 
        // Load the user from the primary DB to reduce CAS errors on double post (T95839)
        if ( $this->getRequest()->wasPosted() ) {
            $user = $this->getUser()->getInstanceForUpdate() ?: $this->getUser();
        } else {
            $user = $this->getUser();
        }
 
        $htmlForm = $this->getFormObject( $user, $this->getContext() );
        $sectionTitles = $htmlForm->getPreferenceSections();
 
        $prefTabs = [];
        foreach ( $sectionTitles as $key ) {
            $prefTabs[] = [
                'name' => $key,
                'label' => $htmlForm->getLegend( $key ),
            ];
        }
        $out->addJsConfigVars( 'wgPreferencesTabs', $prefTabs );
 
        $out->addHTML( new FieldLayout(
            new SearchInputWidget( [
                'placeholder' => $this->msg( 'searchprefs' )->text(),
            ] ),
            [
                'classes' => [ 'mw-prefs-search' ],
                'label' => $this->msg( 'searchprefs' )->text(),
                'invisibleLabel' => true,
                'infusable' => true,
            ]
        ) );
        $htmlForm->show();
    }
 
    protected function getFormObject( $user, IContextSource $context ) {
        $form = $this->preferencesFactory->getForm( $user, $context, PreferencesFormOOUI::class );
        return $form;
    }
 
    protected function showResetForm() {
        if ( !$this->getAuthority()->isAllowed( 'editmyoptions' ) ) {
            throw new PermissionsError( 'editmyoptions' );
        }
 
        $this->getOutput()->addWikiMsg( 'prefs-reset-intro' );
 
        $desc = [
            'confirm' => [
                'type' => 'check',
                'label-message' => 'prefs-reset-confirm',
                'required' => true,
            ],
        ];
        // TODO: disable the submit button if the checkbox is not checked
        HTMLForm::factory( 'ooui', $desc, $this->getContext(), 'prefs-restore' )
            ->setTitle( $this->getPageTitle( 'reset' ) ) // Reset subpage
            ->setSubmitTextMsg( 'restoreprefs' )
            ->setSubmitDestructive()
            ->setSubmitCallback( $this->submitReset( ... ) )
            ->showCancel()
            ->setCancelTarget( $this->getPageTitle() )
            ->show();
    }
 
    public function submitReset( $formData ) {
        if ( !$this->getAuthority()->isAllowed( 'editmyoptions' ) ) {
            throw new PermissionsError( 'editmyoptions' );
        }
 
        $user = $this->getUser()->getInstanceForUpdate();
        $this->userOptionsManager->resetAllOptions( $user );
        $user->saveSettings();
 
        // Set session data for the success message
        $this->getRequest()->getSession()->set( 'specialPreferencesSaveSuccess', 1 );
 
        $url = $this->getPageTitle()->getFullUrlForRedirect();
        $this->getOutput()->redirect( $url );
 
        return true;
    }
 
    protected function getGroupName() {
        return 'login';
    }
}
 
class_alias( SpecialPreferences::class, 'SpecialPreferences' );