SpecialUserLogout.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Exception\ErrorPageError;
use MediaWiki\Html\Html;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\SpecialPage\FormSpecialPage;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Status\Status;
use MediaWiki\User\TempUser\TempUserConfig;
use OOUI\HtmlSnippet;
use OOUI\MessageWidget;
 
class SpecialUserLogout extends FormSpecialPage {
    private $oldUserName;
 
    public function __construct(
        private readonly TempUserConfig $tempUserConfig,
    ) {
        parent::__construct( 'Userlogout' );
    }
 
    public function doesWrites() {
        return true;
    }
 
    public function isListed() {
        return $this->getAuthManager()->canAuthenticateNow();
    }
 
    protected function getGroupName() {
        return 'login';
    }
 
    protected function getFormFields() {
        return [];
    }
 
    protected function getDisplayFormat() {
        return 'ooui';
    }
 
    public function execute( $par ) {
        $user = $this->getUser();
        if ( $user->isAnon() ) {
            $this->setHeaders();
            $this->showSuccess();
            return;
        }
        $this->oldUserName = $user->getName();
 
        parent::execute( $par );
    }
 
    public function alterForm( HTMLForm $form ) {
        $form->setTokenSalt( 'logoutToken' );
        $form->setSubmitTextMsg( 'userlogout-submit' );
        if ( $this->getUser()->isTemp() ) {
            $form->addHeaderHtml(
                // Keep in sync with mediawiki.page.ready/ready.js
                Html::rawElement( 'p', [], $this->msg( 'userlogout-temp' )->parse() ) .
                Html::rawElement( 'p', [], $this->msg( 'userlogout-temp-moreinfo' )->parse() ) .
                ( new MessageWidget( [
                    'type' => 'notice',
                    'label' => new HtmlSnippet(
                        Html::element(
                            'strong',
                            [],
                            $this->msg( 'userlogout-temp-messagebox-title' )->text()
                        ) .
                        Html::element( 'br' ) .
                        $this->msg( 'userlogout-temp-messagebox-body' )->parse()
                    ),
                ] ) )->toString()
            );
        } else {
            $form->addHeaderHtml(
                Html::element( 'p', [], $this->msg( 'userlogout-continue' )->text() )
            );
        }
 
        $form->addHiddenFields( $this->getRequest()->getValues( 'returnto', 'returntoquery' ) );
    }
 
    public function onSubmit( array $data ) {
        // Make sure it's possible to log out
        $session = $this->getRequest()->getSession();
        if ( !$session->canSetUser() ) {
            throw new ErrorPageError(
                'cannotlogoutnow-title',
                'cannotlogoutnow-text',
                [
                    $session->getProvider()->describe( $this->getLanguage() )
                ]
            );
        }
 
        $user = $this->getUser();
 
        $user->logout();
        return new Status();
    }
 
    public function onSuccess() {
        $this->showSuccess();
 
        $out = $this->getOutput();
        // Hook.
        $injected_html = '';
        $this->getHookRunner()->onUserLogoutComplete( $this->getUser(), $injected_html, $this->oldUserName );
        $out->addHTML( $injected_html );
    }
 
    private function showSuccess() {
        $loginURL = SpecialPage::getTitleFor( 'Userlogin' )->getFullURL(
            $this->getRequest()->getValues( 'returnto', 'returntoquery' ) );
 
        $out = $this->getOutput();
 
        $messageKey = 'logouttext';
        if (
            ( $this->oldUserName !== null && $this->tempUserConfig->isTempName( $this->oldUserName ) ) ||
            $this->getRequest()->getCheck( 'wasTempUser' )
        ) {
            // Generates the message key logouttext-for-temporary-account which is used to customise the success
            // message for a temporary account.
            $messageKey .= '-for-temporary-account';
        }
        $out->addWikiMsg( $messageKey, $loginURL );
 
        $out->returnToMain();
    }
 
    public function requiresUnblock() {
        return false;
    }
 
    public function getDescription() {
        // Set the page title as "templogout" if the user is (or just was) logged in to a temporary account
        if (
            $this->getUser()->isTemp() ||
            ( $this->oldUserName !== null && $this->tempUserConfig->isTempName( $this->oldUserName ) ) ||
            $this->getRequest()->getCheck( 'wasTempUser' )
        ) {
            return $this->msg( 'templogout' );
        }
        return parent::getDescription();
    }
}
 
class_alias( SpecialUserLogout::class, 'SpecialUserLogout' );