wiki.techinc.nl/includes/specials/SpecialUserLogout.php
Dreamy Jazz ab89fff633 Customise Special:UserLogout success message for temporary account
Why:
* When a temporary account exits their session, the
  Special:UserLogout page is loaded to indicate the success.
* However, the success page talks about the temporary account
  logging out which may cause confusion.
* Per design mocks shared on T374519, this should be modified
  to indicate that the user logged out of a temporary account.

What:
* Set 'templogout' as the page title when the user is logging out
  of a temporary account.
* Set 'logouttext-for-temporary-account' as the message shown
  for a logout success when the user is logging out from a
  temporary account
* Update mediawiki.page.ready/ready.js to add a flag to the
  URL Special:UserLogout URL that is redirected to once the
  logout API call has occured.
* Update tests for SpecialUserLogoutTest

Bug: T374519
Change-Id: Ib62cdb5ba716976321cd556aa9defe97b3446b33
2024-09-12 11:06:46 +01:00

172 lines
4.5 KiB
PHP

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\Specials;
use ErrorPageError;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Session\SessionManager;
use MediaWiki\SpecialPage\FormSpecialPage;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Status\Status;
use MediaWiki\User\TempUser\TempUserConfig;
/**
* Implements Special:Userlogout
*
* @ingroup SpecialPage
* @ingroup Auth
*/
class SpecialUserLogout extends FormSpecialPage {
/**
* @var string
*/
private $oldUserName;
private TempUserConfig $tempUserConfig;
public function __construct( TempUserConfig $tempUserConfig ) {
parent::__construct( 'Userlogout' );
$this->tempUserConfig = $tempUserConfig;
}
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->addHeaderHtml( $this->msg(
$this->getUser()->isTemp() ? 'userlogout-temp' : 'userlogout-continue'
) );
$form->addHiddenFields( $this->getRequest()->getValues( 'returnto', 'returntoquery' ) );
}
/**
* Process the form. At this point we know that the user passes all the criteria in
* userCanExecute(), and if the data array contains 'Username', etc, then Username
* resets are allowed.
* @param array $data
* @return Status
*/
public function onSubmit( array $data ) {
// Make sure it's possible to log out
$session = SessionManager::getGlobalSession();
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 (
( isset( $this->oldUserName ) && $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();
}
/**
* Let blocked users to log out and come back with their sockpuppets
* @return bool
*/
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() ||
( isset( $this->oldUserName ) && $this->tempUserConfig->isTempName( $this->oldUserName ) ) ||
$this->getRequest()->getCheck( 'wasTempUser' )
) {
return $this->msg( 'templogout' );
}
return parent::getDescription();
}
}
/**
* Retain the old class name for backwards compatibility.
* @deprecated since 1.41
*/
class_alias( SpecialUserLogout::class, 'SpecialUserLogout' );