3 * Implements Special:UserLogin
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.
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.
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
21 * @ingroup SpecialPage
25 * Implements Special:UserLogin
27 * @ingroup SpecialPage
29 class LoginForm
extends SpecialPage
{
33 const WRONG_PLUGIN_PASS
= 3;
39 const CREATE_BLOCKED
= 9;
41 const USER_BLOCKED
= 11;
42 const NEED_TOKEN
= 12;
43 const WRONG_TOKEN
= 13;
45 public $mAbortLoginErrorMsg = null;
51 protected $mCookieCheck;
54 protected $mCreateaccount;
55 protected $mCreateaccountMail;
56 protected $mLoginattempt;
61 protected $mSkipCookieCheck;
62 protected $mReturnToQuery;
64 protected $mStickHTTPS;
69 private $mTempPasswordUsed;
70 private $mLoaded = false;
71 private $mSecureLoginUrl;
73 /** @var WebRequest */
74 private $mOverrideRequest = null;
76 /** @var WebRequest Effective request; set at the beginning of load */
77 private $mRequest = null;
80 * @param WebRequest $request
82 public function __construct( $request = null ) {
83 parent
::__construct( 'Userlogin' );
85 $this->mOverrideRequest
= $request;
92 global $wgAuth, $wgHiddenPrefs, $wgEnableEmail;
94 if ( $this->mLoaded
) {
97 $this->mLoaded
= true;
99 if ( $this->mOverrideRequest
=== null ) {
100 $request = $this->getRequest();
102 $request = $this->mOverrideRequest
;
104 $this->mRequest
= $request;
106 $this->mType
= $request->getText( 'type' );
107 $this->mUsername
= $request->getText( 'wpName' );
108 $this->mPassword
= $request->getText( 'wpPassword' );
109 $this->mRetype
= $request->getText( 'wpRetype' );
110 $this->mDomain
= $request->getText( 'wpDomain' );
111 $this->mReason
= $request->getText( 'wpReason' );
112 $this->mCookieCheck
= $request->getVal( 'wpCookieCheck' );
113 $this->mPosted
= $request->wasPosted();
114 $this->mCreateaccountMail
= $request->getCheck( 'wpCreateaccountMail' )
116 $this->mCreateaccount
= $request->getCheck( 'wpCreateaccount' ) && !$this->mCreateaccountMail
;
117 $this->mLoginattempt
= $request->getCheck( 'wpLoginattempt' );
118 $this->mAction
= $request->getVal( 'action' );
119 $this->mRemember
= $request->getCheck( 'wpRemember' );
120 $this->mFromHTTP
= $request->getBool( 'fromhttp', false );
121 $this->mStickHTTPS
= ( !$this->mFromHTTP
&& $request->getProtocol() === 'https' )
122 ||
$request->getBool( 'wpForceHttps', false );
123 $this->mLanguage
= $request->getText( 'uselang' );
124 $this->mSkipCookieCheck
= $request->getCheck( 'wpSkipCookieCheck' );
125 $this->mToken
= $this->mType
== 'signup'
126 ?
$request->getVal( 'wpCreateaccountToken' )
127 : $request->getVal( 'wpLoginToken' );
128 $this->mReturnTo
= $request->getVal( 'returnto', '' );
129 $this->mReturnToQuery
= $request->getVal( 'returntoquery', '' );
131 if ( $wgEnableEmail ) {
132 $this->mEmail
= $request->getText( 'wpEmail' );
136 if ( !in_array( 'realname', $wgHiddenPrefs ) ) {
137 $this->mRealName
= $request->getText( 'wpRealName' );
139 $this->mRealName
= '';
142 if ( !$wgAuth->validDomain( $this->mDomain
) ) {
143 $this->mDomain
= $wgAuth->getDomain();
145 $wgAuth->setDomain( $this->mDomain
);
147 # 1. When switching accounts, it sucks to get automatically logged out
148 # 2. Do not return to PasswordReset after a successful password change
149 # but goto Wiki start page (Main_Page) instead ( bug 33997 )
150 $returnToTitle = Title
::newFromText( $this->mReturnTo
);
151 if ( is_object( $returnToTitle )
152 && ( $returnToTitle->isSpecial( 'Userlogout' )
153 ||
$returnToTitle->isSpecial( 'PasswordReset' ) )
155 $this->mReturnTo
= '';
156 $this->mReturnToQuery
= '';
160 function getDescription() {
161 if ( $this->mType
=== 'signup' ) {
162 return $this->msg( 'createaccount' )->text();
164 return $this->msg( 'login' )->text();
169 * @param $subPage string|null
171 public function execute( $subPage ) {
172 if ( session_id() == '' ) {
178 // Check for [[Special:Userlogin/signup]]. This affects form display and
180 if ( $subPage == 'signup' ) {
181 $this->mType
= 'signup';
185 // If logging in and not on HTTPS, either redirect to it or offer a link.
186 global $wgSecureLogin;
187 if ( $this->mRequest
->getProtocol() !== 'https' ) {
188 $title = $this->getFullTitle();
190 'returnto' => $this->mReturnTo
!== '' ?
$this->mReturnTo
: null,
191 'returntoquery' => $this->mReturnToQuery
!== '' ?
192 $this->mReturnToQuery
: null,
194 ) +
$this->mRequest
->getQueryValues();
195 $url = $title->getFullURL( $query, false, PROTO_HTTPS
);
196 if ( $wgSecureLogin && wfCanIPUseHTTPS( $this->getRequest()->getIP() ) ) {
197 $url = wfAppendQuery( $url, 'fromhttp=1' );
198 $this->getOutput()->redirect( $url );
199 // Since we only do this redir to change proto, always vary
200 $this->getOutput()->addVaryHeader( 'X-Forwarded-Proto' );
204 // A wiki without HTTPS login support should set $wgServer to
205 // http://somehost, in which case the secure URL generated
206 // above won't actually start with https://
207 if ( substr( $url, 0, 8 ) === 'https://' ) {
208 $this->mSecureLoginUrl
= $url;
213 if ( !is_null( $this->mCookieCheck
) ) {
214 $this->onCookieRedirectCheck( $this->mCookieCheck
);
217 } elseif ( $this->mPosted
) {
218 if ( $this->mCreateaccount
) {
219 $this->addNewAccount();
222 } elseif ( $this->mCreateaccountMail
) {
223 $this->addNewAccountMailPassword();
226 } elseif ( ( 'submitlogin' == $this->mAction
) ||
$this->mLoginattempt
) {
227 $this->processLogin();
232 $this->mainLoginForm( '' );
238 function addNewAccountMailPassword() {
239 if ( $this->mEmail
== '' ) {
240 $this->mainLoginForm( $this->msg( 'noemailcreate' )->escaped() );
245 $status = $this->addNewAccountInternal();
246 if ( !$status->isGood() ) {
247 $error = $status->getMessage();
248 $this->mainLoginForm( $error->toString() );
253 $u = $status->getValue();
255 // Wipe the initial password and mail a temporary one
256 $u->setPassword( null );
258 $result = $this->mailPasswordInternal( $u, false, 'createaccount-title', 'createaccount-text' );
260 wfRunHooks( 'AddNewAccount', array( $u, true ) );
261 $u->addNewUserLogEntry( 'byemail', $this->mReason
);
263 $out = $this->getOutput();
264 $out->setPageTitle( $this->msg( 'accmailtitle' ) );
266 if ( !$result->isGood() ) {
267 $this->mainLoginForm( $this->msg( 'mailerror', $result->getWikiText() )->text() );
269 $out->addWikiMsg( 'accmailtext', $u->getName(), $u->getEmail() );
270 $this->executeReturnTo( 'success' );
278 function addNewAccount() {
279 global $wgContLang, $wgUser, $wgEmailAuthentication, $wgLoginLanguageSelector;
281 # Create the account and abort if there's a problem doing so
282 $status = $this->addNewAccountInternal();
283 if ( !$status->isGood() ) {
284 $error = $status->getMessage();
285 $this->mainLoginForm( $error->toString() );
290 $u = $status->getValue();
292 # Only save preferences if the user is not creating an account for someone else.
293 if ( $this->getUser()->isAnon() ) {
294 # If we showed up language selection links, and one was in use, be
295 # smart (and sensible) and save that language as the user's preference
296 if ( $wgLoginLanguageSelector && $this->mLanguage
) {
297 $u->setOption( 'language', $this->mLanguage
);
300 # Otherwise the user's language preference defaults to $wgContLang,
301 # but it may be better to set it to their preferred $wgContLang variant,
302 # based on browser preferences or URL parameters.
303 $u->setOption( 'language', $wgContLang->getPreferredVariant() );
305 if ( $wgContLang->hasVariants() ) {
306 $u->setOption( 'variant', $wgContLang->getPreferredVariant() );
310 $out = $this->getOutput();
312 # Send out an email authentication message if needed
313 if ( $wgEmailAuthentication && Sanitizer
::validateEmail( $u->getEmail() ) ) {
314 $status = $u->sendConfirmationMail();
315 if ( $status->isGood() ) {
316 $out->addWikiMsg( 'confirmemail_oncreate' );
318 $out->addWikiText( $status->getWikiText( 'confirmemail_sendfailed' ) );
322 # Save settings (including confirmation token)
325 # If not logged in, assume the new account as the current one and set
326 # session cookies then show a "welcome" message or a "need cookies"
328 if ( $this->getUser()->isAnon() ) {
331 // This should set it for OutputPage and the Skin
332 // which is needed or the personal links will be
334 $this->getContext()->setUser( $u );
335 wfRunHooks( 'AddNewAccount', array( $u, false ) );
336 $u->addNewUserLogEntry( 'create' );
337 if ( $this->hasSessionCookie() ) {
338 $this->successfulCreation();
340 $this->cookieRedirectCheck( 'new' );
343 # Confirm that the account was created
344 $out->setPageTitle( $this->msg( 'accountcreated' ) );
345 $out->addWikiMsg( 'accountcreatedtext', $u->getName() );
346 $out->addReturnTo( $this->getPageTitle() );
347 wfRunHooks( 'AddNewAccount', array( $u, false ) );
348 $u->addNewUserLogEntry( 'create2', $this->mReason
);
355 * Make a new user account using the loaded data.
357 * @throws PermissionsError|ReadOnlyError
360 public function addNewAccountInternal() {
361 global $wgAuth, $wgMemc, $wgAccountCreationThrottle,
362 $wgMinimalPasswordLength, $wgEmailConfirmToEdit;
364 // If the user passes an invalid domain, something is fishy
365 if ( !$wgAuth->validDomain( $this->mDomain
) ) {
366 return Status
::newFatal( 'wrongpassword' );
369 // If we are not allowing users to login locally, we should be checking
370 // to see if the user is actually able to authenticate to the authenti-
371 // cation server before they create an account (otherwise, they can
372 // create a local account and login as any domain user). We only need
373 // to check this for domains that aren't local.
374 if ( 'local' != $this->mDomain
&& $this->mDomain
!= '' ) {
376 !$wgAuth->canCreateAccounts() &&
378 !$wgAuth->userExists( $this->mUsername
) ||
379 !$wgAuth->authenticate( $this->mUsername
, $this->mPassword
)
382 return Status
::newFatal( 'wrongpassword' );
386 if ( wfReadOnly() ) {
387 throw new ReadOnlyError
;
390 # Request forgery checks.
391 if ( !self
::getCreateaccountToken() ) {
392 self
::setCreateaccountToken();
394 return Status
::newFatal( 'nocookiesfornew' );
397 # The user didn't pass a createaccount token
398 if ( !$this->mToken
) {
399 return Status
::newFatal( 'sessionfailure' );
402 # Validate the createaccount token
403 if ( $this->mToken
!== self
::getCreateaccountToken() ) {
404 return Status
::newFatal( 'sessionfailure' );
408 $currentUser = $this->getUser();
409 $creationBlock = $currentUser->isBlockedFromCreateAccount();
410 if ( !$currentUser->isAllowed( 'createaccount' ) ) {
411 throw new PermissionsError( 'createaccount' );
412 } elseif ( $creationBlock instanceof Block
) {
413 // Throws an ErrorPageError.
414 $this->userBlockedMessage( $creationBlock );
416 // This should never be reached.
420 # Include checks that will include GlobalBlocking (Bug 38333)
421 $permErrors = $this->getPageTitle()->getUserPermissionsErrors(
427 if ( count( $permErrors ) ) {
428 throw new PermissionsError( 'createaccount', $permErrors );
431 $ip = $this->getRequest()->getIP();
432 if ( $currentUser->isDnsBlacklisted( $ip, true /* check $wgProxyWhitelist */ ) ) {
433 return Status
::newFatal( 'sorbs_create_account_reason' );
436 // Normalize the name so that silly things don't cause "invalid username"
437 // errors. User::newFromName does some rather strict checking, rejecting
438 // e.g. leading/trailing/multiple spaces.
439 $title = Title
::makeTitleSafe( NS_USER
, $this->mUsername
);
440 if ( !is_object( $title ) ) {
441 return Status
::newFatal( 'noname' );
444 # Now create a dummy user ($u) and check if it is valid
445 $u = User
::newFromName( $title->getText(), 'creatable' );
446 if ( !is_object( $u ) ) {
447 return Status
::newFatal( 'noname' );
448 } elseif ( 0 != $u->idForName() ) {
449 return Status
::newFatal( 'userexists' );
452 if ( $this->mCreateaccountMail
) {
453 # do not force a password for account creation by email
454 # set invalid password, it will be replaced later by a random generated password
455 $this->mPassword
= null;
457 if ( $this->mPassword
!== $this->mRetype
) {
458 return Status
::newFatal( 'badretype' );
461 # check for minimal password length
462 $valid = $u->getPasswordValidity( $this->mPassword
);
463 if ( $valid !== true ) {
464 if ( !is_array( $valid ) ) {
465 $valid = array( $valid, $wgMinimalPasswordLength );
468 return call_user_func_array( 'Status::newFatal', $valid );
472 # if you need a confirmed email address to edit, then obviously you
473 # need an email address.
474 if ( $wgEmailConfirmToEdit && strval( $this->mEmail
) === '' ) {
475 return Status
::newFatal( 'noemailtitle' );
478 if ( strval( $this->mEmail
) !== '' && !Sanitizer
::validateEmail( $this->mEmail
) ) {
479 return Status
::newFatal( 'invalidemailaddress' );
482 # Set some additional data so the AbortNewAccount hook can be used for
483 # more than just username validation
484 $u->setEmail( $this->mEmail
);
485 $u->setRealName( $this->mRealName
);
489 if ( !wfRunHooks( 'AbortNewAccount', array( $u, &$abortError, &$abortStatus ) ) ) {
490 // Hook point to add extra creation throttles and blocks
491 wfDebug( "LoginForm::addNewAccountInternal: a hook blocked creation\n" );
492 if ( $abortStatus === null ) {
493 // Report back the old string as a raw message status.
494 // This will report the error back as 'createaccount-hook-aborted'
495 // with the given string as the message.
496 // To return a different error code, return a Status object.
497 $abortError = new Message( 'createaccount-hook-aborted', array( $abortError ) );
500 return Status
::newFatal( $abortError );
502 // For MediaWiki 1.23+ and updated hooks, return the Status object
503 // returned from the hook.
508 // Hook point to check for exempt from account creation throttle
509 if ( !wfRunHooks( 'ExemptFromAccountCreationThrottle', array( $ip ) ) ) {
510 wfDebug( "LoginForm::exemptFromAccountCreationThrottle: a hook " .
511 "allowed account creation w/o throttle\n" );
513 if ( ( $wgAccountCreationThrottle && $currentUser->isPingLimitable() ) ) {
514 $key = wfMemcKey( 'acctcreate', 'ip', $ip );
515 $value = $wgMemc->get( $key );
517 $wgMemc->set( $key, 0, 86400 );
519 if ( $value >= $wgAccountCreationThrottle ) {
520 return Status
::newFatal( 'acct_creation_throttle_hit', $wgAccountCreationThrottle );
522 $wgMemc->incr( $key );
526 if ( !$wgAuth->addUser( $u, $this->mPassword
, $this->mEmail
, $this->mRealName
) ) {
527 return Status
::newFatal( 'externaldberror' );
530 self
::clearCreateaccountToken();
532 return $this->initUser( $u, false );
536 * Actually add a user to the database.
537 * Give it a User object that has been initialised with a name.
539 * @param $u User object.
540 * @param $autocreate boolean -- true if this is an autocreation via auth plugin
541 * @return Status object, with the User object in the value member on success
544 function initUser( $u, $autocreate ) {
547 $status = $u->addToDatabase();
548 if ( !$status->isOK() ) {
552 if ( $wgAuth->allowPasswordChange() ) {
553 $u->setPassword( $this->mPassword
);
556 $u->setEmail( $this->mEmail
);
557 $u->setRealName( $this->mRealName
);
560 $wgAuth->initUser( $u, $autocreate );
562 $u->setOption( 'rememberpassword', $this->mRemember ?
1 : 0 );
566 DeferredUpdates
::addUpdate( new SiteStatsUpdate( 0, 0, 0, 0, 1 ) );
568 // Watch user's userpage and talk page
569 $u->addWatch( $u->getUserPage(), WatchedItem
::IGNORE_USER_RIGHTS
);
571 return Status
::newGood( $u );
575 * Internally authenticate the login request.
577 * This may create a local account as a side effect if the
578 * authentication plugin allows transparent local account
582 public function authenticateUserData() {
583 global $wgUser, $wgAuth;
587 if ( $this->mUsername
== '' ) {
588 return self
::NO_NAME
;
591 // We require a login token to prevent login CSRF
592 // Handle part of this before incrementing the throttle so
593 // token-less login attempts don't count towards the throttle
594 // but wrong-token attempts do.
596 // If the user doesn't have a login token yet, set one.
597 if ( !self
::getLoginToken() ) {
598 self
::setLoginToken();
600 return self
::NEED_TOKEN
;
602 // If the user didn't pass a login token, tell them we need one
603 if ( !$this->mToken
) {
604 return self
::NEED_TOKEN
;
607 $throttleCount = self
::incLoginThrottle( $this->mUsername
);
608 if ( $throttleCount === true ) {
609 return self
::THROTTLED
;
612 // Validate the login token
613 if ( $this->mToken
!== self
::getLoginToken() ) {
614 return self
::WRONG_TOKEN
;
617 // Load the current user now, and check to see if we're logging in as
618 // the same name. This is necessary because loading the current user
619 // (say by calling getName()) calls the UserLoadFromSession hook, which
620 // potentially creates the user in the database. Until we load $wgUser,
621 // checking for user existence using User::newFromName($name)->getId() below
622 // will effectively be using stale data.
623 if ( $this->getUser()->getName() === $this->mUsername
) {
624 wfDebug( __METHOD__
. ": already logged in as {$this->mUsername}\n" );
626 return self
::SUCCESS
;
629 $u = User
::newFromName( $this->mUsername
);
630 if ( !( $u instanceof User
) ||
!User
::isUsableName( $u->getName() ) ) {
631 return self
::ILLEGAL
;
634 $isAutoCreated = false;
635 if ( $u->getID() == 0 ) {
636 $status = $this->attemptAutoCreate( $u );
637 if ( $status !== self
::SUCCESS
) {
640 $isAutoCreated = true;
646 // Give general extensions, such as a captcha, a chance to abort logins
647 $abort = self
::ABORTED
;
649 if ( !wfRunHooks( 'AbortLogin', array( $u, $this->mPassword
, &$abort, &$msg ) ) ) {
650 $this->mAbortLoginErrorMsg
= $msg;
655 global $wgBlockDisablesLogin;
656 if ( !$u->checkPassword( $this->mPassword
) ) {
657 if ( $u->checkTemporaryPassword( $this->mPassword
) ) {
658 // The e-mailed temporary password should not be used for actu-
659 // al logins; that's a very sloppy habit, and insecure if an
660 // attacker has a few seconds to click "search" on someone's o-
663 // Allow it to be used only to reset the password a single time
664 // to a new value, which won't be in the user's e-mail ar-
667 // For backwards compatibility, we'll still recognize it at the
668 // login form to minimize surprises for people who have been
669 // logging in with a temporary password for some time.
671 // As a side-effect, we can authenticate the user's e-mail ad-
672 // dress if it's not already done, since the temporary password
673 // was sent via e-mail.
674 if ( !$u->isEmailConfirmed() ) {
679 // At this point we just return an appropriate code/ indicating
680 // that the UI should show a password reset form; bot inter-
681 // faces etc will probably just fail cleanly here.
682 $this->mAbortLoginErrorMsg
= 'resetpass-temp-emailed';
683 $this->mTempPasswordUsed
= true;
684 $retval = self
::RESET_PASS
;
686 $retval = ( $this->mPassword
== '' ) ? self
::EMPTY_PASS
: self
::WRONG_PASS
;
688 } elseif ( $wgBlockDisablesLogin && $u->isBlocked() ) {
689 // If we've enabled it, make it so that a blocked user cannot login
690 $retval = self
::USER_BLOCKED
;
691 } elseif ( $u->getPasswordExpired() == 'hard' ) {
692 // Force reset now, without logging in
693 $retval = self
::RESET_PASS
;
694 $this->mAbortLoginErrorMsg
= 'resetpass-expired';
696 $wgAuth->updateUser( $u );
698 // This should set it for OutputPage and the Skin
699 // which is needed or the personal links will be
701 $this->getContext()->setUser( $u );
703 // Please reset throttle for successful logins, thanks!
704 if ( $throttleCount ) {
705 self
::clearLoginThrottle( $this->mUsername
);
708 if ( $isAutoCreated ) {
709 // Must be run after $wgUser is set, for correct new user log
710 wfRunHooks( 'AuthPluginAutoCreate', array( $u ) );
713 $retval = self
::SUCCESS
;
715 wfRunHooks( 'LoginAuthenticateAudit', array( $u, $this->mPassword
, $retval ) );
721 * Increment the login attempt throttle hit count for the (username,current IP)
722 * tuple unless the throttle was already reached.
723 * @param string $username The user name
724 * @return Bool|Integer The integer hit count or True if it is already at the limit
726 public static function incLoginThrottle( $username ) {
727 global $wgPasswordAttemptThrottle, $wgMemc, $wgRequest;
728 $username = trim( $username ); // sanity
731 if ( is_array( $wgPasswordAttemptThrottle ) ) {
732 $throttleKey = wfMemcKey( 'password-throttle', $wgRequest->getIP(), md5( $username ) );
733 $count = $wgPasswordAttemptThrottle['count'];
734 $period = $wgPasswordAttemptThrottle['seconds'];
736 $throttleCount = $wgMemc->get( $throttleKey );
737 if ( !$throttleCount ) {
738 $wgMemc->add( $throttleKey, 1, $period ); // start counter
739 } elseif ( $throttleCount < $count ) {
740 $wgMemc->incr( $throttleKey );
741 } elseif ( $throttleCount >= $count ) {
746 return $throttleCount;
750 * Clear the login attempt throttle hit count for the (username,current IP) tuple.
751 * @param string $username The user name
754 public static function clearLoginThrottle( $username ) {
755 global $wgMemc, $wgRequest;
756 $username = trim( $username ); // sanity
758 $throttleKey = wfMemcKey( 'password-throttle', $wgRequest->getIP(), md5( $username ) );
759 $wgMemc->delete( $throttleKey );
763 * Attempt to automatically create a user on login. Only succeeds if there
764 * is an external authentication method which allows it.
768 * @return integer Status code
770 function attemptAutoCreate( $user ) {
773 if ( $this->getUser()->isBlockedFromCreateAccount() ) {
774 wfDebug( __METHOD__
. ": user is blocked from account creation\n" );
776 return self
::CREATE_BLOCKED
;
779 if ( !$wgAuth->autoCreate() ) {
780 return self
::NOT_EXISTS
;
783 if ( !$wgAuth->userExists( $user->getName() ) ) {
784 wfDebug( __METHOD__
. ": user does not exist\n" );
786 return self
::NOT_EXISTS
;
789 if ( !$wgAuth->authenticate( $user->getName(), $this->mPassword
) ) {
790 wfDebug( __METHOD__
. ": \$wgAuth->authenticate() returned false, aborting\n" );
792 return self
::WRONG_PLUGIN_PASS
;
796 if ( !wfRunHooks( 'AbortAutoAccount', array( $user, &$abortError ) ) ) {
797 // Hook point to add extra creation throttles and blocks
798 wfDebug( "LoginForm::attemptAutoCreate: a hook blocked creation: $abortError\n" );
799 $this->mAbortLoginErrorMsg
= $abortError;
801 return self
::ABORTED
;
804 wfDebug( __METHOD__
. ": creating account\n" );
805 $status = $this->initUser( $user, true );
807 if ( !$status->isOK() ) {
808 $errors = $status->getErrorsByType( 'error' );
809 $this->mAbortLoginErrorMsg
= $errors[0]['message'];
811 return self
::ABORTED
;
814 return self
::SUCCESS
;
817 function processLogin() {
818 global $wgMemc, $wgLang, $wgSecureLogin, $wgPasswordAttemptThrottle,
819 $wgInvalidPasswordReset;
821 switch ( $this->authenticateUserData() ) {
823 # We've verified now, update the real record
824 $user = $this->getUser();
825 if ( (bool)$this->mRemember
!= $user->getBoolOption( 'rememberpassword' ) ) {
826 $user->setOption( 'rememberpassword', $this->mRemember ?
1 : 0 );
827 $user->saveSettings();
829 $user->invalidateCache();
832 if ( $user->requiresHTTPS() ) {
833 $this->mStickHTTPS
= true;
836 if ( $wgSecureLogin && !$this->mStickHTTPS
) {
837 $user->setCookies( null, false );
841 self
::clearLoginToken();
843 // Reset the throttle
844 $request = $this->getRequest();
845 $key = wfMemcKey( 'password-throttle', $request->getIP(), md5( $this->mUsername
) );
846 $wgMemc->delete( $key );
848 if ( $this->hasSessionCookie() ||
$this->mSkipCookieCheck
) {
849 /* Replace the language object to provide user interface in
850 * correct language immediately on this first page load.
852 $code = $request->getVal( 'uselang', $user->getOption( 'language' ) );
853 $userLang = Language
::factory( $code );
855 $this->getContext()->setLanguage( $userLang );
856 // Reset SessionID on Successful login (bug 40995)
857 $this->renewSessionId();
858 if ( $this->getUser()->getPasswordExpired() == 'soft' ) {
859 $this->resetLoginForm( $this->msg( 'resetpass-expired-soft' ) );
860 } elseif ( $wgInvalidPasswordReset
861 && !$user->isValidPassword( $this->mPassword
)
863 $status = $user->checkPasswordValidity( $this->mPassword
);
864 $this->resetLoginForm(
865 $status->getMessage( 'resetpass-validity-soft' )
868 $this->successfulLogin();
871 $this->cookieRedirectCheck( 'login' );
875 case self
::NEED_TOKEN
:
876 $error = $this->mAbortLoginErrorMsg ?
: 'nocookiesforlogin';
877 $this->mainLoginForm( $this->msg( $error )->parse() );
879 case self
::WRONG_TOKEN
:
880 $error = $this->mAbortLoginErrorMsg ?
: 'sessionfailure';
881 $this->mainLoginForm( $this->msg( $error )->text() );
885 $error = $this->mAbortLoginErrorMsg ?
: 'noname';
886 $this->mainLoginForm( $this->msg( $error )->text() );
888 case self
::WRONG_PLUGIN_PASS
:
889 $error = $this->mAbortLoginErrorMsg ?
: 'wrongpassword';
890 $this->mainLoginForm( $this->msg( $error )->text() );
892 case self
::NOT_EXISTS
:
893 if ( $this->getUser()->isAllowed( 'createaccount' ) ) {
894 $error = $this->mAbortLoginErrorMsg ?
: 'nosuchuser';
895 $this->mainLoginForm( $this->msg( $error,
896 wfEscapeWikiText( $this->mUsername
) )->parse() );
898 $error = $this->mAbortLoginErrorMsg ?
: 'nosuchusershort';
899 $this->mainLoginForm( $this->msg( $error,
900 wfEscapeWikiText( $this->mUsername
) )->text() );
903 case self
::WRONG_PASS
:
904 $error = $this->mAbortLoginErrorMsg ?
: 'wrongpassword';
905 $this->mainLoginForm( $this->msg( $error )->text() );
907 case self
::EMPTY_PASS
:
908 $error = $this->mAbortLoginErrorMsg ?
: 'wrongpasswordempty';
909 $this->mainLoginForm( $this->msg( $error )->text() );
911 case self
::RESET_PASS
:
912 $error = $this->mAbortLoginErrorMsg ?
: 'resetpass_announce';
913 $this->resetLoginForm( $this->msg( $error ) );
915 case self
::CREATE_BLOCKED
:
916 $this->userBlockedMessage( $this->getUser()->isBlockedFromCreateAccount() );
918 case self
::THROTTLED
:
919 $error = $this->mAbortLoginErrorMsg ?
: 'login-throttled';
920 $this->mainLoginForm( $this->msg( $error )
921 ->params( $this->getLanguage()->formatDuration( $wgPasswordAttemptThrottle['seconds'] ) )
925 case self
::USER_BLOCKED
:
926 $error = $this->mAbortLoginErrorMsg ?
: 'login-userblocked';
927 $this->mainLoginForm( $this->msg( $error, $this->mUsername
)->escaped() );
930 $error = $this->mAbortLoginErrorMsg ?
: 'login-abort-generic';
931 $this->mainLoginForm( $this->msg( $error )->text() );
934 throw new MWException( 'Unhandled case value' );
939 * Show the Special:ChangePassword form, with custom message
940 * @param Message $msg
942 protected function resetLoginForm( Message
$msg ) {
943 // Allow hooks to explain this password reset in more detail
944 wfRunHooks( 'LoginPasswordResetMessage', array( &$msg, $this->mUsername
) );
945 $reset = new SpecialChangePassword();
946 $derivative = new DerivativeContext( $this->getContext() );
947 $derivative->setTitle( $reset->getPageTitle() );
948 $reset->setContext( $derivative );
949 if ( !$this->mTempPasswordUsed
) {
950 $reset->setOldPasswordMessage( 'oldpassword' );
952 $reset->setChangeMessage( $msg );
953 $reset->execute( null );
957 * @param $u User object
958 * @param $throttle Boolean
959 * @param string $emailTitle message name of email title
960 * @param string $emailText message name of email text
961 * @return Status object
963 function mailPasswordInternal( $u, $throttle = true, $emailTitle = 'passwordremindertitle',
964 $emailText = 'passwordremindertext'
966 global $wgNewPasswordExpiry;
968 if ( $u->getEmail() == '' ) {
969 return Status
::newFatal( 'noemail', $u->getName() );
971 $ip = $this->getRequest()->getIP();
973 return Status
::newFatal( 'badipaddress' );
976 $currentUser = $this->getUser();
977 wfRunHooks( 'User::mailPasswordInternal', array( &$currentUser, &$ip, &$u ) );
979 $np = $u->randomPassword();
980 $u->setNewpassword( $np, $throttle );
982 $userLanguage = $u->getOption( 'language' );
984 $mainPage = Title
::newMainPage();
985 $mainPageUrl = $mainPage->getCanonicalURL();
987 $m = $this->msg( $emailText, $ip, $u->getName(), $np, '<' . $mainPageUrl . '>',
988 round( $wgNewPasswordExpiry / 86400 ) )->inLanguage( $userLanguage )->text();
989 $result = $u->sendMail( $this->msg( $emailTitle )->inLanguage( $userLanguage )->text(), $m );
995 * Run any hooks registered for logins, then HTTP redirect to
996 * $this->mReturnTo (or Main Page if that's undefined). Formerly we had a
997 * nice message here, but that's really not as useful as just being sent to
998 * wherever you logged in from. It should be clear that the action was
999 * successful, given the lack of error messages plus the appearance of your
1000 * name in the upper right.
1004 function successfulLogin() {
1005 # Run any hooks; display injected HTML if any, else redirect
1006 $currentUser = $this->getUser();
1007 $injected_html = '';
1008 wfRunHooks( 'UserLoginComplete', array( &$currentUser, &$injected_html ) );
1010 if ( $injected_html !== '' ) {
1011 $this->displaySuccessfulAction( $this->msg( 'loginsuccesstitle' ),
1012 'loginsuccess', $injected_html );
1014 $this->executeReturnTo( 'successredirect' );
1019 * Run any hooks registered for logins, then display a message welcoming
1024 function successfulCreation() {
1025 # Run any hooks; display injected HTML
1026 $currentUser = $this->getUser();
1027 $injected_html = '';
1028 $welcome_creation_msg = 'welcomecreation-msg';
1030 wfRunHooks( 'UserLoginComplete', array( &$currentUser, &$injected_html ) );
1033 * Let any extensions change what message is shown.
1034 * @see https://www.mediawiki.org/wiki/Manual:Hooks/BeforeWelcomeCreation
1037 wfRunHooks( 'BeforeWelcomeCreation', array( &$welcome_creation_msg, &$injected_html ) );
1039 $this->displaySuccessfulAction( $this->msg( 'welcomeuser', $this->getUser()->getName() ),
1040 $welcome_creation_msg, $injected_html );
1044 * Display an "successful action" page.
1046 * @param string|Message $title page's title
1047 * @param $msgname string
1048 * @param $injected_html string
1050 private function displaySuccessfulAction( $title, $msgname, $injected_html ) {
1051 $out = $this->getOutput();
1052 $out->setPageTitle( $title );
1054 $out->addWikiMsg( $msgname, wfEscapeWikiText( $this->getUser()->getName() ) );
1057 $out->addHTML( $injected_html );
1059 $this->executeReturnTo( 'success' );
1063 * Output a message that informs the user that they cannot create an account because
1064 * there is a block on them or their IP which prevents account creation. Note that
1065 * User::isBlockedFromCreateAccount(), which gets this block, ignores the 'hardblock'
1066 * setting on blocks (bug 13611).
1067 * @param $block Block the block causing this error
1068 * @throws ErrorPageError
1070 function userBlockedMessage( Block
$block ) {
1071 # Let's be nice about this, it's likely that this feature will be used
1072 # for blocking large numbers of innocent people, e.g. range blocks on
1073 # schools. Don't blame it on the user. There's a small chance that it
1074 # really is the user's fault, i.e. the username is blocked and they
1075 # haven't bothered to log out before trying to create an account to
1076 # evade it, but we'll leave that to their guilty conscience to figure
1078 $errorParams = array(
1079 $block->getTarget(),
1080 $block->mReason ?
$block->mReason
: $this->msg( 'blockednoreason' )->text(),
1084 if ( $block->getType() === Block
::TYPE_RANGE
) {
1085 $errorMessage = 'cantcreateaccount-range-text';
1086 $errorParams[] = $this->getRequest()->getIP();
1088 $errorMessage = 'cantcreateaccount-text';
1091 throw new ErrorPageError(
1092 'cantcreateaccounttitle',
1099 * Add a "return to" link or redirect to it.
1100 * Extensions can use this to reuse the "return to" logic after
1101 * inject steps (such as redirection) into the login process.
1103 * @param $type string, one of the following:
1104 * - error: display a return to link ignoring $wgRedirectOnLogin
1105 * - success: display a return to link using $wgRedirectOnLogin if needed
1106 * - successredirect: send an HTTP redirect using $wgRedirectOnLogin if needed
1107 * @param string $returnTo
1108 * @param array|string $returnToQuery
1109 * @param bool $stickHTTPs Keep redirect link on HTTPs
1112 public function showReturnToPage(
1113 $type, $returnTo = '', $returnToQuery = '', $stickHTTPs = false
1115 $this->mReturnTo
= $returnTo;
1116 $this->mReturnToQuery
= $returnToQuery;
1117 $this->mStickHTTPS
= $stickHTTPs;
1118 $this->executeReturnTo( $type );
1122 * Add a "return to" link or redirect to it.
1124 * @param $type string, one of the following:
1125 * - error: display a return to link ignoring $wgRedirectOnLogin
1126 * - success: display a return to link using $wgRedirectOnLogin if needed
1127 * - successredirect: send an HTTP redirect using $wgRedirectOnLogin if needed
1129 private function executeReturnTo( $type ) {
1130 global $wgRedirectOnLogin, $wgSecureLogin;
1132 if ( $type != 'error' && $wgRedirectOnLogin !== null ) {
1133 $returnTo = $wgRedirectOnLogin;
1134 $returnToQuery = array();
1136 $returnTo = $this->mReturnTo
;
1137 $returnToQuery = wfCgiToArray( $this->mReturnToQuery
);
1140 $returnToTitle = Title
::newFromText( $returnTo );
1141 if ( !$returnToTitle ) {
1142 $returnToTitle = Title
::newMainPage();
1145 if ( $wgSecureLogin && !$this->mStickHTTPS
) {
1146 $options = array( 'http' );
1147 $proto = PROTO_HTTP
;
1148 } elseif ( $wgSecureLogin ) {
1149 $options = array( 'https' );
1150 $proto = PROTO_HTTPS
;
1153 $proto = PROTO_RELATIVE
;
1156 if ( $type == 'successredirect' ) {
1157 $redirectUrl = $returnToTitle->getFullURL( $returnToQuery, false, $proto );
1158 $this->getOutput()->redirect( $redirectUrl );
1160 $this->getOutput()->addReturnTo( $returnToTitle, $returnToQuery, null, $options );
1167 function mainLoginForm( $msg, $msgtype = 'error' ) {
1168 global $wgEnableEmail, $wgEnableUserEmail;
1169 global $wgHiddenPrefs, $wgLoginLanguageSelector;
1170 global $wgAuth, $wgEmailConfirmToEdit, $wgCookieExpiration;
1171 global $wgSecureLogin, $wgPasswordResetRoutes;
1173 $titleObj = $this->getPageTitle();
1174 $user = $this->getUser();
1175 $out = $this->getOutput();
1177 if ( $this->mType
== 'signup' ) {
1178 // Block signup here if in readonly. Keeps user from
1179 // going through the process (filling out data, etc)
1180 // and being informed later.
1181 $permErrors = $titleObj->getUserPermissionsErrors( 'createaccount', $user, true );
1182 if ( count( $permErrors ) ) {
1183 throw new PermissionsError( 'createaccount', $permErrors );
1184 } elseif ( $user->isBlockedFromCreateAccount() ) {
1185 $this->userBlockedMessage( $user->isBlockedFromCreateAccount() );
1188 } elseif ( wfReadOnly() ) {
1189 throw new ReadOnlyError
;
1193 // Pre-fill username (if not creating an account, bug 44775).
1194 if ( $this->mUsername
== '' && $this->mType
!= 'signup' ) {
1195 if ( $user->isLoggedIn() ) {
1196 $this->mUsername
= $user->getName();
1198 $this->mUsername
= $this->getRequest()->getCookie( 'UserName' );
1202 // Generic styles and scripts for both login and signup form
1203 $out->addModuleStyles( array(
1205 'mediawiki.ui.button',
1206 'mediawiki.special.userlogin.common.styles'
1208 $out->addModules( array(
1209 'mediawiki.special.userlogin.common.js'
1212 if ( $this->mType
== 'signup' ) {
1213 // XXX hack pending RL or JS parse() support for complex content messages
1214 // https://bugzilla.wikimedia.org/show_bug.cgi?id=25349
1215 $out->addJsConfigVars( 'wgCreateacctImgcaptchaHelp',
1216 $this->msg( 'createacct-imgcaptcha-help' )->parse() );
1218 // Additional styles and scripts for signup form
1219 $out->addModules( array(
1220 'mediawiki.special.userlogin.signup.js'
1222 $out->addModuleStyles( array(
1223 'mediawiki.special.userlogin.signup.styles'
1226 $template = new UsercreateTemplate();
1228 // Must match number of benefits defined in messages
1229 $template->set( 'benefitCount', 3 );
1231 $q = 'action=submitlogin&type=signup';
1232 $linkq = 'type=login';
1234 // Additional styles for login form
1235 $out->addModuleStyles( array(
1236 'mediawiki.special.userlogin.login.styles'
1239 $template = new UserloginTemplate();
1241 $q = 'action=submitlogin&type=login';
1242 $linkq = 'type=signup';
1245 if ( $this->mReturnTo
!== '' ) {
1246 $returnto = '&returnto=' . wfUrlencode( $this->mReturnTo
);
1247 if ( $this->mReturnToQuery
!== '' ) {
1248 $returnto .= '&returntoquery=' .
1249 wfUrlencode( $this->mReturnToQuery
);
1252 $linkq .= $returnto;
1255 # Don't show a "create account" link if the user can't.
1256 if ( $this->showCreateOrLoginLink( $user ) ) {
1257 # Pass any language selection on to the mode switch link
1258 if ( $wgLoginLanguageSelector && $this->mLanguage
) {
1259 $linkq .= '&uselang=' . $this->mLanguage
;
1261 // Supply URL, login template creates the button.
1262 $template->set( 'createOrLoginHref', $titleObj->getLocalURL( $linkq ) );
1264 $template->set( 'link', '' );
1267 $resetLink = $this->mType
== 'signup'
1269 : is_array( $wgPasswordResetRoutes ) && in_array( true, array_values( $wgPasswordResetRoutes ) );
1271 $template->set( 'header', '' );
1272 $template->set( 'skin', $this->getSkin() );
1273 $template->set( 'name', $this->mUsername
);
1274 $template->set( 'password', $this->mPassword
);
1275 $template->set( 'retype', $this->mRetype
);
1276 $template->set( 'createemailset', $this->mCreateaccountMail
);
1277 $template->set( 'email', $this->mEmail
);
1278 $template->set( 'realname', $this->mRealName
);
1279 $template->set( 'domain', $this->mDomain
);
1280 $template->set( 'reason', $this->mReason
);
1282 $template->set( 'action', $titleObj->getLocalURL( $q ) );
1283 $template->set( 'message', $msg );
1284 $template->set( 'messagetype', $msgtype );
1285 $template->set( 'createemail', $wgEnableEmail && $user->isLoggedIn() );
1286 $template->set( 'userealname', !in_array( 'realname', $wgHiddenPrefs ) );
1287 $template->set( 'useemail', $wgEnableEmail );
1288 $template->set( 'emailrequired', $wgEmailConfirmToEdit );
1289 $template->set( 'emailothers', $wgEnableUserEmail );
1290 $template->set( 'canreset', $wgAuth->allowPasswordChange() );
1291 $template->set( 'resetlink', $resetLink );
1292 $template->set( 'canremember', ( $wgCookieExpiration > 0 ) );
1293 $template->set( 'usereason', $user->isLoggedIn() );
1294 $template->set( 'remember', $user->getOption( 'rememberpassword' ) ||
$this->mRemember
);
1295 $template->set( 'cansecurelogin', ( $wgSecureLogin === true ) );
1296 $template->set( 'stickhttps', (int)$this->mStickHTTPS
);
1297 $template->set( 'loggedin', $user->isLoggedIn() );
1298 $template->set( 'loggedinuser', $user->getName() );
1300 if ( $this->mType
== 'signup' ) {
1301 if ( !self
::getCreateaccountToken() ) {
1302 self
::setCreateaccountToken();
1304 $template->set( 'token', self
::getCreateaccountToken() );
1306 if ( !self
::getLoginToken() ) {
1307 self
::setLoginToken();
1309 $template->set( 'token', self
::getLoginToken() );
1312 # Prepare language selection links as needed
1313 if ( $wgLoginLanguageSelector ) {
1314 $template->set( 'languages', $this->makeLanguageSelector() );
1315 if ( $this->mLanguage
) {
1316 $template->set( 'uselang', $this->mLanguage
);
1320 $template->set( 'secureLoginUrl', $this->mSecureLoginUrl
);
1321 // Use loginend-https for HTTPS requests if it's not blank, loginend otherwise
1322 // Ditto for signupend. New forms use neither.
1323 $usingHTTPS = $this->mRequest
->getProtocol() == 'https';
1324 $loginendHTTPS = $this->msg( 'loginend-https' );
1325 $signupendHTTPS = $this->msg( 'signupend-https' );
1326 if ( $usingHTTPS && !$loginendHTTPS->isBlank() ) {
1327 $template->set( 'loginend', $loginendHTTPS->parse() );
1329 $template->set( 'loginend', $this->msg( 'loginend' )->parse() );
1331 if ( $usingHTTPS && !$signupendHTTPS->isBlank() ) {
1332 $template->set( 'signupend', $signupendHTTPS->parse() );
1334 $template->set( 'signupend', $this->msg( 'signupend' )->parse() );
1337 // Give authentication and captcha plugins a chance to modify the form
1338 $wgAuth->modifyUITemplate( $template, $this->mType
);
1339 if ( $this->mType
== 'signup' ) {
1340 wfRunHooks( 'UserCreateForm', array( &$template ) );
1342 wfRunHooks( 'UserLoginForm', array( &$template ) );
1345 $out->disallowUserJs(); // just in case...
1346 $out->addTemplate( $template );
1350 * Whether the login/create account form should display a link to the
1351 * other form (in addition to whatever the skin provides).
1356 private function showCreateOrLoginLink( &$user ) {
1357 if ( $this->mType
== 'signup' ) {
1359 } elseif ( $user->isAllowed( 'createaccount' ) ) {
1367 * Check if a session cookie is present.
1369 * This will not pick up a cookie set during _this_ request, but is meant
1370 * to ensure that the client is returning the cookie which was set on a
1371 * previous pass through the system.
1376 function hasSessionCookie() {
1377 global $wgDisableCookieCheck;
1379 return $wgDisableCookieCheck ?
true : $this->getRequest()->checkSessionCookie();
1383 * Get the login token from the current session
1386 public static function getLoginToken() {
1389 return $wgRequest->getSessionData( 'wsLoginToken' );
1393 * Randomly generate a new login token and attach it to the current session
1395 public static function setLoginToken() {
1397 // Generate a token directly instead of using $user->getEditToken()
1398 // because the latter reuses $_SESSION['wsEditToken']
1399 $wgRequest->setSessionData( 'wsLoginToken', MWCryptRand
::generateHex( 32 ) );
1403 * Remove any login token attached to the current session
1405 public static function clearLoginToken() {
1407 $wgRequest->setSessionData( 'wsLoginToken', null );
1411 * Get the createaccount token from the current session
1414 public static function getCreateaccountToken() {
1417 return $wgRequest->getSessionData( 'wsCreateaccountToken' );
1421 * Randomly generate a new createaccount token and attach it to the current session
1423 public static function setCreateaccountToken() {
1425 $wgRequest->setSessionData( 'wsCreateaccountToken', MWCryptRand
::generateHex( 32 ) );
1429 * Remove any createaccount token attached to the current session
1431 public static function clearCreateaccountToken() {
1433 $wgRequest->setSessionData( 'wsCreateaccountToken', null );
1437 * Renew the user's session id, using strong entropy
1439 private function renewSessionId() {
1440 global $wgSecureLogin, $wgCookieSecure;
1441 if ( $wgSecureLogin && !$this->mStickHTTPS
) {
1442 $wgCookieSecure = false;
1451 function cookieRedirectCheck( $type ) {
1452 $titleObj = SpecialPage
::getTitleFor( 'Userlogin' );
1453 $query = array( 'wpCookieCheck' => $type );
1454 if ( $this->mReturnTo
!== '' ) {
1455 $query['returnto'] = $this->mReturnTo
;
1456 $query['returntoquery'] = $this->mReturnToQuery
;
1458 $check = $titleObj->getFullURL( $query );
1460 $this->getOutput()->redirect( $check );
1466 function onCookieRedirectCheck( $type ) {
1467 if ( !$this->hasSessionCookie() ) {
1468 if ( $type == 'new' ) {
1469 $this->mainLoginForm( $this->msg( 'nocookiesnew' )->parse() );
1470 } elseif ( $type == 'login' ) {
1471 $this->mainLoginForm( $this->msg( 'nocookieslogin' )->parse() );
1474 $this->mainLoginForm( $this->msg( 'error' )->text() );
1477 $this->successfulLogin();
1482 * Produce a bar of links which allow the user to select another language
1483 * during login/registration but retain "returnto"
1487 function makeLanguageSelector() {
1488 $msg = $this->msg( 'loginlanguagelinks' )->inContentLanguage();
1489 if ( !$msg->isBlank() ) {
1490 $langs = explode( "\n", $msg->text() );
1492 foreach ( $langs as $lang ) {
1493 $lang = trim( $lang, '* ' );
1494 $parts = explode( '|', $lang );
1495 if ( count( $parts ) >= 2 ) {
1496 $links[] = $this->makeLanguageSelectorLink( $parts[0], trim( $parts[1] ) );
1500 return count( $links ) > 0 ?
$this->msg( 'loginlanguagelabel' )->rawParams(
1501 $this->getLanguage()->pipeList( $links ) )->escaped() : '';
1508 * Create a language selector link for a particular language
1509 * Links back to this page preserving type and returnto
1511 * @param string $text Link text
1512 * @param string $lang Language code
1515 function makeLanguageSelectorLink( $text, $lang ) {
1516 if ( $this->getLanguage()->getCode() == $lang ) {
1517 // no link for currently used language
1518 return htmlspecialchars( $text );
1520 $query = array( 'uselang' => $lang );
1521 if ( $this->mType
== 'signup' ) {
1522 $query['type'] = 'signup';
1524 if ( $this->mReturnTo
!== '' ) {
1525 $query['returnto'] = $this->mReturnTo
;
1526 $query['returntoquery'] = $this->mReturnToQuery
;
1530 $targetLanguage = Language
::factory( $lang );
1531 $attr['lang'] = $attr['hreflang'] = $targetLanguage->getHtmlCode();
1533 return Linker
::linkKnown(
1534 $this->getPageTitle(),
1535 htmlspecialchars( $text ),
1541 protected function getGroupName() {