includes/specials/helpers/LoginHelper.php

   1 <?php
   2
   3 /**
   4  * Helper functions for the login form that need to be shared with other special pages
   5  * (such as CentralAuth's SpecialCentralLogin).
   6  * @since 1.27
   7  */
   8 class LoginHelper extends ContextSource {
   9         /**
  10          * Valid error and warning messages
  11          *
  12          * Special:Userlogin can show an error or warning message on the form when
  13          * coming from another page. This is done via the ?error= or ?warning= GET
  14          * parameters.
  15          *
  16          * This array is the list of valid message keys. Further keys can be added by the
  17          * LoginFormValidErrorMessages hook. All other values will be ignored.
  18          *
  19          * @var string[]
  20          */
  21         public static $validErrorMessages = [
  22                 'exception-nologin-text',
  23                 'watchlistanontext',
  24                 'changeemail-no-info',
  25                 'resetpass-no-info',
  26                 'confirmemail_needlogin',
  27                 'prefsnologintext2',
  28         ];
  29
  30         /**
  31          * Returns an array of all valid error messages.
  32          *
  33          * @return array
  34          * @see LoginHelper::$validErrorMessages
  35          */
  36         public static function getValidErrorMessages() {
  37                 static $messages = null;
  38                 if ( !$messages ) {
  39                         $messages = self::$validErrorMessages;
  40                         Hooks::run( 'LoginFormValidErrorMessages', [ &$messages ] );
  41                 }
  42
  43                 return $messages;
  44         }
  45
  46         public function __construct( IContextSource $context ) {
  47                 $this->setContext( $context );
  48         }
  49
  50         /**
  51          * Show a return link or redirect to it.
  52          * Extensions can change where the link should point or inject content into the page
  53          * (which will change it from redirect to link mode).
  54          *
  55          * @param string $type One of the following:
  56          *    - error: display a return to link ignoring $wgRedirectOnLogin
  57          *    - success: display a return to link using $wgRedirectOnLogin if needed
  58          *    - successredirect: send an HTTP redirect using $wgRedirectOnLogin if needed
  59          * @param string $returnTo
  60          * @param array|string $returnToQuery
  61          * @param bool $stickHTTPS Keep redirect link on HTTPS
  62          */
  63         public function showReturnToPage(
  64                 $type, $returnTo = '', $returnToQuery = '', $stickHTTPS = false
  65         ) {
  66                 global $wgRedirectOnLogin, $wgSecureLogin;
  67
  68                 if ( $type !== 'error' && $wgRedirectOnLogin !== null ) {
  69                         $returnTo = $wgRedirectOnLogin;
  70                         $returnToQuery = [];
  71                 } elseif ( is_string( $returnToQuery ) ) {
  72                         $returnToQuery = wfCgiToArray( $returnToQuery );
  73                 }
  74
  75                 // Allow modification of redirect behavior
  76                 Hooks::run( 'PostLoginRedirect', [ &$returnTo, &$returnToQuery, &$type ] );
  77
  78                 $returnToTitle = Title::newFromText( $returnTo ) ?:  Title::newMainPage();
  79
  80                 if ( $wgSecureLogin && !$stickHTTPS ) {
  81                         $options = [ 'http' ];
  82                         $proto = PROTO_HTTP;
  83                 } elseif ( $wgSecureLogin ) {
  84                         $options = [ 'https' ];
  85                         $proto = PROTO_HTTPS;
  86                 } else {
  87                         $options = [];
  88                         $proto = PROTO_RELATIVE;
  89                 }
  90
  91                 if ( $type === 'successredirect' ) {
  92                         $redirectUrl = $returnToTitle->getFullURL( $returnToQuery, false, $proto );
  93                         $this->getOutput()->redirect( $redirectUrl );
  94                 } else {
  95                         $this->getOutput()->addReturnTo( $returnToTitle, $returnToQuery, null, $options );
  96                 }
  97         }
  98 }