4 * @addtogroup SpecialPage
10 function wfSpecialUserlogin() {
11 global $wgCommandLineMode;
13 if( session_id() == '' ) {
17 $form = new LoginForm( $wgRequest );
22 * implements Special:Login
23 * @addtogroup SpecialPage
30 const WRONG_PLUGIN_PASS
= 3;
37 var $mName, $mPassword, $mRetype, $mReturnTo, $mCookieCheck, $mPosted;
38 var $mAction, $mCreateaccount, $mCreateaccountMail, $mMailmypassword;
39 var $mLoginattempt, $mRemember, $mEmail, $mDomain, $mLanguage;
43 * @param WebRequest $request A WebRequest object passed by reference
45 function LoginForm( &$request ) {
46 global $wgLang, $wgAllowRealName, $wgEnableEmail;
49 $this->mType
= $request->getText( 'type' );
50 $this->mName
= $request->getText( 'wpName' );
51 $this->mPassword
= $request->getText( 'wpPassword' );
52 $this->mRetype
= $request->getText( 'wpRetype' );
53 $this->mDomain
= $request->getText( 'wpDomain' );
54 $this->mReturnTo
= $request->getVal( 'returnto' );
55 $this->mCookieCheck
= $request->getVal( 'wpCookieCheck' );
56 $this->mPosted
= $request->wasPosted();
57 $this->mCreateaccount
= $request->getCheck( 'wpCreateaccount' );
58 $this->mCreateaccountMail
= $request->getCheck( 'wpCreateaccountMail' )
60 $this->mMailmypassword
= $request->getCheck( 'wpMailmypassword' )
62 $this->mLoginattempt
= $request->getCheck( 'wpLoginattempt' );
63 $this->mAction
= $request->getVal( 'action' );
64 $this->mRemember
= $request->getCheck( 'wpRemember' );
65 $this->mLanguage
= $request->getText( 'uselang' );
67 if( $wgEnableEmail ) {
68 $this->mEmail
= $request->getText( 'wpEmail' );
72 if( $wgAllowRealName ) {
73 $this->mRealName
= $request->getText( 'wpRealName' );
75 $this->mRealName
= '';
78 if( !$wgAuth->validDomain( $this->mDomain
) ) {
79 $this->mDomain
= 'invaliddomain';
81 $wgAuth->setDomain( $this->mDomain
);
83 # When switching accounts, it sucks to get automatically logged out
84 if( $this->mReturnTo
== $wgLang->specialPage( 'Userlogout' ) ) {
85 $this->mReturnTo
= '';
90 if ( !is_null( $this->mCookieCheck
) ) {
91 $this->onCookieRedirectCheck( $this->mCookieCheck
);
93 } else if( $this->mPosted
) {
94 if( $this->mCreateaccount
) {
95 return $this->addNewAccount();
96 } else if ( $this->mCreateaccountMail
) {
97 return $this->addNewAccountMailPassword();
98 } else if ( $this->mMailmypassword
) {
99 return $this->mailPassword();
100 } else if ( ( 'submitlogin' == $this->mAction
) ||
$this->mLoginattempt
) {
101 return $this->processLogin();
104 $this->mainLoginForm( '' );
110 function addNewAccountMailPassword() {
113 if ('' == $this->mEmail
) {
114 $this->mainLoginForm( wfMsg( 'noemail', htmlspecialchars( $this->mName
) ) );
118 $u = $this->addNewaccountInternal();
124 // Wipe the initial password and mail a temporary one
125 $u->setPassword( null );
127 $result = $this->mailPasswordInternal( $u, false );
129 wfRunHooks( 'AddNewAccount', array( $u ) );
131 $wgOut->setPageTitle( wfMsg( 'accmailtitle' ) );
132 $wgOut->setRobotpolicy( 'noindex,nofollow' );
133 $wgOut->setArticleRelated( false );
135 if( WikiError
::isError( $result ) ) {
136 $this->mainLoginForm( wfMsg( 'mailerror', $result->getMessage() ) );
138 $wgOut->addWikiText( wfMsg( 'accmailtext', $u->getName(), $u->getEmail() ) );
139 $wgOut->returnToMain( false );
148 function addNewAccount() {
149 global $wgUser, $wgEmailAuthentication;
151 # Create the account and abort if there's a problem doing so
152 $u = $this->addNewAccountInternal();
156 # If we showed up language selection links, and one was in use, be
157 # smart (and sensible) and save that language as the user's preference
158 global $wgLoginLanguageSelector;
159 if( $wgLoginLanguageSelector && $this->mLanguage
)
160 $u->setOption( 'language', $this->mLanguage
);
162 # Save user settings and send out an email authentication message if needed
164 if( $wgEmailAuthentication && User
::isValidEmailAddr( $u->getEmail() ) ) {
166 $error = $u->sendConfirmationMail();
167 if( WikiError
::isError( $error ) ) {
168 $wgOut->addWikiText( wfMsg( 'confirmemail_sendfailed', $error->getMessage() ) );
170 $wgOut->addWikiText( wfMsg( 'confirmemail_oncreate' ) );
174 # If not logged in, assume the new account as the current one and set session cookies
175 # then show a "welcome" message or a "need cookies" message as needed
176 if( $wgUser->isAnon() ) {
178 $wgUser->setCookies();
179 wfRunHooks( 'AddNewAccount', array( $wgUser ) );
180 if( $this->hasSessionCookie() ) {
181 return $this->successfulLogin( wfMsg( 'welcomecreation', $wgUser->getName() ), false );
183 return $this->cookieRedirectCheck( 'new' );
186 # Confirm that the account was created
188 $self = SpecialPage
::getTitleFor( 'Userlogin' );
189 $wgOut->setPageTitle( wfMsgHtml( 'accountcreated' ) );
190 $wgOut->setArticleRelated( false );
191 $wgOut->setRobotPolicy( 'noindex,nofollow' );
192 $wgOut->addHtml( wfMsgWikiHtml( 'accountcreatedtext', $u->getName() ) );
193 $wgOut->returnToMain( $self->getPrefixedText() );
194 wfRunHooks( 'AddNewAccount', array( $u ) );
202 function addNewAccountInternal() {
203 global $wgUser, $wgOut;
204 global $wgEnableSorbs, $wgProxyWhitelist;
205 global $wgMemc, $wgAccountCreationThrottle;
206 global $wgAuth, $wgMinimalPasswordLength;
208 // If the user passes an invalid domain, something is fishy
209 if( !$wgAuth->validDomain( $this->mDomain
) ) {
210 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
214 // If we are not allowing users to login locally, we should
215 // be checking to see if the user is actually able to
216 // authenticate to the authentication server before they
217 // create an account (otherwise, they can create a local account
218 // and login as any domain user). We only need to check this for
219 // domains that aren't local.
220 if( 'local' != $this->mDomain
&& '' != $this->mDomain
) {
221 if( !$wgAuth->canCreateAccounts() && ( !$wgAuth->userExists( $this->mName
) ||
!$wgAuth->authenticate( $this->mName
, $this->mPassword
) ) ) {
222 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
227 if ( wfReadOnly() ) {
228 $wgOut->readOnlyPage();
232 #Â Check anonymous user ($wgUser) limitations :
233 if (!$wgUser->isAllowedToCreateAccount()) {
234 $this->userNotPrivilegedMessage();
239 if ( $wgEnableSorbs && !in_array( $ip, $wgProxyWhitelist ) &&
240 $wgUser->inSorbsBlacklist( $ip ) )
242 $this->mainLoginForm( wfMsg( 'sorbs_create_account_reason' ) . ' (' . htmlspecialchars( $ip ) . ')' );
246 # Now create a dummy user ($u) and check if it is valid
247 $name = trim( $this->mName
);
248 $u = User
::newFromName( $name, 'creatable' );
249 if ( is_null( $u ) ) {
250 $this->mainLoginForm( wfMsg( 'noname' ) );
254 if ( 0 != $u->idForName() ) {
255 $this->mainLoginForm( wfMsg( 'userexists' ) );
259 if ( 0 != strcmp( $this->mPassword
, $this->mRetype
) ) {
260 $this->mainLoginForm( wfMsg( 'badretype' ) );
264 if ( !$u->isValidPassword( $this->mPassword
) ) {
265 $this->mainLoginForm( wfMsg( 'passwordtooshort', $wgMinimalPasswordLength ) );
270 if( !wfRunHooks( 'AbortNewAccount', array( $u, &$abortError ) ) ) {
271 // Hook point to add extra creation throttles and blocks
272 wfDebug( "LoginForm::addNewAccountInternal: a hook blocked creation\n" );
273 $this->mainLoginForm( $abortError );
277 if ( $wgAccountCreationThrottle && $wgUser->isPingLimitable() ) {
278 $key = wfMemcKey( 'acctcreate', 'ip', $ip );
279 $value = $wgMemc->incr( $key );
281 $wgMemc->set( $key, 1, 86400 );
283 if ( $value > $wgAccountCreationThrottle ) {
284 $this->throttleHit( $wgAccountCreationThrottle );
289 if( !$wgAuth->addUser( $u, $this->mPassword
, $this->mEmail
, $this->mRealName
) ) {
290 $this->mainLoginForm( wfMsg( 'externaldberror' ) );
294 return $this->initUser( $u );
298 * Actually add a user to the database.
299 * Give it a User object that has been initialised with a name.
301 * @param $u User object.
302 * @return User object.
305 function initUser( $u ) {
310 if ( $wgAuth->allowPasswordChange() ) {
311 $u->setPassword( $this->mPassword
);
314 $u->setEmail( $this->mEmail
);
315 $u->setRealName( $this->mRealName
);
318 $wgAuth->initUser( $u );
320 $u->setOption( 'rememberpassword', $this->mRemember ?
1 : 0 );
324 $ssUpdate = new SiteStatsUpdate( 0, 0, 0, 0, 1 );
325 $ssUpdate->doUpdate();
331 * Internally authenticate the login request.
333 * This may create a local account as a side effect if the
334 * authentication plugin allows transparent local account
339 function authenticateUserData() {
340 global $wgUser, $wgAuth;
341 if ( '' == $this->mName
) {
342 return self
::NO_NAME
;
344 $u = User
::newFromName( $this->mName
);
345 if( is_null( $u ) ||
!User
::isUsableName( $u->getName() ) ) {
346 return self
::ILLEGAL
;
348 if ( 0 == $u->getID() ) {
351 * If the external authentication plugin allows it,
352 * automatically create a new account for users that
353 * are externally defined but have not yet logged in.
355 if ( $wgAuth->autoCreate() && $wgAuth->userExists( $u->getName() ) ) {
356 if ( $wgAuth->authenticate( $u->getName(), $this->mPassword
) ) {
357 $u = $this->initUser( $u );
359 return self
::WRONG_PLUGIN_PASS
;
362 return self
::NOT_EXISTS
;
368 // Give general extensions, such as a captcha, a chance to abort logins
369 $abort = self
::ABORTED
;
370 if( !wfRunHooks( 'AbortLogin', array( $u, $this->mPassword
, &$abort ) ) ) {
374 if (!$u->checkPassword( $this->mPassword
)) {
375 if( $u->checkTemporaryPassword( $this->mPassword
) ) {
376 // The e-mailed temporary password should not be used
377 // for actual logins; that's a very sloppy habit,
378 // and insecure if an attacker has a few seconds to
379 // click "search" on someone's open mail reader.
381 // Allow it to be used only to reset the password
382 // a single time to a new value, which won't be in
383 // the user's e-mail archives.
385 // For backwards compatibility, we'll still recognize
386 // it at the login form to minimize surprises for
387 // people who have been logging in with a temporary
388 // password for some time.
390 // As a side-effect, we can authenticate the user's
391 // e-mail address if it's not already done, since
392 // the temporary password was sent via e-mail.
394 if( !$u->isEmailConfirmed() ) {
398 // At this point we just return an appropriate code
399 // indicating that the UI should show a password
400 // reset form; bot interfaces etc will probably just
401 // fail cleanly here.
403 $retval = self
::RESET_PASS
;
405 $retval = '' == $this->mPassword ? self
::EMPTY_PASS
: self
::WRONG_PASS
;
408 $wgAuth->updateUser( $u );
411 $retval = self
::SUCCESS
;
413 wfRunHooks( 'LoginAuthenticateAudit', array( $u, $this->mPassword
, $retval ) );
417 function processLogin() {
418 global $wgUser, $wgAuth;
420 switch ($this->authenticateUserData())
423 # We've verified now, update the real record
424 if( (bool)$this->mRemember
!= (bool)$wgUser->getOption( 'rememberpassword' ) ) {
425 $wgUser->setOption( 'rememberpassword', $this->mRemember ?
1 : 0 );
426 $wgUser->saveSettings();
428 $wgUser->invalidateCache();
430 $wgUser->setCookies();
432 if( $this->hasSessionCookie() ) {
433 return $this->successfulLogin( wfMsg( 'loginsuccess', $wgUser->getName() ) );
435 return $this->cookieRedirectCheck( 'login' );
441 $this->mainLoginForm( wfMsg( 'noname' ) );
443 case self
::WRONG_PLUGIN_PASS
:
444 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
446 case self
::NOT_EXISTS
:
447 $this->mainLoginForm( wfMsg( 'nosuchuser', htmlspecialchars( $this->mName
) ) );
449 case self
::WRONG_PASS
:
450 $this->mainLoginForm( wfMsg( 'wrongpassword' ) );
452 case self
::EMPTY_PASS
:
453 $this->mainLoginForm( wfMsg( 'wrongpasswordempty' ) );
455 case self
::RESET_PASS
:
456 $this->resetLoginForm( wfMsg( 'resetpass_announce' ) );
459 wfDebugDieBacktrace( "Unhandled case value" );
463 function resetLoginForm( $error ) {
465 $wgOut->addWikiText( "<div class=\"errorbox\">$error</div>" );
466 $reset = new PasswordResetForm( $this->mName
, $this->mPassword
);
473 function mailPassword() {
474 global $wgUser, $wgOut, $wgAuth;
476 if( !$wgAuth->allowPasswordChange() ) {
477 $this->mainLoginForm( wfMsg( 'resetpass_forbidden' ) );
481 # Check against blocked IPs
482 # fixme -- should we not?
483 if( $wgUser->isBlocked() ) {
484 $this->mainLoginForm( wfMsg( 'blocked-mailpassword' ) );
488 # Check against the rate limiter
489 if( $wgUser->pingLimiter( 'mailpassword' ) ) {
490 $wgOut->rateLimited();
494 if ( '' == $this->mName
) {
495 $this->mainLoginForm( wfMsg( 'noname' ) );
498 $u = User
::newFromName( $this->mName
);
499 if( is_null( $u ) ) {
500 $this->mainLoginForm( wfMsg( 'noname' ) );
503 if ( 0 == $u->getID() ) {
504 $this->mainLoginForm( wfMsg( 'nosuchuser', $u->getName() ) );
508 # Check against password throttle
509 if ( $u->isPasswordReminderThrottled() ) {
510 global $wgPasswordReminderResendTime;
511 # Round the time in hours to 3 d.p., in case someone is specifying minutes or seconds.
512 $this->mainLoginForm( wfMsg( 'throttled-mailpassword',
513 round( $wgPasswordReminderResendTime, 3 ) ) );
517 $result = $this->mailPasswordInternal( $u, true );
518 if( WikiError
::isError( $result ) ) {
519 $this->mainLoginForm( wfMsg( 'mailerror', $result->getMessage() ) );
521 $this->mainLoginForm( wfMsg( 'passwordsent', $u->getName() ), 'success' );
527 * @return mixed true on success, WikiError on failure
530 function mailPasswordInternal( $u, $throttle = true ) {
531 global $wgCookiePath, $wgCookieDomain, $wgCookiePrefix, $wgCookieSecure;
532 global $wgServer, $wgScript;
534 if ( '' == $u->getEmail() ) {
535 return new WikiError( wfMsg( 'noemail', $u->getName() ) );
538 $np = $u->randomPassword();
539 $u->setNewpassword( $np, $throttle );
541 setcookie( "{$wgCookiePrefix}Token", '', time() - 3600, $wgCookiePath, $wgCookieDomain, $wgCookieSecure );
546 if ( '' == $ip ) { $ip = '(Unknown)'; }
548 $m = wfMsg( 'passwordremindertext', $ip, $u->getName(), $np, $wgServer . $wgScript );
550 $result = $u->sendMail( wfMsg( 'passwordremindertitle' ), $m );
556 * @param string $msg Message that will be shown on success
557 * @param bool $auto Toggle auto-redirect to main page; default true
560 function successfulLogin( $msg, $auto = true ) {
564 # Run any hooks; ignore results
566 wfRunHooks('UserLoginComplete', array(&$wgUser));
568 $wgOut->setPageTitle( wfMsg( 'loginsuccesstitle' ) );
569 $wgOut->setRobotpolicy( 'noindex,nofollow' );
570 $wgOut->setArticleRelated( false );
571 $wgOut->addWikiText( $msg );
572 if ( !empty( $this->mReturnTo
) ) {
573 $wgOut->returnToMain( $auto, $this->mReturnTo
);
575 $wgOut->returnToMain( $auto );
580 function userNotPrivilegedMessage() {
583 $wgOut->setPageTitle( wfMsg( 'whitelistacctitle' ) );
584 $wgOut->setRobotpolicy( 'noindex,nofollow' );
585 $wgOut->setArticleRelated( false );
587 $wgOut->addWikiText( wfMsg( 'whitelistacctext' ) );
589 $wgOut->returnToMain( false );
593 function userBlockedMessage() {
596 # Let's be nice about this, it's likely that this feature will be used
597 # for blocking large numbers of innocent people, e.g. range blocks on
598 # schools. Don't blame it on the user. There's a small chance that it
599 # really is the user's fault, i.e. the username is blocked and they
600 # haven't bothered to log out before trying to create an account to
601 # evade it, but we'll leave that to their guilty conscience to figure
604 $wgOut->setPageTitle( wfMsg( 'cantcreateaccounttitle' ) );
605 $wgOut->setRobotpolicy( 'noindex,nofollow' );
606 $wgOut->setArticleRelated( false );
609 $wgOut->addWikiText( wfMsg( 'cantcreateaccounttext', $ip ) );
610 $wgOut->returnToMain( false );
616 function mainLoginForm( $msg, $msgtype = 'error' ) {
617 global $wgUser, $wgOut, $wgAllowRealName, $wgEnableEmail;
618 global $wgCookiePrefix, $wgAuth, $wgLoginLanguageSelector;
621 if ( $this->mType
== 'signup' ) {
622 if ( !$wgUser->isAllowed( 'createaccount' ) ) {
623 $this->userNotPrivilegedMessage();
625 } elseif ( $wgUser->isBlockedFromCreateAccount() ) {
626 $this->userBlockedMessage();
631 if ( '' == $this->mName
) {
632 if ( $wgUser->isLoggedIn() ) {
633 $this->mName
= $wgUser->getName();
635 $this->mName
= isset( $_COOKIE[$wgCookiePrefix.'UserName'] ) ?
$_COOKIE[$wgCookiePrefix.'UserName'] : null;
639 $titleObj = SpecialPage
::getTitleFor( 'Userlogin' );
641 if ( $this->mType
== 'signup' ) {
642 $template = new UsercreateTemplate();
643 $q = 'action=submitlogin&type=signup';
644 $linkq = 'type=login';
645 $linkmsg = 'gotaccount';
647 $template = new UserloginTemplate();
648 $q = 'action=submitlogin&type=login';
649 $linkq = 'type=signup';
650 $linkmsg = 'nologin';
653 if ( !empty( $this->mReturnTo
) ) {
654 $returnto = '&returnto=' . wfUrlencode( $this->mReturnTo
);
659 # Pass any language selection on to the mode switch link
660 if( $wgLoginLanguageSelector && $this->mLanguage
)
661 $linkq .= '&uselang=' . $this->mLanguage
;
663 $link = '<a href="' . htmlspecialchars ( $titleObj->getLocalUrl( $linkq ) ) . '">';
664 $link .= wfMsgHtml( $linkmsg . 'link' );
667 # Don't show a "create account" link if the user can't
668 if( $this->showCreateOrLoginLink( $wgUser ) )
669 $template->set( 'link', wfMsgHtml( $linkmsg, $link ) );
671 $template->set( 'link', '' );
673 $template->set( 'header', '' );
674 $template->set( 'name', $this->mName
);
675 $template->set( 'password', $this->mPassword
);
676 $template->set( 'retype', $this->mRetype
);
677 $template->set( 'email', $this->mEmail
);
678 $template->set( 'realname', $this->mRealName
);
679 $template->set( 'domain', $this->mDomain
);
681 $template->set( 'action', $titleObj->getLocalUrl( $q ) );
682 $template->set( 'message', $msg );
683 $template->set( 'messagetype', $msgtype );
684 $template->set( 'createemail', $wgEnableEmail && $wgUser->isLoggedIn() );
685 $template->set( 'userealname', $wgAllowRealName );
686 $template->set( 'useemail', $wgEnableEmail );
687 $template->set( 'canreset', $wgAuth->allowPasswordChange() );
688 $template->set( 'remember', $wgUser->getOption( 'rememberpassword' ) or $this->mRemember
);
690 # Prepare language selection links as needed
691 if( $wgLoginLanguageSelector ) {
692 $template->set( 'languages', $this->makeLanguageSelector() );
693 if( $this->mLanguage
)
694 $template->set( 'uselang', $this->mLanguage
);
697 // Give authentication and captcha plugins a chance to modify the form
698 $wgAuth->modifyUITemplate( $template );
699 if ( $this->mType
== 'signup' ) {
700 wfRunHooks( 'UserCreateForm', array( &$template ) );
702 wfRunHooks( 'UserLoginForm', array( &$template ) );
705 $wgOut->setPageTitle( wfMsg( 'userlogin' ) );
706 $wgOut->setRobotpolicy( 'noindex,nofollow' );
707 $wgOut->setArticleRelated( false );
708 $wgOut->disallowUserJs(); // just in case...
709 $wgOut->addTemplate( $template );
715 function showCreateOrLoginLink( &$user ) {
716 if( $this->mType
== 'signup' ) {
718 } elseif( $user->isAllowed( 'createaccount' ) ) {
726 * Check if a session cookie is present.
728 * This will not pick up a cookie set during _this_ request, but is
729 * meant to ensure that the client is returning the cookie which was
730 * set on a previous pass through the system.
734 function hasSessionCookie() {
735 global $wgDisableCookieCheck, $wgRequest;
736 return $wgDisableCookieCheck ?
true : $wgRequest->checkSessionCookie();
742 function cookieRedirectCheck( $type ) {
745 $titleObj = SpecialPage
::getTitleFor( 'Userlogin' );
746 $check = $titleObj->getFullURL( 'wpCookieCheck='.$type );
748 return $wgOut->redirect( $check );
754 function onCookieRedirectCheck( $type ) {
757 if ( !$this->hasSessionCookie() ) {
758 if ( $type == 'new' ) {
759 return $this->mainLoginForm( wfMsg( 'nocookiesnew' ) );
760 } else if ( $type == 'login' ) {
761 return $this->mainLoginForm( wfMsg( 'nocookieslogin' ) );
764 return $this->mainLoginForm( wfMsg( 'error' ) );
767 return $this->successfulLogin( wfMsg( 'loginsuccess', $wgUser->getName() ) );
774 function throttleHit( $limit ) {
777 $wgOut->addWikiText( wfMsg( 'acct_creation_throttle_hit', $limit ) );
781 * Produce a bar of links which allow the user to select another language
782 * during login/registration but retain "returnto"
786 function makeLanguageSelector() {
787 $msg = wfMsgForContent( 'loginlanguagelinks' );
788 if( $msg != '' && !wfEmptyMsg( 'loginlanguagelinks', $msg ) ) {
789 $langs = explode( "\n", $msg );
791 foreach( $langs as $lang ) {
792 $lang = trim( $lang, '* ' );
793 $parts = explode( '|', $lang );
794 $links[] = $this->makeLanguageSelectorLink( $parts[0], $parts[1] );
796 return count( $links ) > 0 ?
wfMsgHtml( 'loginlanguagelabel', implode( ' | ', $links ) ) : '';
803 * Create a language selector link for a particular language
804 * Links back to this page preserving type and returnto
806 * @param $text Link text
807 * @param $lang Language code
809 function makeLanguageSelectorLink( $text, $lang ) {
811 $self = SpecialPage
::getTitleFor( 'Userlogin' );
812 $attr[] = 'uselang=' . $lang;
813 if( $this->mType
== 'signup' )
814 $attr[] = 'type=signup';
815 if( $this->mReturnTo
)
816 $attr[] = 'returnto=' . $this->mReturnTo
;
817 $skin = $wgUser->getSkin();
818 return $skin->makeKnownLinkObj( $self, htmlspecialchars( $text ), implode( '&', $attr ) );