includes/specials/SpecialUserlogin.php

   1 <?php
   2 /**
   3  * Implements Special:UserLogin
   4  *
   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.
   9  *
  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.
  14  *
  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
  19  *
  20  * @file
  21  * @ingroup SpecialPage
  22  */
  23
  24 /**
  25  * Implements Special:UserLogin
  26  *
  27  * @ingroup SpecialPage
  28  */
  29 class LoginForm extends SpecialPage {
  30
  31         const SUCCESS = 0;
  32         const NO_NAME = 1;
  33         const ILLEGAL = 2;
  34         const WRONG_PLUGIN_PASS = 3;
  35         const NOT_EXISTS = 4;
  36         const WRONG_PASS = 5;
  37         const EMPTY_PASS = 6;
  38         const RESET_PASS = 7;
  39         const ABORTED = 8;
  40         const CREATE_BLOCKED = 9;
  41         const THROTTLED = 10;
  42         const USER_BLOCKED = 11;
  43         const NEED_TOKEN = 12;
  44         const WRONG_TOKEN = 13;
  45
  46         var $mUsername, $mPassword, $mRetype, $mReturnTo, $mCookieCheck, $mPosted;
  47         var $mAction, $mCreateaccount, $mCreateaccountMail;
  48         var $mLoginattempt, $mRemember, $mEmail, $mDomain, $mLanguage;
  49         var $mSkipCookieCheck, $mReturnToQuery, $mToken, $mStickHTTPS;
  50         var $mType, $mReason, $mRealName;
  51         var $mAbortLoginErrorMsg = 'login-abort-generic';
  52
  53         /**
  54          * @var ExternalUser
  55          */
  56         private $mExtUser = null;
  57
  58         /**
  59          * @param WebRequest $request
  60          */
  61         public function __construct( $request = null ) {
  62                 parent::__construct( 'Userlogin' );
  63
  64                 if ( $request === null ) {
  65                         global $wgRequest;
  66                         $this->load( $wgRequest );
  67                 } else {
  68                         $this->load( $request );
  69                 }
  70         }
  71
  72         /**
  73          * Loader
  74          *
  75          * @param $request WebRequest object
  76          */
  77         function load( $request ) {
  78                 global $wgAuth, $wgHiddenPrefs, $wgEnableEmail, $wgRedirectOnLogin;
  79
  80                 $this->mType = $request->getText( 'type' );
  81                 $this->mUsername = $request->getText( 'wpName' );
  82                 $this->mPassword = $request->getText( 'wpPassword' );
  83                 $this->mRetype = $request->getText( 'wpRetype' );
  84                 $this->mDomain = $request->getText( 'wpDomain' );
  85                 $this->mReason = $request->getText( 'wpReason' );
  86                 $this->mReturnTo = $request->getVal( 'returnto' );
  87                 $this->mReturnToQuery = $request->getVal( 'returntoquery' );
  88                 $this->mCookieCheck = $request->getVal( 'wpCookieCheck' );
  89                 $this->mPosted = $request->wasPosted();
  90                 $this->mCreateaccount = $request->getCheck( 'wpCreateaccount' );
  91                 $this->mCreateaccountMail = $request->getCheck( 'wpCreateaccountMail' )
  92                                                                         && $wgEnableEmail;
  93                 $this->mLoginattempt = $request->getCheck( 'wpLoginattempt' );
  94                 $this->mAction = $request->getVal( 'action' );
  95                 $this->mRemember = $request->getCheck( 'wpRemember' );
  96                 $this->mStickHTTPS = $request->getCheck( 'wpStickHTTPS' );
  97                 $this->mLanguage = $request->getText( 'uselang' );
  98                 $this->mSkipCookieCheck = $request->getCheck( 'wpSkipCookieCheck' );
  99                 $this->mToken = ( $this->mType == 'signup' ) ? $request->getVal( 'wpCreateaccountToken' ) : $request->getVal( 'wpLoginToken' );
 100
 101                 if ( $wgRedirectOnLogin ) {
 102                         $this->mReturnTo = $wgRedirectOnLogin;
 103                         $this->mReturnToQuery = '';
 104                 }
 105
 106                 if( $wgEnableEmail ) {
 107                         $this->mEmail = $request->getText( 'wpEmail' );
 108                 } else {
 109                         $this->mEmail = '';
 110                 }
 111                 if( !in_array( 'realname', $wgHiddenPrefs ) ) {
 112                         $this->mRealName = $request->getText( 'wpRealName' );
 113                 } else {
 114                         $this->mRealName = '';
 115                 }
 116
 117                 if( !$wgAuth->validDomain( $this->mDomain ) ) {
 118                         $this->mDomain = 'invaliddomain';
 119                 }
 120                 $wgAuth->setDomain( $this->mDomain );
 121
 122                 # When switching accounts, it sucks to get automatically logged out
 123                 $returnToTitle = Title::newFromText( $this->mReturnTo );
 124                 if( is_object( $returnToTitle ) && $returnToTitle->isSpecial( 'Userlogout' ) ) {
 125                         $this->mReturnTo = '';
 126                         $this->mReturnToQuery = '';
 127                 }
 128         }
 129
 130         public function execute( $par ) {
 131                 if ( session_id() == '' ) {
 132                         wfSetupSession();
 133                 }
 134
 135                 if ( $par == 'signup' ) { # Check for [[Special:Userlogin/signup]]
 136                         $this->mType = 'signup';
 137                 }
 138
 139                 if ( !is_null( $this->mCookieCheck ) ) {
 140                         $this->onCookieRedirectCheck( $this->mCookieCheck );
 141                         return;
 142                 } elseif( $this->mPosted ) {
 143                         if( $this->mCreateaccount ) {
 144                                 return $this->addNewAccount();
 145                         } elseif ( $this->mCreateaccountMail ) {
 146                                 return $this->addNewAccountMailPassword();
 147                         } elseif ( ( 'submitlogin' == $this->mAction ) || $this->mLoginattempt ) {
 148                                 return $this->processLogin();
 149                         }
 150                 }
 151                 $this->mainLoginForm( '' );
 152         }
 153
 154         /**
 155          * @private
 156          */
 157         function addNewAccountMailPassword() {
 158                 global $wgOut;
 159
 160                 if ( $this->mEmail == '' ) {
 161                         $this->mainLoginForm( wfMsgExt( 'noemailcreate', array( 'parsemag', 'escape' ) ) );
 162                         return;
 163                 }
 164
 165                 $u = $this->addNewaccountInternal();
 166
 167                 if ( $u == null ) {
 168                         return;
 169                 }
 170
 171                 // Wipe the initial password and mail a temporary one
 172                 $u->setPassword( null );
 173                 $u->saveSettings();
 174                 $result = $this->mailPasswordInternal( $u, false, 'createaccount-title', 'createaccount-text' );
 175
 176                 wfRunHooks( 'AddNewAccount', array( $u, true ) );
 177                 $u->addNewUserLogEntry( true, $this->mReason );
 178
 179                 $wgOut->setPageTitle( wfMsg( 'accmailtitle' ) );
 180
 181                 if( !$result->isGood() ) {
 182                         $this->mainLoginForm( wfMsg( 'mailerror', $result->getWikiText() ) );
 183                 } else {
 184                         $wgOut->addWikiMsg( 'accmailtext', $u->getName(), $u->getEmail() );
 185                         $wgOut->returnToMain( false );
 186                 }
 187         }
 188
 189         /**
 190          * @private
 191          */
 192         function addNewAccount() {
 193                 global $wgUser, $wgEmailAuthentication, $wgOut;
 194
 195                 # Create the account and abort if there's a problem doing so
 196                 $u = $this->addNewAccountInternal();
 197                 if( $u == null ) {
 198                         return;
 199                 }
 200
 201                 # If we showed up language selection links, and one was in use, be
 202                 # smart (and sensible) and save that language as the user's preference
 203                 global $wgLoginLanguageSelector;
 204                 if( $wgLoginLanguageSelector && $this->mLanguage ) {
 205                         $u->setOption( 'language', $this->mLanguage );
 206                 }
 207
 208                 # Send out an email authentication message if needed
 209                 if( $wgEmailAuthentication && Sanitizer::validateEmail( $u->getEmail() ) ) {
 210                         $status = $u->sendConfirmationMail();
 211                         if( $status->isGood() ) {
 212                                 $wgOut->addWikiMsg( 'confirmemail_oncreate' );
 213                         } else {
 214                                 $wgOut->addWikiText( $status->getWikiText( 'confirmemail_sendfailed' ) );
 215                         }
 216                 }
 217
 218                 # Save settings (including confirmation token)
 219                 $u->saveSettings();
 220
 221                 # If not logged in, assume the new account as the current one and set
 222                 # session cookies then show a "welcome" message or a "need cookies"
 223                 # message as needed
 224                 if( $wgUser->isAnon() ) {
 225                         $wgUser = $u;
 226                         $wgUser->setCookies();
 227                         // This should set it for OutputPage and the Skin
 228                         // which is needed or the personal links will be
 229                         // wrong.
 230                         RequestContext::getMain()->setUser( $u );
 231                         wfRunHooks( 'AddNewAccount', array( $wgUser, false ) );
 232                         $wgUser->addNewUserLogEntry();
 233                         if( $this->hasSessionCookie() ) {
 234                                 return $this->successfulCreation();
 235                         } else {
 236                                 return $this->cookieRedirectCheck( 'new' );
 237                         }
 238                 } else {
 239                         # Confirm that the account was created
 240                         $self = SpecialPage::getTitleFor( 'Userlogin' );
 241                         $wgOut->setPageTitle( wfMsgHtml( 'accountcreated' ) );
 242                         $wgOut->addWikiMsg( 'accountcreatedtext', $u->getName() );
 243                         $wgOut->returnToMain( false, $self );
 244                         wfRunHooks( 'AddNewAccount', array( $u, false ) );
 245                         $u->addNewUserLogEntry( false, $this->mReason );
 246                         return true;
 247                 }
 248         }
 249
 250         /**
 251          * @private
 252          */
 253         function addNewAccountInternal() {
 254                 global $wgUser, $wgOut;
 255                 global $wgMemc, $wgAccountCreationThrottle;
 256                 global $wgAuth, $wgMinimalPasswordLength;
 257                 global $wgEmailConfirmToEdit;
 258
 259                 // If the user passes an invalid domain, something is fishy
 260                 if( !$wgAuth->validDomain( $this->mDomain ) ) {
 261                         $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
 262                         return false;
 263                 }
 264
 265                 // If we are not allowing users to login locally, we should be checking
 266                 // to see if the user is actually able to authenticate to the authenti-
 267                 // cation server before they create an account (otherwise, they can
 268                 // create a local account and login as any domain user). We only need
 269                 // to check this for domains that aren't local.
 270                 if( 'local' != $this->mDomain && $this->mDomain != '' ) {
 271                         if( !$wgAuth->canCreateAccounts() && ( !$wgAuth->userExists( $this->mUsername )
 272                                 || !$wgAuth->authenticate( $this->mUsername, $this->mPassword ) ) ) {
 273                                 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
 274                                 return false;
 275                         }
 276                 }
 277
 278                 if ( wfReadOnly() ) {
 279                         $wgOut->readOnlyPage();
 280                         return false;
 281                 }
 282
 283                 # Request forgery checks.
 284                 if ( !self::getCreateaccountToken() ) {
 285                         self::setCreateaccountToken();
 286                         $this->mainLoginForm( wfMsgExt( 'nocookiesfornew', array( 'parseinline' ) ) );
 287                         return false;
 288                 }
 289
 290                 # The user didn't pass a createaccount token
 291                 if ( !$this->mToken ) {
 292                         $this->mainLoginForm( wfMsg( 'sessionfailure' ) );
 293                         return false;
 294                 }
 295
 296                 # Validate the createaccount token
 297                 if ( $this->mToken !== self::getCreateaccountToken() ) {
 298                         $this->mainLoginForm( wfMsg( 'sessionfailure' ) );
 299                         return false;
 300                 }
 301
 302                 # Check permissions
 303                 if ( !$wgUser->isAllowed( 'createaccount' ) ) {
 304                         $wgOut->permissionRequired( 'createaccount' );
 305                         return false;
 306                 } elseif ( $wgUser->isBlockedFromCreateAccount() ) {
 307                         $this->userBlockedMessage( $wgUser->isBlockedFromCreateAccount() );
 308                         return false;
 309                 }
 310
 311                 $ip = wfGetIP();
 312                 if ( $wgUser->isDnsBlacklisted( $ip, true /* check $wgProxyWhitelist */ ) ) {
 313                         $this->mainLoginForm( wfMsg( 'sorbs_create_account_reason' ) . ' (' . htmlspecialchars( $ip ) . ')' );
 314                         return false;
 315                 }
 316
 317                 # Now create a dummy user ($u) and check if it is valid
 318                 $name = trim( $this->mUsername );
 319                 $u = User::newFromName( $name, 'creatable' );
 320                 if ( !is_object( $u ) ) {
 321                         $this->mainLoginForm( wfMsg( 'noname' ) );
 322                         return false;
 323                 }
 324
 325                 if ( 0 != $u->idForName() ) {
 326                         $this->mainLoginForm( wfMsg( 'userexists' ) );
 327                         return false;
 328                 }
 329
 330                 if ( 0 != strcmp( $this->mPassword, $this->mRetype ) ) {
 331                         $this->mainLoginForm( wfMsg( 'badretype' ) );
 332                         return false;
 333                 }
 334
 335                 # check for minimal password length
 336                 $valid = $u->getPasswordValidity( $this->mPassword );
 337                 if ( $valid !== true ) {
 338                         if ( !$this->mCreateaccountMail ) {
 339                                 if ( is_array( $valid ) ) {
 340                                         $message = array_shift( $valid );
 341                                         $params = $valid;
 342                                 } else {
 343                                         $message = $valid;
 344                                         $params = array( $wgMinimalPasswordLength );
 345                                 }
 346                                 $this->mainLoginForm( wfMsgExt( $message, array( 'parsemag' ), $params ) );
 347                                 return false;
 348                         } else {
 349                                 # do not force a password for account creation by email
 350                                 # set invalid password, it will be replaced later by a random generated password
 351                                 $this->mPassword = null;
 352                         }
 353                 }
 354
 355                 # if you need a confirmed email address to edit, then obviously you
 356                 # need an email address.
 357                 if ( $wgEmailConfirmToEdit && empty( $this->mEmail ) ) {
 358                         $this->mainLoginForm( wfMsg( 'noemailtitle' ) );
 359                         return false;
 360                 }
 361
 362                 if( !empty( $this->mEmail ) && !Sanitizer::validateEmail( $this->mEmail ) ) {
 363                         $this->mainLoginForm( wfMsg( 'invalidemailaddress' ) );
 364                         return false;
 365                 }
 366
 367                 # Set some additional data so the AbortNewAccount hook can be used for
 368                 # more than just username validation
 369                 $u->setEmail( $this->mEmail );
 370                 $u->setRealName( $this->mRealName );
 371
 372                 $abortError = '';
 373                 if( !wfRunHooks( 'AbortNewAccount', array( $u, &$abortError ) ) ) {
 374                         // Hook point to add extra creation throttles and blocks
 375                         wfDebug( "LoginForm::addNewAccountInternal: a hook blocked creation\n" );
 376                         $this->mainLoginForm( $abortError );
 377                         return false;
 378                 }
 379
 380                 if ( $wgAccountCreationThrottle && $wgUser->isPingLimitable() ) {
 381                         $key = wfMemcKey( 'acctcreate', 'ip', $ip );
 382                         $value = $wgMemc->get( $key );
 383                         if ( !$value ) {
 384                                 $wgMemc->set( $key, 0, 86400 );
 385                         }
 386                         if ( $value >= $wgAccountCreationThrottle ) {
 387                                 $this->throttleHit( $wgAccountCreationThrottle );
 388                                 return false;
 389                         }
 390                         $wgMemc->incr( $key );
 391                 }
 392
 393                 if( !$wgAuth->addUser( $u, $this->mPassword, $this->mEmail, $this->mRealName ) ) {
 394                         $this->mainLoginForm( wfMsg( 'externaldberror' ) );
 395                         return false;
 396                 }
 397
 398                 self::clearCreateaccountToken();
 399                 return $this->initUser( $u, false );
 400         }
 401
 402         /**
 403          * Actually add a user to the database.
 404          * Give it a User object that has been initialised with a name.
 405          *
 406          * @param $u User object.
 407          * @param $autocreate boolean -- true if this is an autocreation via auth plugin
 408          * @return User object.
 409          * @private
 410          */
 411         function initUser( $u, $autocreate ) {
 412                 global $wgAuth;
 413
 414                 $u->addToDatabase();
 415
 416                 if ( $wgAuth->allowPasswordChange() ) {
 417                         $u->setPassword( $this->mPassword );
 418                 }
 419
 420                 $u->setEmail( $this->mEmail );
 421                 $u->setRealName( $this->mRealName );
 422                 $u->setToken();
 423
 424                 $wgAuth->initUser( $u, $autocreate );
 425
 426                 if ( $this->mExtUser ) {
 427                         $this->mExtUser->linkToLocal( $u->getId() );
 428                         $email = $this->mExtUser->getPref( 'emailaddress' );
 429                         if ( $email && !$this->mEmail ) {
 430                                 $u->setEmail( $email );
 431                         }
 432                 }
 433
 434                 $u->setOption( 'rememberpassword', $this->mRemember ? 1 : 0 );
 435                 $u->saveSettings();
 436
 437                 # Update user count
 438                 $ssUpdate = new SiteStatsUpdate( 0, 0, 0, 0, 1 );
 439                 $ssUpdate->doUpdate();
 440
 441                 return $u;
 442         }
 443
 444         /**
 445          * Internally authenticate the login request.
 446          *
 447          * This may create a local account as a side effect if the
 448          * authentication plugin allows transparent local account
 449          * creation.
 450          */
 451         public function authenticateUserData() {
 452                 global $wgUser, $wgAuth, $wgMemc;
 453
 454                 if ( $this->mUsername == '' ) {
 455                         return self::NO_NAME;
 456                 }
 457
 458                 // We require a login token to prevent login CSRF
 459                 // Handle part of this before incrementing the throttle so
 460                 // token-less login attempts don't count towards the throttle
 461                 // but wrong-token attempts do.
 462
 463                 // If the user doesn't have a login token yet, set one.
 464                 if ( !self::getLoginToken() ) {
 465                         self::setLoginToken();
 466                         return self::NEED_TOKEN;
 467                 }
 468                 // If the user didn't pass a login token, tell them we need one
 469                 if ( !$this->mToken ) {
 470                         return self::NEED_TOKEN;
 471                 }
 472
 473                 global $wgPasswordAttemptThrottle;
 474
 475                 $throttleCount = 0;
 476                 if ( is_array( $wgPasswordAttemptThrottle ) ) {
 477                         $throttleKey = wfMemcKey( 'password-throttle', wfGetIP(), md5( $this->mUsername ) );
 478                         $count = $wgPasswordAttemptThrottle['count'];
 479                         $period = $wgPasswordAttemptThrottle['seconds'];
 480
 481                         $throttleCount = $wgMemc->get( $throttleKey );
 482                         if ( !$throttleCount ) {
 483                                 $wgMemc->add( $throttleKey, 1, $period ); // start counter
 484                         } elseif ( $throttleCount < $count ) {
 485                                 $wgMemc->incr( $throttleKey );
 486                         } elseif ( $throttleCount >= $count ) {
 487                                 return self::THROTTLED;
 488                         }
 489                 }
 490
 491                 // Validate the login token
 492                 if ( $this->mToken !== self::getLoginToken() ) {
 493                         return self::WRONG_TOKEN;
 494                 }
 495
 496                 // Load $wgUser now, and check to see if we're logging in as the same
 497                 // name. This is necessary because loading $wgUser (say by calling
 498                 // getName()) calls the UserLoadFromSession hook, which potentially
 499                 // creates the user in the database. Until we load $wgUser, checking
 500                 // for user existence using User::newFromName($name)->getId() below
 501                 // will effectively be using stale data.
 502                 if ( $wgUser->getName() === $this->mUsername ) {
 503                         wfDebug( __METHOD__ . ": already logged in as {$this->mUsername}\n" );
 504                         return self::SUCCESS;
 505                 }
 506
 507                 $this->mExtUser = ExternalUser::newFromName( $this->mUsername );
 508
 509                 # TODO: Allow some magic here for invalid external names, e.g., let the
 510                 # user choose a different wiki name.
 511                 $u = User::newFromName( $this->mUsername );
 512                 if( !( $u instanceof User ) || !User::isUsableName( $u->getName() ) ) {
 513                         return self::ILLEGAL;
 514                 }
 515
 516                 $isAutoCreated = false;
 517                 if ( 0 == $u->getID() ) {
 518                         $status = $this->attemptAutoCreate( $u );
 519                         if ( $status !== self::SUCCESS ) {
 520                                 return $status;
 521                         } else {
 522                                 $isAutoCreated = true;
 523                         }
 524                 } else {
 525                         global $wgExternalAuthType, $wgAutocreatePolicy;
 526                         if ( $wgExternalAuthType && $wgAutocreatePolicy != 'never'
 527                         && is_object( $this->mExtUser )
 528                         && $this->mExtUser->authenticate( $this->mPassword ) ) {
 529                                 # The external user and local user have the same name and
 530                                 # password, so we assume they're the same.
 531                                 $this->mExtUser->linkToLocal( $u->getID() );
 532                         }
 533
 534                         $u->load();
 535                 }
 536
 537                 // Give general extensions, such as a captcha, a chance to abort logins
 538                 $abort = self::ABORTED;
 539                 if( !wfRunHooks( 'AbortLogin', array( $u, $this->mPassword, &$abort, &$this->mAbortLoginErrorMsg ) ) ) {
 540                         return $abort;
 541                 }
 542
 543                 global $wgBlockDisablesLogin;
 544                 if ( !$u->checkPassword( $this->mPassword ) ) {
 545                         if( $u->checkTemporaryPassword( $this->mPassword ) ) {
 546                                 // The e-mailed temporary password should not be used for actu-
 547                                 // al logins; that's a very sloppy habit, and insecure if an
 548                                 // attacker has a few seconds to click "search" on someone's o-
 549                                 // pen mail reader.
 550                                 //
 551                                 // Allow it to be used only to reset the password a single time
 552                                 // to a new value, which won't be in the user's e-mail ar-
 553                                 // chives.
 554                                 //
 555                                 // For backwards compatibility, we'll still recognize it at the
 556                                 // login form to minimize surprises for people who have been
 557                                 // logging in with a temporary password for some time.
 558                                 //
 559                                 // As a side-effect, we can authenticate the user's e-mail ad-
 560                                 // dress if it's not already done, since the temporary password
 561                                 // was sent via e-mail.
 562                                 if( !$u->isEmailConfirmed() ) {
 563                                         $u->confirmEmail();
 564                                         $u->saveSettings();
 565                                 }
 566
 567                                 // At this point we just return an appropriate code/ indicating
 568                                 // that the UI should show a password reset form; bot inter-
 569                                 // faces etc will probably just fail cleanly here.
 570                                 $retval = self::RESET_PASS;
 571                         } else {
 572                                 $retval = ( $this->mPassword  == '' ) ? self::EMPTY_PASS : self::WRONG_PASS;
 573                         }
 574                 } elseif ( $wgBlockDisablesLogin && $u->isBlocked() ) {
 575                         // If we've enabled it, make it so that a blocked user cannot login
 576                         $retval = self::USER_BLOCKED;
 577                 } else {
 578                         $wgAuth->updateUser( $u );
 579                         $wgUser = $u;
 580
 581                         // Please reset throttle for successful logins, thanks!
 582                         if( $throttleCount ) {
 583                                 $wgMemc->delete( $throttleKey );
 584                         }
 585
 586                         if ( $isAutoCreated ) {
 587                                 // Must be run after $wgUser is set, for correct new user log
 588                                 wfRunHooks( 'AuthPluginAutoCreate', array( $wgUser ) );
 589                         }
 590
 591                         $retval = self::SUCCESS;
 592                 }
 593                 wfRunHooks( 'LoginAuthenticateAudit', array( $u, $this->mPassword, $retval ) );
 594                 return $retval;
 595         }
 596
 597         /**
 598          * Attempt to automatically create a user on login. Only succeeds if there
 599          * is an external authentication method which allows it.
 600          *
 601          * @param $user User
 602          *
 603          * @return integer Status code
 604          */
 605         function attemptAutoCreate( $user ) {
 606                 global $wgAuth, $wgUser, $wgAutocreatePolicy;
 607
 608                 if ( $wgUser->isBlockedFromCreateAccount() ) {
 609                         wfDebug( __METHOD__ . ": user is blocked from account creation\n" );
 610                         return self::CREATE_BLOCKED;
 611                 }
 612
 613                 /**
 614                  * If the external authentication plugin allows it, automatically cre-
 615                  * ate a new account for users that are externally defined but have not
 616                  * yet logged in.
 617                  */
 618                 if ( $this->mExtUser ) {
 619                         # mExtUser is neither null nor false, so use the new ExternalAuth
 620                         # system.
 621                         if ( $wgAutocreatePolicy == 'never' ) {
 622                                 return self::NOT_EXISTS;
 623                         }
 624                         if ( !$this->mExtUser->authenticate( $this->mPassword ) ) {
 625                                 return self::WRONG_PLUGIN_PASS;
 626                         }
 627                 } else {
 628                         # Old AuthPlugin.
 629                         if ( !$wgAuth->autoCreate() ) {
 630                                 return self::NOT_EXISTS;
 631                         }
 632                         if ( !$wgAuth->userExists( $user->getName() ) ) {
 633                                 wfDebug( __METHOD__ . ": user does not exist\n" );
 634                                 return self::NOT_EXISTS;
 635                         }
 636                         if ( !$wgAuth->authenticate( $user->getName(), $this->mPassword ) ) {
 637                                 wfDebug( __METHOD__ . ": \$wgAuth->authenticate() returned false, aborting\n" );
 638                                 return self::WRONG_PLUGIN_PASS;
 639                         }
 640                 }
 641
 642                 $abortError = '';
 643                 if( !wfRunHooks( 'AbortAutoAccount', array( $user, &$abortError ) ) ) {
 644                         // Hook point to add extra creation throttles and blocks
 645                         wfDebug( "LoginForm::attemptAutoCreate: a hook blocked creation: $abortError\n" );
 646                         $this->mAbortLoginErrorMsg = $abortError;
 647                         return self::ABORTED;
 648                 }
 649
 650                 wfDebug( __METHOD__ . ": creating account\n" );
 651                 $this->initUser( $user, true );
 652                 return self::SUCCESS;
 653         }
 654
 655         function processLogin() {
 656                 global $wgUser;
 657
 658                 switch ( $this->authenticateUserData() ) {
 659                         case self::SUCCESS:
 660                                 # We've verified now, update the real record
 661                                 if( (bool)$this->mRemember != (bool)$wgUser->getOption( 'rememberpassword' ) ) {
 662                                         $wgUser->setOption( 'rememberpassword', $this->mRemember ? 1 : 0 );
 663                                         $wgUser->saveSettings();
 664                                 } else {
 665                                         $wgUser->invalidateCache();
 666                                 }
 667                                 $wgUser->setCookies();
 668                                 self::clearLoginToken();
 669
 670                                 // Reset the throttle
 671                                 $key = wfMemcKey( 'password-throttle', wfGetIP(), md5( $this->mUsername ) );
 672                                 global $wgMemc;
 673                                 $wgMemc->delete( $key );
 674
 675                                 if( $this->hasSessionCookie() || $this->mSkipCookieCheck ) {
 676                                         /* Replace the language object to provide user interface in
 677                                          * correct language immediately on this first page load.
 678                                          */
 679                                         global $wgLang, $wgRequest;
 680                                         $code = $wgRequest->getVal( 'uselang', $wgUser->getOption( 'language' ) );
 681                                         $wgLang = Language::factory( $code );
 682                                         return $this->successfulLogin();
 683                                 } else {
 684                                         return $this->cookieRedirectCheck( 'login' );
 685                                 }
 686                                 break;
 687
 688                         case self::NEED_TOKEN:
 689                                 $this->mainLoginForm( wfMsgExt( 'nocookiesforlogin', array( 'parseinline' ) ) );
 690                                 break;
 691                         case self::WRONG_TOKEN:
 692                                 $this->mainLoginForm( wfMsg( 'sessionfailure' ) );
 693                                 break;
 694                         case self::NO_NAME:
 695                         case self::ILLEGAL:
 696                                 $this->mainLoginForm( wfMsg( 'noname' ) );
 697                                 break;
 698                         case self::WRONG_PLUGIN_PASS:
 699                                 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
 700                                 break;
 701                         case self::NOT_EXISTS:
 702                                 if( $wgUser->isAllowed( 'createaccount' ) ) {
 703                                         $this->mainLoginForm( wfMsgExt( 'nosuchuser', 'parseinline',
 704                                            wfEscapeWikiText( $this->mUsername ) ) );
 705                                 } else {
 706                                         $this->mainLoginForm( wfMsg( 'nosuchusershort',
 707                                                 wfEscapeWikiText( $this->mUsername ) ) );
 708                                 }
 709                                 break;
 710                         case self::WRONG_PASS:
 711                                 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
 712                                 break;
 713                         case self::EMPTY_PASS:
 714                                 $this->mainLoginForm( wfMsg( 'wrongpasswordempty' ) );
 715                                 break;
 716                         case self::RESET_PASS:
 717                                 $this->resetLoginForm( wfMsg( 'resetpass_announce' ) );
 718                                 break;
 719                         case self::CREATE_BLOCKED:
 720                                 $this->userBlockedMessage( $wgUser->mBlock );
 721                                 break;
 722                         case self::THROTTLED:
 723                                 $this->mainLoginForm( wfMsg( 'login-throttled' ) );
 724                                 break;
 725                         case self::USER_BLOCKED:
 726                                 $this->mainLoginForm( wfMsgExt( 'login-userblocked',
 727                                         array( 'parsemag', 'escape' ), $this->mUsername ) );
 728                                 break;
 729                         case self::ABORTED:
 730                                 $this->mainLoginForm( wfMsg( $this->mAbortLoginErrorMsg  ) );
 731                                 break;
 732                         default:
 733                                 throw new MWException( 'Unhandled case value' );
 734                 }
 735         }
 736
 737         function resetLoginForm( $error ) {
 738                 global $wgOut;
 739                 $wgOut->addHTML( Xml::element('p', array( 'class' => 'error' ), $error ) );
 740                 $reset = new SpecialChangePassword();
 741                 $reset->execute( null );
 742         }
 743
 744         /**
 745          * @param $u User object
 746          * @param $throttle Boolean
 747          * @param $emailTitle String: message name of email title
 748          * @param $emailText String: message name of email text
 749          * @return Status object
 750          * @private
 751          */
 752         function mailPasswordInternal( $u, $throttle = true, $emailTitle = 'passwordremindertitle', $emailText = 'passwordremindertext' ) {
 753                 global $wgServer, $wgScript, $wgUser, $wgNewPasswordExpiry;
 754
 755                 if ( $u->getEmail() == '' ) {
 756                         return Status::newFatal( 'noemail', $u->getName() );
 757                 }
 758                 $ip = wfGetIP();
 759                 if( !$ip ) {
 760                         return Status::newFatal( 'badipaddress' );
 761                 }
 762
 763                 wfRunHooks( 'User::mailPasswordInternal', array( &$wgUser, &$ip, &$u ) );
 764
 765                 $np = $u->randomPassword();
 766                 $u->setNewpassword( $np, $throttle );
 767                 $u->saveSettings();
 768                 $userLanguage = $u->getOption( 'language' );
 769                 $m = wfMsgExt( $emailText, array( 'parsemag', 'language' => $userLanguage ), $ip, $u->getName(), $np,
 770                                 $wgServer . $wgScript, round( $wgNewPasswordExpiry / 86400 ) );
 771                 $result = $u->sendMail( wfMsgExt( $emailTitle, array( 'parsemag', 'language' => $userLanguage ) ), $m );
 772
 773                 return $result;
 774         }
 775
 776
 777         /**
 778          * Run any hooks registered for logins, then HTTP redirect to
 779          * $this->mReturnTo (or Main Page if that's undefined).  Formerly we had a
 780          * nice message here, but that's really not as useful as just being sent to
 781          * wherever you logged in from.  It should be clear that the action was
 782          * successful, given the lack of error messages plus the appearance of your
 783          * name in the upper right.
 784          *
 785          * @private
 786          */
 787         function successfulLogin() {
 788                 global $wgUser, $wgOut;
 789
 790                 # Run any hooks; display injected HTML if any, else redirect
 791                 $injected_html = '';
 792                 wfRunHooks( 'UserLoginComplete', array( &$wgUser, &$injected_html ) );
 793
 794                 if( $injected_html !== '' ) {
 795                         $this->displaySuccessfulLogin( 'loginsuccess', $injected_html );
 796                 } else {
 797                         $titleObj = Title::newFromText( $this->mReturnTo );
 798                         if ( !$titleObj instanceof Title ) {
 799                                 $titleObj = Title::newMainPage();
 800                         }
 801                         $redirectUrl = $titleObj->getFullURL( $this->mReturnToQuery );
 802                         global $wgSecureLogin;
 803                         if( $wgSecureLogin && !$this->mStickHTTPS ) {
 804                                 $redirectUrl = preg_replace( '/^https:/', 'http:', $redirectUrl );
 805                         }
 806                         $wgOut->redirect( $redirectUrl );
 807                 }
 808         }
 809
 810         /**
 811          * Run any hooks registered for logins, then display a message welcoming
 812          * the user.
 813          *
 814          * @private
 815          */
 816         function successfulCreation() {
 817                 global $wgUser;
 818                 # Run any hooks; display injected HTML
 819                 $injected_html = '';
 820                 $welcome_creation_msg = 'welcomecreation';
 821
 822                 wfRunHooks( 'UserLoginComplete', array( &$wgUser, &$injected_html ) );
 823
 824                 //let any extensions change what message is shown
 825                 wfRunHooks( 'BeforeWelcomeCreation', array( &$welcome_creation_msg, &$injected_html ) );
 826
 827                 $this->displaySuccessfulLogin( $welcome_creation_msg, $injected_html );
 828         }
 829
 830         /**
 831          * Display a "login successful" page.
 832          */
 833         private function displaySuccessfulLogin( $msgname, $injected_html ) {
 834                 global $wgOut, $wgUser;
 835
 836                 $wgOut->setPageTitle( wfMsg( 'loginsuccesstitle' ) );
 837                 if( $msgname ){
 838                         $wgOut->addWikiMsg( $msgname, wfEscapeWikiText( $wgUser->getName() ) );
 839                 }
 840
 841                 $wgOut->addHTML( $injected_html );
 842
 843                 if ( !empty( $this->mReturnTo ) ) {
 844                         $wgOut->returnToMain( null, $this->mReturnTo, $this->mReturnToQuery );
 845                 } else {
 846                         $wgOut->returnToMain( null );
 847                 }
 848         }
 849
 850         /**
 851          * Output a message that informs the user that they cannot create an account because
 852          * there is a block on them or their IP which prevents account creation.  Note that
 853          * User::isBlockedFromCreateAccount(), which gets this block, ignores the 'hardblock'
 854          * setting on blocks (bug 13611).
 855          * @param $block Block the block causing this error
 856          */
 857         function userBlockedMessage( Block $block ) {
 858                 global $wgOut;
 859
 860                 # Let's be nice about this, it's likely that this feature will be used
 861                 # for blocking large numbers of innocent people, e.g. range blocks on
 862                 # schools. Don't blame it on the user. There's a small chance that it
 863                 # really is the user's fault, i.e. the username is blocked and they
 864                 # haven't bothered to log out before trying to create an account to
 865                 # evade it, but we'll leave that to their guilty conscience to figure
 866                 # out.
 867
 868                 $wgOut->setPageTitle( wfMsg( 'cantcreateaccounttitle' ) );
 869
 870                 $block_reason = $block->mReason;
 871                 if ( strval( $block_reason ) === '' ) {
 872                         $block_reason = wfMsg( 'blockednoreason' );
 873                 }
 874
 875                 $wgOut->addWikiMsg(
 876                         'cantcreateaccount-text',
 877                         $block->getTarget(),
 878                         $block_reason,
 879                         $block->getBlocker()->getName()
 880                 );
 881
 882                 $wgOut->returnToMain( false );
 883         }
 884
 885         /**
 886          * @private
 887          */
 888         function mainLoginForm( $msg, $msgtype = 'error' ) {
 889                 global $wgUser, $wgOut, $wgHiddenPrefs;
 890                 global $wgEnableEmail, $wgEnableUserEmail;
 891                 global $wgRequest, $wgLoginLanguageSelector;
 892                 global $wgAuth, $wgEmailConfirmToEdit, $wgCookieExpiration;
 893                 global $wgSecureLogin, $wgPasswordResetRoutes;
 894
 895                 $titleObj = SpecialPage::getTitleFor( 'Userlogin' );
 896
 897                 if ( $this->mType == 'signup' ) {
 898                         // Block signup here if in readonly. Keeps user from
 899                         // going through the process (filling out data, etc)
 900                         // and being informed later.
 901                         if ( wfReadOnly() ) {
 902                                 $wgOut->readOnlyPage();
 903                                 return;
 904                         } elseif ( $wgUser->isBlockedFromCreateAccount() ) {
 905                                 $this->userBlockedMessage( $wgUser->isBlockedFromCreateAccount() );
 906                                 return;
 907                         } elseif ( count( $permErrors = $titleObj->getUserPermissionsErrors( 'createaccount', $wgUser, true ) )>0 ) {
 908                                 $wgOut->showPermissionsErrorPage( $permErrors, 'createaccount' );
 909                                 return;
 910                         }
 911                 }
 912
 913                 if ( $this->mUsername == '' ) {
 914                         if ( $wgUser->isLoggedIn() ) {
 915                                 $this->mUsername = $wgUser->getName();
 916                         } else {
 917                                 $this->mUsername = $wgRequest->getCookie( 'UserName' );
 918                         }
 919                 }
 920
 921                 if ( $this->mType == 'signup' ) {
 922                         $template = new UsercreateTemplate();
 923                         $q = 'action=submitlogin&type=signup';
 924                         $linkq = 'type=login';
 925                         $linkmsg = 'gotaccount';
 926                 } else {
 927                         $template = new UserloginTemplate();
 928                         $q = 'action=submitlogin&type=login';
 929                         $linkq = 'type=signup';
 930                         $linkmsg = 'nologin';
 931                 }
 932
 933                 if ( !empty( $this->mReturnTo ) ) {
 934                         $returnto = '&returnto=' . wfUrlencode( $this->mReturnTo );
 935                         if ( !empty( $this->mReturnToQuery ) ) {
 936                                 $returnto .= '&returntoquery=' .
 937                                         wfUrlencode( $this->mReturnToQuery );
 938                         }
 939                         $q .= $returnto;
 940                         $linkq .= $returnto;
 941                 }
 942
 943                 # Pass any language selection on to the mode switch link
 944                 if( $wgLoginLanguageSelector && $this->mLanguage ) {
 945                         $linkq .= '&uselang=' . $this->mLanguage;
 946                 }
 947
 948                 $link = '<a href="' . htmlspecialchars ( $titleObj->getLocalURL( $linkq ) ) . '">';
 949                 $link .= wfMsgHtml( $linkmsg . 'link' ); # Calling either 'gotaccountlink' or 'nologinlink'
 950                 $link .= '</a>';
 951
 952                 # Don't show a "create account" link if the user can't
 953                 if( $this->showCreateOrLoginLink( $wgUser ) ) {
 954                         $template->set( 'link', wfMsgExt( $linkmsg, array( 'parseinline', 'replaceafter' ), $link ) );
 955                 } else {
 956                         $template->set( 'link', '' );
 957                 }
 958
 959                 $resetLink = $this->mType == 'signup'
 960                         ? null
 961                         : is_array( $wgPasswordResetRoutes ) && in_array( true, array_values( $wgPasswordResetRoutes ) );
 962
 963                 $template->set( 'header', '' );
 964                 $template->set( 'name', $this->mUsername );
 965                 $template->set( 'password', $this->mPassword );
 966                 $template->set( 'retype', $this->mRetype );
 967                 $template->set( 'email', $this->mEmail );
 968                 $template->set( 'realname', $this->mRealName );
 969                 $template->set( 'domain', $this->mDomain );
 970                 $template->set( 'reason', $this->mReason );
 971
 972                 $template->set( 'action', $titleObj->getLocalURL( $q ) );
 973                 $template->set( 'message', $msg );
 974                 $template->set( 'messagetype', $msgtype );
 975                 $template->set( 'createemail', $wgEnableEmail && $wgUser->isLoggedIn() );
 976                 $template->set( 'userealname', !in_array( 'realname', $wgHiddenPrefs ) );
 977                 $template->set( 'useemail', $wgEnableEmail );
 978                 $template->set( 'emailrequired', $wgEmailConfirmToEdit );
 979                 $template->set( 'emailothers', $wgEnableUserEmail );
 980                 $template->set( 'canreset', $wgAuth->allowPasswordChange() );
 981                 $template->set( 'resetlink', $resetLink );
 982                 $template->set( 'canremember', ( $wgCookieExpiration > 0 ) );
 983                 $template->set( 'usereason', $wgUser->isLoggedIn() );
 984                 $template->set( 'remember', $wgUser->getOption( 'rememberpassword' ) || $this->mRemember );
 985                 $template->set( 'cansecurelogin', ( $wgSecureLogin === true ) );
 986                 $template->set( 'stickHTTPS', $this->mStickHTTPS );
 987
 988                 if ( $this->mType == 'signup' ) {
 989                         if ( !self::getCreateaccountToken() ) {
 990                                 self::setCreateaccountToken();
 991                         }
 992                         $template->set( 'token', self::getCreateaccountToken() );
 993                 } else {
 994                         if ( !self::getLoginToken() ) {
 995                                 self::setLoginToken();
 996                         }
 997                         $template->set( 'token', self::getLoginToken() );
 998                 }
 999
1000                 # Prepare language selection links as needed
1001                 if( $wgLoginLanguageSelector ) {
1002                         $template->set( 'languages', $this->makeLanguageSelector() );
1003                         if( $this->mLanguage )
1004                                 $template->set( 'uselang', $this->mLanguage );
1005                 }
1006
1007                 // Give authentication and captcha plugins a chance to modify the form
1008                 $wgAuth->modifyUITemplate( $template, $this->mType );
1009                 if ( $this->mType == 'signup' ) {
1010                         wfRunHooks( 'UserCreateForm', array( &$template ) );
1011                 } else {
1012                         wfRunHooks( 'UserLoginForm', array( &$template ) );
1013                 }
1014
1015                 // Changes the title depending on permissions for creating account
1016                 if ( $wgUser->isAllowed( 'createaccount' ) ) {
1017                         $wgOut->setPageTitle( wfMsg( 'userlogin' ) );
1018                 } else {
1019                         $wgOut->setPageTitle( wfMsg( 'userloginnocreate' ) );
1020                 }
1021
1022                 $wgOut->disallowUserJs(); // just in case...
1023                 $wgOut->addTemplate( $template );
1024         }
1025
1026         /**
1027          * @private
1028          *
1029          * @param $user User
1030          *
1031          * @return Boolean
1032          */
1033         function showCreateOrLoginLink( &$user ) {
1034                 if( $this->mType == 'signup' ) {
1035                         return true;
1036                 } elseif( $user->isAllowed( 'createaccount' ) ) {
1037                         return true;
1038                 } else {
1039                         return false;
1040                 }
1041         }
1042
1043         /**
1044          * Check if a session cookie is present.
1045          *
1046          * This will not pick up a cookie set during _this_ request, but is meant
1047          * to ensure that the client is returning the cookie which was set on a
1048          * previous pass through the system.
1049          *
1050          * @private
1051          */
1052         function hasSessionCookie() {
1053                 global $wgDisableCookieCheck, $wgRequest;
1054                 return $wgDisableCookieCheck ? true : $wgRequest->checkSessionCookie();
1055         }
1056
1057         /**
1058          * Get the login token from the current session
1059          */
1060         public static function getLoginToken() {
1061                 global $wgRequest;
1062                 return $wgRequest->getSessionData( 'wsLoginToken' );
1063         }
1064
1065         /**
1066          * Randomly generate a new login token and attach it to the current session
1067          */
1068         public static function setLoginToken() {
1069                 global $wgRequest;
1070                 // Use User::generateToken() instead of $user->editToken()
1071                 // because the latter reuses $_SESSION['wsEditToken']
1072                 $wgRequest->setSessionData( 'wsLoginToken', User::generateToken() );
1073         }
1074
1075         /**
1076          * Remove any login token attached to the current session
1077          */
1078         public static function clearLoginToken() {
1079                 global $wgRequest;
1080                 $wgRequest->setSessionData( 'wsLoginToken', null );
1081         }
1082
1083         /**
1084          * Get the createaccount token from the current session
1085          */
1086         public static function getCreateaccountToken() {
1087                 global $wgRequest;
1088                 return $wgRequest->getSessionData( 'wsCreateaccountToken' );
1089         }
1090
1091         /**
1092          * Randomly generate a new createaccount token and attach it to the current session
1093          */
1094         public static function setCreateaccountToken() {
1095                 global $wgRequest;
1096                 $wgRequest->setSessionData( 'wsCreateaccountToken', User::generateToken() );
1097         }
1098
1099         /**
1100          * Remove any createaccount token attached to the current session
1101          */
1102         public static function clearCreateaccountToken() {
1103                 global $wgRequest;
1104                 $wgRequest->setSessionData( 'wsCreateaccountToken', null );
1105         }
1106
1107         /**
1108          * @private
1109          */
1110         function cookieRedirectCheck( $type ) {
1111                 global $wgOut;
1112
1113                 $titleObj = SpecialPage::getTitleFor( 'Userlogin' );
1114                 $query = array( 'wpCookieCheck' => $type );
1115                 if ( $this->mReturnTo ) {
1116                         $query['returnto'] = $this->mReturnTo;
1117                 }
1118                 $check = $titleObj->getFullURL( $query );
1119
1120                 return $wgOut->redirect( $check );
1121         }
1122
1123         /**
1124          * @private
1125          */
1126         function onCookieRedirectCheck( $type ) {
1127                 if ( !$this->hasSessionCookie() ) {
1128                         if ( $type == 'new' ) {
1129                                 return $this->mainLoginForm( wfMsgExt( 'nocookiesnew', array( 'parseinline' ) ) );
1130                         } elseif ( $type == 'login' ) {
1131                                 return $this->mainLoginForm( wfMsgExt( 'nocookieslogin', array( 'parseinline' ) ) );
1132                         } else {
1133                                 # shouldn't happen
1134                                 return $this->mainLoginForm( wfMsg( 'error' ) );
1135                         }
1136                 } else {
1137                         return $this->successfulLogin();
1138                 }
1139         }
1140
1141         /**
1142          * @private
1143          */
1144         function throttleHit( $limit ) {
1145                 $this->mainLoginForm( wfMsgExt( 'acct_creation_throttle_hit', array( 'parseinline' ), $limit ) );
1146         }
1147
1148         /**
1149          * Produce a bar of links which allow the user to select another language
1150          * during login/registration but retain "returnto"
1151          *
1152          * @return string
1153          */
1154         function makeLanguageSelector() {
1155                 global $wgLang;
1156
1157                 $msg = wfMessage( 'loginlanguagelinks' )->inContentLanguage();
1158                 if( !$msg->isBlank() ) {
1159                         $langs = explode( "\n", $msg->text() );
1160                         $links = array();
1161                         foreach( $langs as $lang ) {
1162                                 $lang = trim( $lang, '* ' );
1163                                 $parts = explode( '|', $lang );
1164                                 if ( count( $parts ) >= 2 ) {
1165                                         $links[] = $this->makeLanguageSelectorLink( $parts[0], trim( $parts[1] ) );
1166                                 }
1167                         }
1168                         return count( $links ) > 0 ? wfMsgHtml( 'loginlanguagelabel', $wgLang->pipeList( $links ) ) : '';
1169                 } else {
1170                         return '';
1171                 }
1172         }
1173
1174         /**
1175          * Create a language selector link for a particular language
1176          * Links back to this page preserving type and returnto
1177          *
1178          * @param $text Link text
1179          * @param $lang Language code
1180          */
1181         function makeLanguageSelectorLink( $text, $lang ) {
1182                 $self = SpecialPage::getTitleFor( 'Userlogin' );
1183                 $attr = array( 'uselang' => $lang );
1184                 if( $this->mType == 'signup' ) {
1185                         $attr['type'] = 'signup';
1186                 }
1187                 if( $this->mReturnTo ) {
1188                         $attr['returnto'] = $this->mReturnTo;
1189                 }
1190                 return Linker::linkKnown(
1191                         $self,
1192                         htmlspecialchars( $text ),
1193                         array(),
1194                         $attr
1195                 );
1196         }
1197 }