* ( bug 18264 ) upload-by-url form was still disabled in non-js2 form output
[lhc/web/wiklou.git] / includes / User.php
1 <?php
2 /**
3 * Implements the User class for the %MediaWiki software.
4 * @file
5 */
6
7 /**
8 * \int Number of characters in user_token field.
9 * @ingroup Constants
10 */
11 define( 'USER_TOKEN_LENGTH', 32 );
12
13 /**
14 * \int Serialized record version.
15 * @ingroup Constants
16 */
17 define( 'MW_USER_VERSION', 8 );
18
19 /**
20 * \string Some punctuation to prevent editing from broken text-mangling proxies.
21 * @ingroup Constants
22 */
23 define( 'EDIT_TOKEN_SUFFIX', '+\\' );
24
25 /**
26 * Thrown by User::setPassword() on error.
27 * @ingroup Exception
28 */
29 class PasswordError extends MWException {
30 // NOP
31 }
32
33 /**
34 * The User object encapsulates all of the user-specific settings (user_id,
35 * name, rights, password, email address, options, last login time). Client
36 * classes use the getXXX() functions to access these fields. These functions
37 * do all the work of determining whether the user is logged in,
38 * whether the requested option can be satisfied from cookies or
39 * whether a database query is needed. Most of the settings needed
40 * for rendering normal pages are set in the cookie to minimize use
41 * of the database.
42 */
43 class User {
44
45 /**
46 * \type{\arrayof{\string}} A list of default user toggles, i.e., boolean user
47 * preferences that are displayed by Special:Preferences as checkboxes.
48 * This list can be extended via the UserToggles hook or by
49 * $wgContLang::getExtraUserToggles().
50 * @showinitializer
51 */
52 public static $mToggles = array(
53 'highlightbroken',
54 'justify',
55 'hideminor',
56 'extendwatchlist',
57 'usenewrc',
58 'numberheadings',
59 'showtoolbar',
60 'editondblclick',
61 'editsection',
62 'editsectiononrightclick',
63 'showtoc',
64 'rememberpassword',
65 'editwidth',
66 'watchcreations',
67 'watchdefault',
68 'watchmoves',
69 'watchdeletion',
70 'minordefault',
71 'previewontop',
72 'previewonfirst',
73 'nocache',
74 'enotifwatchlistpages',
75 'enotifusertalkpages',
76 'enotifminoredits',
77 'enotifrevealaddr',
78 'shownumberswatching',
79 'fancysig',
80 'externaleditor',
81 'externaldiff',
82 'showjumplinks',
83 'uselivepreview',
84 'forceeditsummary',
85 'watchlisthideminor',
86 'watchlisthidebots',
87 'watchlisthideown',
88 'watchlisthideanons',
89 'watchlisthideliu',
90 'ccmeonemails',
91 'diffonly',
92 'showhiddencats',
93 'noconvertlink',
94 'norollbackdiff',
95 );
96
97 /**
98 * \type{\arrayof{\string}} List of member variables which are saved to the
99 * shared cache (memcached). Any operation which changes the
100 * corresponding database fields must call a cache-clearing function.
101 * @showinitializer
102 */
103 static $mCacheVars = array(
104 // user table
105 'mId',
106 'mName',
107 'mRealName',
108 'mPassword',
109 'mNewpassword',
110 'mNewpassTime',
111 'mEmail',
112 'mTouched',
113 'mToken',
114 'mEmailAuthenticated',
115 'mEmailToken',
116 'mEmailTokenExpires',
117 'mRegistration',
118 'mEditCount',
119 // user_group table
120 'mGroups',
121 // user_properties table
122 'mOptionOverrides',
123 );
124
125 /**
126 * \type{\arrayof{\string}} Core rights.
127 * Each of these should have a corresponding message of the form
128 * "right-$right".
129 * @showinitializer
130 */
131 static $mCoreRights = array(
132 'apihighlimits',
133 'autoconfirmed',
134 'autopatrol',
135 'bigdelete',
136 'block',
137 'blockemail',
138 'bot',
139 'browsearchive',
140 'createaccount',
141 'createpage',
142 'createtalk',
143 'delete',
144 'deletedhistory',
145 'deleterevision',
146 'edit',
147 'editinterface',
148 'editusercssjs',
149 'hideuser',
150 'import',
151 'importupload',
152 'ipblock-exempt',
153 'markbotedits',
154 'minoredit',
155 'move',
156 'movefile',
157 'move-rootuserpages',
158 'move-subpages',
159 'nominornewtalk',
160 'noratelimit',
161 'override-export-depth',
162 'patrol',
163 'protect',
164 'proxyunbannable',
165 'purge',
166 'read',
167 'reupload',
168 'reupload-shared',
169 'rollback',
170 'siteadmin',
171 'suppressionlog',
172 'suppressredirect',
173 'suppressrevision',
174 'trackback',
175 'undelete',
176 'unwatchedpages',
177 'upload',
178 'upload_by_url',
179 'userrights',
180 'userrights-interwiki',
181 'writeapi',
182 );
183 /**
184 * \string Cached results of getAllRights()
185 */
186 static $mAllRights = false;
187
188 /** @name Cache variables */
189 //@{
190 var $mId, $mName, $mRealName, $mPassword, $mNewpassword, $mNewpassTime,
191 $mEmail, $mTouched, $mToken, $mEmailAuthenticated,
192 $mEmailToken, $mEmailTokenExpires, $mRegistration, $mGroups, $mOptionOverrides;
193 //@}
194
195 /**
196 * \bool Whether the cache variables have been loaded.
197 */
198 var $mDataLoaded, $mAuthLoaded, $mOptionsLoaded;
199
200 /**
201 * \string Initialization data source if mDataLoaded==false. May be one of:
202 * - 'defaults' anonymous user initialised from class defaults
203 * - 'name' initialise from mName
204 * - 'id' initialise from mId
205 * - 'session' log in from cookies or session if possible
206 *
207 * Use the User::newFrom*() family of functions to set this.
208 */
209 var $mFrom;
210
211 /** @name Lazy-initialized variables, invalidated with clearInstanceCache */
212 //@{
213 var $mNewtalk, $mDatePreference, $mBlockedby, $mHash, $mSkin, $mRights,
214 $mBlockreason, $mBlock, $mEffectiveGroups, $mBlockedGlobally,
215 $mLocked, $mHideName, $mOptions;
216 //@}
217
218 static $idCacheByName = array();
219
220 /**
221 * Lightweight constructor for an anonymous user.
222 * Use the User::newFrom* factory functions for other kinds of users.
223 *
224 * @see newFromName()
225 * @see newFromId()
226 * @see newFromConfirmationCode()
227 * @see newFromSession()
228 * @see newFromRow()
229 */
230 function User() {
231 $this->clearInstanceCache( 'defaults' );
232 }
233
234 /**
235 * Load the user table data for this object from the source given by mFrom.
236 */
237 function load() {
238 if ( $this->mDataLoaded ) {
239 return;
240 }
241 wfProfileIn( __METHOD__ );
242
243 # Set it now to avoid infinite recursion in accessors
244 $this->mDataLoaded = true;
245
246 switch ( $this->mFrom ) {
247 case 'defaults':
248 $this->loadDefaults();
249 break;
250 case 'name':
251 $this->mId = self::idFromName( $this->mName );
252 if ( !$this->mId ) {
253 # Nonexistent user placeholder object
254 $this->loadDefaults( $this->mName );
255 } else {
256 $this->loadFromId();
257 }
258 break;
259 case 'id':
260 $this->loadFromId();
261 break;
262 case 'session':
263 $this->loadFromSession();
264 wfRunHooks( 'UserLoadAfterLoadFromSession', array( $this ) );
265 break;
266 default:
267 throw new MWException( "Unrecognised value for User->mFrom: \"{$this->mFrom}\"" );
268 }
269 wfProfileOut( __METHOD__ );
270 }
271
272 /**
273 * Load user table data, given mId has already been set.
274 * @return \bool false if the ID does not exist, true otherwise
275 * @private
276 */
277 function loadFromId() {
278 global $wgMemc;
279 if ( $this->mId == 0 ) {
280 $this->loadDefaults();
281 return false;
282 }
283
284 # Try cache
285 $key = wfMemcKey( 'user', 'id', $this->mId );
286 $data = $wgMemc->get( $key );
287 if ( !is_array( $data ) || $data['mVersion'] < MW_USER_VERSION ) {
288 # Object is expired, load from DB
289 $data = false;
290 }
291
292 if ( !$data ) {
293 wfDebug( "Cache miss for user {$this->mId}\n" );
294 # Load from DB
295 if ( !$this->loadFromDatabase() ) {
296 # Can't load from ID, user is anonymous
297 return false;
298 }
299 $this->saveToCache();
300 } else {
301 wfDebug( "Got user {$this->mId} from cache\n" );
302 # Restore from cache
303 foreach ( self::$mCacheVars as $name ) {
304 $this->$name = $data[$name];
305 }
306 }
307 return true;
308 }
309
310 /**
311 * Save user data to the shared cache
312 */
313 function saveToCache() {
314 $this->load();
315 $this->loadGroups();
316 $this->loadOptions();
317 if ( $this->isAnon() ) {
318 // Anonymous users are uncached
319 return;
320 }
321 $data = array();
322 foreach ( self::$mCacheVars as $name ) {
323 $data[$name] = $this->$name;
324 }
325 $data['mVersion'] = MW_USER_VERSION;
326 $key = wfMemcKey( 'user', 'id', $this->mId );
327 global $wgMemc;
328 $wgMemc->set( $key, $data );
329 }
330
331
332 /** @name newFrom*() static factory methods */
333 //@{
334
335 /**
336 * Static factory method for creation from username.
337 *
338 * This is slightly less efficient than newFromId(), so use newFromId() if
339 * you have both an ID and a name handy.
340 *
341 * @param $name \string Username, validated by Title::newFromText()
342 * @param $validate \mixed Validate username. Takes the same parameters as
343 * User::getCanonicalName(), except that true is accepted as an alias
344 * for 'valid', for BC.
345 *
346 * @return \type{User} The User object, or null if the username is invalid. If the
347 * username is not present in the database, the result will be a user object
348 * with a name, zero user ID and default settings.
349 */
350 static function newFromName( $name, $validate = 'valid' ) {
351 if ( $validate === true ) {
352 $validate = 'valid';
353 }
354 $name = self::getCanonicalName( $name, $validate );
355 if ( $name === false ) {
356 return null;
357 } else {
358 # Create unloaded user object
359 $u = new User;
360 $u->mName = $name;
361 $u->mFrom = 'name';
362 return $u;
363 }
364 }
365
366 /**
367 * Static factory method for creation from a given user ID.
368 *
369 * @param $id \int Valid user ID
370 * @return \type{User} The corresponding User object
371 */
372 static function newFromId( $id ) {
373 $u = new User;
374 $u->mId = $id;
375 $u->mFrom = 'id';
376 return $u;
377 }
378
379 /**
380 * Factory method to fetch whichever user has a given email confirmation code.
381 * This code is generated when an account is created or its e-mail address
382 * has changed.
383 *
384 * If the code is invalid or has expired, returns NULL.
385 *
386 * @param $code \string Confirmation code
387 * @return \type{User}
388 */
389 static function newFromConfirmationCode( $code ) {
390 $dbr = wfGetDB( DB_SLAVE );
391 $id = $dbr->selectField( 'user', 'user_id', array(
392 'user_email_token' => md5( $code ),
393 'user_email_token_expires > ' . $dbr->addQuotes( $dbr->timestamp() ),
394 ) );
395 if( $id !== false ) {
396 return User::newFromId( $id );
397 } else {
398 return null;
399 }
400 }
401
402 /**
403 * Create a new user object using data from session or cookies. If the
404 * login credentials are invalid, the result is an anonymous user.
405 *
406 * @return \type{User}
407 */
408 static function newFromSession() {
409 $user = new User;
410 $user->mFrom = 'session';
411 return $user;
412 }
413
414 /**
415 * Create a new user object from a user row.
416 * The row should have all fields from the user table in it.
417 * @param $row array A row from the user table
418 * @return \type{User}
419 */
420 static function newFromRow( $row ) {
421 $user = new User;
422 $user->loadFromRow( $row );
423 return $user;
424 }
425
426 //@}
427
428
429 /**
430 * Get the username corresponding to a given user ID
431 * @param $id \int User ID
432 * @return \string The corresponding username
433 */
434 static function whoIs( $id ) {
435 $dbr = wfGetDB( DB_SLAVE );
436 return $dbr->selectField( 'user', 'user_name', array( 'user_id' => $id ), 'User::whoIs' );
437 }
438
439 /**
440 * Get the real name of a user given their user ID
441 *
442 * @param $id \int User ID
443 * @return \string The corresponding user's real name
444 */
445 static function whoIsReal( $id ) {
446 $dbr = wfGetDB( DB_SLAVE );
447 return $dbr->selectField( 'user', 'user_real_name', array( 'user_id' => $id ), __METHOD__ );
448 }
449
450 /**
451 * Get database id given a user name
452 * @param $name \string Username
453 * @return \types{\int,\null} The corresponding user's ID, or null if user is nonexistent
454 */
455 static function idFromName( $name ) {
456 $nt = Title::makeTitleSafe( NS_USER, $name );
457 if( is_null( $nt ) ) {
458 # Illegal name
459 return null;
460 }
461
462 if ( isset(self::$idCacheByName[$name]) ) {
463 return self::$idCacheByName[$name];
464 }
465
466 $dbr = wfGetDB( DB_SLAVE );
467 $s = $dbr->selectRow( 'user', array( 'user_id' ), array( 'user_name' => $nt->getText() ), __METHOD__ );
468
469 if ( $s === false ) {
470 $result = 0;
471 } else {
472 $result = $s->user_id;
473 }
474
475 self::$idCacheByName[$name] = $result;
476
477 if ( count(self::$idCacheByName) > 1000 ) {
478 self::$idCacheByName = array();
479 }
480
481 return $result;
482 }
483
484 /**
485 * Does the string match an anonymous IPv4 address?
486 *
487 * This function exists for username validation, in order to reject
488 * usernames which are similar in form to IP addresses. Strings such
489 * as 300.300.300.300 will return true because it looks like an IP
490 * address, despite not being strictly valid.
491 *
492 * We match \d{1,3}\.\d{1,3}\.\d{1,3}\.xxx as an anonymous IP
493 * address because the usemod software would "cloak" anonymous IP
494 * addresses like this, if we allowed accounts like this to be created
495 * new users could get the old edits of these anonymous users.
496 *
497 * @param $name \string String to match
498 * @return \bool True or false
499 */
500 static function isIP( $name ) {
501 return preg_match('/^\d{1,3}\.\d{1,3}\.\d{1,3}\.(?:xxx|\d{1,3})$/',$name) || IP::isIPv6($name);
502 }
503
504 /**
505 * Is the input a valid username?
506 *
507 * Checks if the input is a valid username, we don't want an empty string,
508 * an IP address, anything that containins slashes (would mess up subpages),
509 * is longer than the maximum allowed username size or doesn't begin with
510 * a capital letter.
511 *
512 * @param $name \string String to match
513 * @return \bool True or false
514 */
515 static function isValidUserName( $name ) {
516 global $wgContLang, $wgMaxNameChars;
517
518 if ( $name == ''
519 || User::isIP( $name )
520 || strpos( $name, '/' ) !== false
521 || strlen( $name ) > $wgMaxNameChars
522 || $name != $wgContLang->ucfirst( $name ) ) {
523 wfDebugLog( 'username', __METHOD__ .
524 ": '$name' invalid due to empty, IP, slash, length, or lowercase" );
525 return false;
526 }
527
528 // Ensure that the name can't be misresolved as a different title,
529 // such as with extra namespace keys at the start.
530 $parsed = Title::newFromText( $name );
531 if( is_null( $parsed )
532 || $parsed->getNamespace()
533 || strcmp( $name, $parsed->getPrefixedText() ) ) {
534 wfDebugLog( 'username', __METHOD__ .
535 ": '$name' invalid due to ambiguous prefixes" );
536 return false;
537 }
538
539 // Check an additional blacklist of troublemaker characters.
540 // Should these be merged into the title char list?
541 $unicodeBlacklist = '/[' .
542 '\x{0080}-\x{009f}' . # iso-8859-1 control chars
543 '\x{00a0}' . # non-breaking space
544 '\x{2000}-\x{200f}' . # various whitespace
545 '\x{2028}-\x{202f}' . # breaks and control chars
546 '\x{3000}' . # ideographic space
547 '\x{e000}-\x{f8ff}' . # private use
548 ']/u';
549 if( preg_match( $unicodeBlacklist, $name ) ) {
550 wfDebugLog( 'username', __METHOD__ .
551 ": '$name' invalid due to blacklisted characters" );
552 return false;
553 }
554
555 return true;
556 }
557
558 /**
559 * Usernames which fail to pass this function will be blocked
560 * from user login and new account registrations, but may be used
561 * internally by batch processes.
562 *
563 * If an account already exists in this form, login will be blocked
564 * by a failure to pass this function.
565 *
566 * @param $name \string String to match
567 * @return \bool True or false
568 */
569 static function isUsableName( $name ) {
570 global $wgReservedUsernames;
571 // Must be a valid username, obviously ;)
572 if ( !self::isValidUserName( $name ) ) {
573 return false;
574 }
575
576 static $reservedUsernames = false;
577 if ( !$reservedUsernames ) {
578 $reservedUsernames = $wgReservedUsernames;
579 wfRunHooks( 'UserGetReservedNames', array( &$reservedUsernames ) );
580 }
581
582 // Certain names may be reserved for batch processes.
583 foreach ( $reservedUsernames as $reserved ) {
584 if ( substr( $reserved, 0, 4 ) == 'msg:' ) {
585 $reserved = wfMsgForContent( substr( $reserved, 4 ) );
586 }
587 if ( $reserved == $name ) {
588 return false;
589 }
590 }
591 return true;
592 }
593
594 /**
595 * Usernames which fail to pass this function will be blocked
596 * from new account registrations, but may be used internally
597 * either by batch processes or by user accounts which have
598 * already been created.
599 *
600 * Additional character blacklisting may be added here
601 * rather than in isValidUserName() to avoid disrupting
602 * existing accounts.
603 *
604 * @param $name \string String to match
605 * @return \bool True or false
606 */
607 static function isCreatableName( $name ) {
608 global $wgInvalidUsernameCharacters;
609 return
610 self::isUsableName( $name ) &&
611
612 // Registration-time character blacklisting...
613 !preg_match( '/[' . preg_quote( $wgInvalidUsernameCharacters, '/' ) . ']/', $name );
614 }
615
616 /**
617 * Is the input a valid password for this user?
618 *
619 * @param $password String Desired password
620 * @return mixed: true on success, string of error message on failure
621 */
622 function isValidPassword( $password ) {
623 global $wgMinimalPasswordLength, $wgContLang;
624
625 if( !wfRunHooks( 'isValidPassword', array( $password, &$result, $this ) ) )
626 return $result;
627
628 // Password needs to be long enough
629 if( strlen( $password ) < $wgMinimalPasswordLength ) {
630 return 'passwordtooshort';
631 } elseif( $wgContLang->lc( $password ) == $wgContLang->lc( $this->mName ) ) {
632 return 'password-name-match';
633 } else {
634 return true;
635 }
636 }
637
638 /**
639 * Does a string look like an e-mail address?
640 *
641 * There used to be a regular expression here, it got removed because it
642 * rejected valid addresses. Actually just check if there is '@' somewhere
643 * in the given address.
644 *
645 * @todo Check for RFC 2822 compilance (bug 959)
646 *
647 * @param $addr \string E-mail address
648 * @return \bool True or false
649 */
650 public static function isValidEmailAddr( $addr ) {
651 $result = null;
652 if( !wfRunHooks( 'isValidEmailAddr', array( $addr, &$result ) ) ) {
653 return $result;
654 }
655
656 return strpos( $addr, '@' ) !== false;
657 }
658
659 /**
660 * Given unvalidated user input, return a canonical username, or false if
661 * the username is invalid.
662 * @param $name \string User input
663 * @param $validate \types{\string,\bool} Type of validation to use:
664 * - false No validation
665 * - 'valid' Valid for batch processes
666 * - 'usable' Valid for batch processes and login
667 * - 'creatable' Valid for batch processes, login and account creation
668 */
669 static function getCanonicalName( $name, $validate = 'valid' ) {
670 # Force usernames to capital
671 global $wgContLang;
672 $name = $wgContLang->ucfirst( $name );
673
674 # Reject names containing '#'; these will be cleaned up
675 # with title normalisation, but then it's too late to
676 # check elsewhere
677 if( strpos( $name, '#' ) !== false )
678 return false;
679
680 # Clean up name according to title rules
681 $t = ($validate === 'valid') ?
682 Title::newFromText( $name ) : Title::makeTitle( NS_USER, $name );
683 # Check for invalid titles
684 if( is_null( $t ) ) {
685 return false;
686 }
687
688 # Reject various classes of invalid names
689 $name = $t->getText();
690 global $wgAuth;
691 $name = $wgAuth->getCanonicalName( $t->getText() );
692
693 switch ( $validate ) {
694 case false:
695 break;
696 case 'valid':
697 if ( !User::isValidUserName( $name ) ) {
698 $name = false;
699 }
700 break;
701 case 'usable':
702 if ( !User::isUsableName( $name ) ) {
703 $name = false;
704 }
705 break;
706 case 'creatable':
707 if ( !User::isCreatableName( $name ) ) {
708 $name = false;
709 }
710 break;
711 default:
712 throw new MWException( 'Invalid parameter value for $validate in '.__METHOD__ );
713 }
714 return $name;
715 }
716
717 /**
718 * Count the number of edits of a user
719 * @todo It should not be static and some day should be merged as proper member function / deprecated -- domas
720 *
721 * @param $uid \int User ID to check
722 * @return \int The user's edit count
723 */
724 static function edits( $uid ) {
725 wfProfileIn( __METHOD__ );
726 $dbr = wfGetDB( DB_SLAVE );
727 // check if the user_editcount field has been initialized
728 $field = $dbr->selectField(
729 'user', 'user_editcount',
730 array( 'user_id' => $uid ),
731 __METHOD__
732 );
733
734 if( $field === null ) { // it has not been initialized. do so.
735 $dbw = wfGetDB( DB_MASTER );
736 $count = $dbr->selectField(
737 'revision', 'count(*)',
738 array( 'rev_user' => $uid ),
739 __METHOD__
740 );
741 $dbw->update(
742 'user',
743 array( 'user_editcount' => $count ),
744 array( 'user_id' => $uid ),
745 __METHOD__
746 );
747 } else {
748 $count = $field;
749 }
750 wfProfileOut( __METHOD__ );
751 return $count;
752 }
753
754 /**
755 * Return a random password. Sourced from mt_rand, so it's not particularly secure.
756 * @todo hash random numbers to improve security, like generateToken()
757 *
758 * @return \string New random password
759 */
760 static function randomPassword() {
761 global $wgMinimalPasswordLength;
762 $pwchars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz';
763 $l = strlen( $pwchars ) - 1;
764
765 $pwlength = max( 7, $wgMinimalPasswordLength );
766 $digit = mt_rand(0, $pwlength - 1);
767 $np = '';
768 for ( $i = 0; $i < $pwlength; $i++ ) {
769 $np .= $i == $digit ? chr( mt_rand(48, 57) ) : $pwchars{ mt_rand(0, $l)};
770 }
771 return $np;
772 }
773
774 /**
775 * Set cached properties to default.
776 *
777 * @note This no longer clears uncached lazy-initialised properties;
778 * the constructor does that instead.
779 * @private
780 */
781 function loadDefaults( $name = false ) {
782 wfProfileIn( __METHOD__ );
783
784 global $wgCookiePrefix;
785
786 $this->mId = 0;
787 $this->mName = $name;
788 $this->mRealName = '';
789 $this->mPassword = $this->mNewpassword = '';
790 $this->mNewpassTime = null;
791 $this->mEmail = '';
792 $this->mOptionOverrides = null;
793 $this->mOptionsLoaded = false;
794
795 if ( isset( $_COOKIE[$wgCookiePrefix.'LoggedOut'] ) ) {
796 $this->mTouched = wfTimestamp( TS_MW, $_COOKIE[$wgCookiePrefix.'LoggedOut'] );
797 } else {
798 $this->mTouched = '0'; # Allow any pages to be cached
799 }
800
801 $this->setToken(); # Random
802 $this->mEmailAuthenticated = null;
803 $this->mEmailToken = '';
804 $this->mEmailTokenExpires = null;
805 $this->mRegistration = wfTimestamp( TS_MW );
806 $this->mGroups = array();
807
808 wfRunHooks( 'UserLoadDefaults', array( $this, $name ) );
809
810 wfProfileOut( __METHOD__ );
811 }
812
813 /**
814 * @deprecated Use wfSetupSession().
815 */
816 function SetupSession() {
817 wfDeprecated( __METHOD__ );
818 wfSetupSession();
819 }
820
821 /**
822 * Load user data from the session or login cookie. If there are no valid
823 * credentials, initialises the user as an anonymous user.
824 * @return \bool True if the user is logged in, false otherwise.
825 */
826 private function loadFromSession() {
827 global $wgMemc, $wgCookiePrefix;
828
829 $result = null;
830 wfRunHooks( 'UserLoadFromSession', array( $this, &$result ) );
831 if ( $result !== null ) {
832 return $result;
833 }
834
835 if ( isset( $_COOKIE["{$wgCookiePrefix}UserID"] ) ) {
836 $sId = intval( $_COOKIE["{$wgCookiePrefix}UserID"] );
837 if( isset( $_SESSION['wsUserID'] ) && $sId != $_SESSION['wsUserID'] ) {
838 $this->loadDefaults(); // Possible collision!
839 wfDebugLog( 'loginSessions', "Session user ID ({$_SESSION['wsUserID']}) and
840 cookie user ID ($sId) don't match!" );
841 return false;
842 }
843 $_SESSION['wsUserID'] = $sId;
844 } else if ( isset( $_SESSION['wsUserID'] ) ) {
845 if ( $_SESSION['wsUserID'] != 0 ) {
846 $sId = $_SESSION['wsUserID'];
847 } else {
848 $this->loadDefaults();
849 return false;
850 }
851 } else {
852 $this->loadDefaults();
853 return false;
854 }
855
856 if ( isset( $_SESSION['wsUserName'] ) ) {
857 $sName = $_SESSION['wsUserName'];
858 } else if ( isset( $_COOKIE["{$wgCookiePrefix}UserName"] ) ) {
859 $sName = $_COOKIE["{$wgCookiePrefix}UserName"];
860 $_SESSION['wsUserName'] = $sName;
861 } else {
862 $this->loadDefaults();
863 return false;
864 }
865
866 $passwordCorrect = FALSE;
867 $this->mId = $sId;
868 if ( !$this->loadFromId() ) {
869 # Not a valid ID, loadFromId has switched the object to anon for us
870 return false;
871 }
872
873 if ( isset( $_SESSION['wsToken'] ) ) {
874 $passwordCorrect = $_SESSION['wsToken'] == $this->mToken;
875 $from = 'session';
876 } else if ( isset( $_COOKIE["{$wgCookiePrefix}Token"] ) ) {
877 $passwordCorrect = $this->mToken == $_COOKIE["{$wgCookiePrefix}Token"];
878 $from = 'cookie';
879 } else {
880 # No session or persistent login cookie
881 $this->loadDefaults();
882 return false;
883 }
884
885 if ( ( $sName == $this->mName ) && $passwordCorrect ) {
886 $_SESSION['wsToken'] = $this->mToken;
887 wfDebug( "Logged in from $from\n" );
888 return true;
889 } else {
890 # Invalid credentials
891 wfDebug( "Can't log in from $from, invalid credentials\n" );
892 $this->loadDefaults();
893 return false;
894 }
895 }
896
897 /**
898 * Load user and user_group data from the database.
899 * $this::mId must be set, this is how the user is identified.
900 *
901 * @return \bool True if the user exists, false if the user is anonymous
902 * @private
903 */
904 function loadFromDatabase() {
905 # Paranoia
906 $this->mId = intval( $this->mId );
907
908 /** Anonymous user */
909 if( !$this->mId ) {
910 $this->loadDefaults();
911 return false;
912 }
913
914 $dbr = wfGetDB( DB_MASTER );
915 $s = $dbr->selectRow( 'user', '*', array( 'user_id' => $this->mId ), __METHOD__ );
916
917 wfRunHooks( 'UserLoadFromDatabase', array( $this, &$s ) );
918
919 if ( $s !== false ) {
920 # Initialise user table data
921 $this->loadFromRow( $s );
922 $this->mGroups = null; // deferred
923 $this->getEditCount(); // revalidation for nulls
924 return true;
925 } else {
926 # Invalid user_id
927 $this->mId = 0;
928 $this->loadDefaults();
929 return false;
930 }
931 }
932
933 /**
934 * Initialize this object from a row from the user table.
935 *
936 * @param $row \type{\arrayof{\mixed}} Row from the user table to load.
937 */
938 function loadFromRow( $row ) {
939 $this->mDataLoaded = true;
940
941 if ( isset( $row->user_id ) ) {
942 $this->mId = intval( $row->user_id );
943 }
944 $this->mName = $row->user_name;
945 $this->mRealName = $row->user_real_name;
946 $this->mPassword = $row->user_password;
947 $this->mNewpassword = $row->user_newpassword;
948 $this->mNewpassTime = wfTimestampOrNull( TS_MW, $row->user_newpass_time );
949 $this->mEmail = $row->user_email;
950 $this->decodeOptions( $row->user_options );
951 $this->mTouched = wfTimestamp(TS_MW,$row->user_touched);
952 $this->mToken = $row->user_token;
953 $this->mEmailAuthenticated = wfTimestampOrNull( TS_MW, $row->user_email_authenticated );
954 $this->mEmailToken = $row->user_email_token;
955 $this->mEmailTokenExpires = wfTimestampOrNull( TS_MW, $row->user_email_token_expires );
956 $this->mRegistration = wfTimestampOrNull( TS_MW, $row->user_registration );
957 $this->mEditCount = $row->user_editcount;
958 }
959
960 /**
961 * Load the groups from the database if they aren't already loaded.
962 * @private
963 */
964 function loadGroups() {
965 if ( is_null( $this->mGroups ) ) {
966 $dbr = wfGetDB( DB_MASTER );
967 $res = $dbr->select( 'user_groups',
968 array( 'ug_group' ),
969 array( 'ug_user' => $this->mId ),
970 __METHOD__ );
971 $this->mGroups = array();
972 while( $row = $dbr->fetchObject( $res ) ) {
973 $this->mGroups[] = $row->ug_group;
974 }
975 }
976 }
977
978 /**
979 * Clear various cached data stored in this object.
980 * @param $reloadFrom \string Reload user and user_groups table data from a
981 * given source. May be "name", "id", "defaults", "session", or false for
982 * no reload.
983 */
984 function clearInstanceCache( $reloadFrom = false ) {
985 $this->mNewtalk = -1;
986 $this->mDatePreference = null;
987 $this->mBlockedby = -1; # Unset
988 $this->mHash = false;
989 $this->mSkin = null;
990 $this->mRights = null;
991 $this->mEffectiveGroups = null;
992 $this->mOptions = null;
993
994 if ( $reloadFrom ) {
995 $this->mDataLoaded = false;
996 $this->mFrom = $reloadFrom;
997 }
998 }
999
1000 /**
1001 * Combine the language default options with any site-specific options
1002 * and add the default language variants.
1003 *
1004 * @return \type{\arrayof{\string}} Array of options
1005 */
1006 static function getDefaultOptions() {
1007 global $wgNamespacesToBeSearchedDefault;
1008 /**
1009 * Site defaults will override the global/language defaults
1010 */
1011 global $wgDefaultUserOptions, $wgContLang, $wgDefaultSkin;
1012 $defOpt = $wgDefaultUserOptions + $wgContLang->getDefaultUserOptionOverrides();
1013
1014 /**
1015 * default language setting
1016 */
1017 $variant = $wgContLang->getPreferredVariant( false );
1018 $defOpt['variant'] = $variant;
1019 $defOpt['language'] = $variant;
1020 foreach( SearchEngine::searchableNamespaces() as $nsnum => $nsname ) {
1021 $defOpt['searchNs'.$nsnum] = !empty($wgNamespacesToBeSearchedDefault[$nsnum]);
1022 }
1023 $defOpt['skin'] = $wgDefaultSkin;
1024
1025 return $defOpt;
1026 }
1027
1028 /**
1029 * Get a given default option value.
1030 *
1031 * @param $opt \string Name of option to retrieve
1032 * @return \string Default option value
1033 */
1034 public static function getDefaultOption( $opt ) {
1035 $defOpts = self::getDefaultOptions();
1036 if( isset( $defOpts[$opt] ) ) {
1037 return $defOpts[$opt];
1038 } else {
1039 return null;
1040 }
1041 }
1042
1043 /**
1044 * Get a list of user toggle names
1045 * @return \type{\arrayof{\string}} Array of user toggle names
1046 */
1047 static function getToggles() {
1048 global $wgContLang, $wgUseRCPatrol;
1049 $extraToggles = array();
1050 wfRunHooks( 'UserToggles', array( &$extraToggles ) );
1051 if( $wgUseRCPatrol ) {
1052 $extraToggles[] = 'hidepatrolled';
1053 $extraToggles[] = 'newpageshidepatrolled';
1054 $extraToggles[] = 'watchlisthidepatrolled';
1055 }
1056 return array_merge( self::$mToggles, $extraToggles, $wgContLang->getExtraUserToggles() );
1057 }
1058
1059
1060 /**
1061 * Get blocking information
1062 * @private
1063 * @param $bFromSlave \bool Whether to check the slave database first. To
1064 * improve performance, non-critical checks are done
1065 * against slaves. Check when actually saving should be
1066 * done against master.
1067 */
1068 function getBlockedStatus( $bFromSlave = true ) {
1069 global $wgEnableSorbs, $wgProxyWhitelist, $wgUser;
1070
1071 if ( -1 != $this->mBlockedby ) {
1072 wfDebug( "User::getBlockedStatus: already loaded.\n" );
1073 return;
1074 }
1075
1076 wfProfileIn( __METHOD__ );
1077 wfDebug( __METHOD__.": checking...\n" );
1078
1079 // Initialize data...
1080 // Otherwise something ends up stomping on $this->mBlockedby when
1081 // things get lazy-loaded later, causing false positive block hits
1082 // due to -1 !== 0. Probably session-related... Nothing should be
1083 // overwriting mBlockedby, surely?
1084 $this->load();
1085
1086 $this->mBlockedby = 0;
1087 $this->mHideName = 0;
1088 $this->mAllowUsertalk = 0;
1089
1090 # Check if we are looking at an IP or a logged-in user
1091 if ( $this->isIP( $this->getName() ) ) {
1092 $ip = $this->getName();
1093 }
1094 else {
1095 # Check if we are looking at the current user
1096 # If we don't, and the user is logged in, we don't know about
1097 # his IP / autoblock status, so ignore autoblock of current user's IP
1098 if ( $this->getID() != $wgUser->getID() ) {
1099 $ip = '';
1100 }
1101 else {
1102 # Get IP of current user
1103 $ip = wfGetIP();
1104 }
1105 }
1106
1107 if ( $this->isAllowed( 'ipblock-exempt' ) ) {
1108 # Exempt from all types of IP-block
1109 $ip = '';
1110 }
1111
1112 # User/IP blocking
1113 $this->mBlock = new Block();
1114 $this->mBlock->fromMaster( !$bFromSlave );
1115 if ( $this->mBlock->load( $ip , $this->mId ) ) {
1116 wfDebug( __METHOD__.": Found block.\n" );
1117 $this->mBlockedby = $this->mBlock->mBy;
1118 $this->mBlockreason = $this->mBlock->mReason;
1119 $this->mHideName = $this->mBlock->mHideName;
1120 $this->mAllowUsertalk = $this->mBlock->mAllowUsertalk;
1121 if ( $this->isLoggedIn() && $wgUser->getID() == $this->getID() ) {
1122 $this->spreadBlock();
1123 }
1124 } else {
1125 // Bug 13611: don't remove mBlock here, to allow account creation blocks to
1126 // apply to users. Note that the existence of $this->mBlock is not used to
1127 // check for edit blocks, $this->mBlockedby is instead.
1128 }
1129
1130 # Proxy blocking
1131 if ( !$this->isAllowed('proxyunbannable') && !in_array( $ip, $wgProxyWhitelist ) ) {
1132 # Local list
1133 if ( wfIsLocallyBlockedProxy( $ip ) ) {
1134 $this->mBlockedby = wfMsg( 'proxyblocker' );
1135 $this->mBlockreason = wfMsg( 'proxyblockreason' );
1136 }
1137
1138 # DNSBL
1139 if ( !$this->mBlockedby && $wgEnableSorbs && !$this->getID() ) {
1140 if ( $this->inSorbsBlacklist( $ip ) ) {
1141 $this->mBlockedby = wfMsg( 'sorbs' );
1142 $this->mBlockreason = wfMsg( 'sorbsreason' );
1143 }
1144 }
1145 }
1146
1147 # Extensions
1148 wfRunHooks( 'GetBlockedStatus', array( &$this ) );
1149
1150 wfProfileOut( __METHOD__ );
1151 }
1152
1153 /**
1154 * Whether the given IP is in the SORBS blacklist.
1155 *
1156 * @param $ip \string IP to check
1157 * @return \bool True if blacklisted.
1158 */
1159 function inSorbsBlacklist( $ip ) {
1160 global $wgEnableSorbs, $wgSorbsUrl;
1161
1162 return $wgEnableSorbs &&
1163 $this->inDnsBlacklist( $ip, $wgSorbsUrl );
1164 }
1165
1166 /**
1167 * Whether the given IP is in a given DNS blacklist.
1168 *
1169 * @param $ip \string IP to check
1170 * @param $base \string URL of the DNS blacklist
1171 * @return \bool True if blacklisted.
1172 */
1173 function inDnsBlacklist( $ip, $base ) {
1174 wfProfileIn( __METHOD__ );
1175
1176 $found = false;
1177 $host = '';
1178 // FIXME: IPv6 ??? (http://bugs.php.net/bug.php?id=33170)
1179 if( IP::isIPv4($ip) ) {
1180 # Make hostname
1181 $host = "$ip.$base";
1182
1183 # Send query
1184 $ipList = gethostbynamel( $host );
1185
1186 if( $ipList ) {
1187 wfDebug( "Hostname $host is {$ipList[0]}, it's a proxy says $base!\n" );
1188 $found = true;
1189 } else {
1190 wfDebug( "Requested $host, not found in $base.\n" );
1191 }
1192 }
1193
1194 wfProfileOut( __METHOD__ );
1195 return $found;
1196 }
1197
1198 /**
1199 * Is this user subject to rate limiting?
1200 *
1201 * @return \bool True if rate limited
1202 */
1203 public function isPingLimitable() {
1204 global $wgRateLimitsExcludedGroups;
1205 if( array_intersect( $this->getEffectiveGroups(), $wgRateLimitsExcludedGroups ) ) {
1206 // Deprecated, but kept for backwards-compatibility config
1207 return false;
1208 }
1209 return !$this->isAllowed('noratelimit');
1210 }
1211
1212 /**
1213 * Primitive rate limits: enforce maximum actions per time period
1214 * to put a brake on flooding.
1215 *
1216 * @note When using a shared cache like memcached, IP-address
1217 * last-hit counters will be shared across wikis.
1218 *
1219 * @param $action \string Action to enforce; 'edit' if unspecified
1220 * @return \bool True if a rate limiter was tripped
1221 */
1222 function pingLimiter( $action='edit' ) {
1223
1224 # Call the 'PingLimiter' hook
1225 $result = false;
1226 if( !wfRunHooks( 'PingLimiter', array( &$this, $action, $result ) ) ) {
1227 return $result;
1228 }
1229
1230 global $wgRateLimits;
1231 if( !isset( $wgRateLimits[$action] ) ) {
1232 return false;
1233 }
1234
1235 # Some groups shouldn't trigger the ping limiter, ever
1236 if( !$this->isPingLimitable() )
1237 return false;
1238
1239 global $wgMemc, $wgRateLimitLog;
1240 wfProfileIn( __METHOD__ );
1241
1242 $limits = $wgRateLimits[$action];
1243 $keys = array();
1244 $id = $this->getId();
1245 $ip = wfGetIP();
1246 $userLimit = false;
1247
1248 if( isset( $limits['anon'] ) && $id == 0 ) {
1249 $keys[wfMemcKey( 'limiter', $action, 'anon' )] = $limits['anon'];
1250 }
1251
1252 if( isset( $limits['user'] ) && $id != 0 ) {
1253 $userLimit = $limits['user'];
1254 }
1255 if( $this->isNewbie() ) {
1256 if( isset( $limits['newbie'] ) && $id != 0 ) {
1257 $keys[wfMemcKey( 'limiter', $action, 'user', $id )] = $limits['newbie'];
1258 }
1259 if( isset( $limits['ip'] ) ) {
1260 $keys["mediawiki:limiter:$action:ip:$ip"] = $limits['ip'];
1261 }
1262 $matches = array();
1263 if( isset( $limits['subnet'] ) && preg_match( '/^(\d+\.\d+\.\d+)\.\d+$/', $ip, $matches ) ) {
1264 $subnet = $matches[1];
1265 $keys["mediawiki:limiter:$action:subnet:$subnet"] = $limits['subnet'];
1266 }
1267 }
1268 // Check for group-specific permissions
1269 // If more than one group applies, use the group with the highest limit
1270 foreach ( $this->getGroups() as $group ) {
1271 if ( isset( $limits[$group] ) ) {
1272 if ( $userLimit === false || $limits[$group] > $userLimit ) {
1273 $userLimit = $limits[$group];
1274 }
1275 }
1276 }
1277 // Set the user limit key
1278 if ( $userLimit !== false ) {
1279 wfDebug( __METHOD__.": effective user limit: $userLimit\n" );
1280 $keys[ wfMemcKey( 'limiter', $action, 'user', $id ) ] = $userLimit;
1281 }
1282
1283 $triggered = false;
1284 foreach( $keys as $key => $limit ) {
1285 list( $max, $period ) = $limit;
1286 $summary = "(limit $max in {$period}s)";
1287 $count = $wgMemc->get( $key );
1288 if( $count ) {
1289 if( $count > $max ) {
1290 wfDebug( __METHOD__.": tripped! $key at $count $summary\n" );
1291 if( $wgRateLimitLog ) {
1292 @error_log( wfTimestamp( TS_MW ) . ' ' . wfWikiID() . ': ' . $this->getName() . " tripped $key at $count $summary\n", 3, $wgRateLimitLog );
1293 }
1294 $triggered = true;
1295 } else {
1296 wfDebug( __METHOD__.": ok. $key at $count $summary\n" );
1297 }
1298 } else {
1299 wfDebug( __METHOD__.": adding record for $key $summary\n" );
1300 $wgMemc->add( $key, 1, intval( $period ) );
1301 }
1302 $wgMemc->incr( $key );
1303 }
1304
1305 wfProfileOut( __METHOD__ );
1306 return $triggered;
1307 }
1308
1309 /**
1310 * Check if user is blocked
1311 *
1312 * @param $bFromSlave \bool Whether to check the slave database instead of the master
1313 * @return \bool True if blocked, false otherwise
1314 */
1315 function isBlocked( $bFromSlave = true ) { // hacked from false due to horrible probs on site
1316 wfDebug( "User::isBlocked: enter\n" );
1317 $this->getBlockedStatus( $bFromSlave );
1318 return $this->mBlockedby !== 0;
1319 }
1320
1321 /**
1322 * Check if user is blocked from editing a particular article
1323 *
1324 * @param $title \string Title to check
1325 * @param $bFromSlave \bool Whether to check the slave database instead of the master
1326 * @return \bool True if blocked, false otherwise
1327 */
1328 function isBlockedFrom( $title, $bFromSlave = false ) {
1329 global $wgBlockAllowsUTEdit;
1330 wfProfileIn( __METHOD__ );
1331 wfDebug( __METHOD__.": enter\n" );
1332
1333 wfDebug( __METHOD__.": asking isBlocked()\n" );
1334 $blocked = $this->isBlocked( $bFromSlave );
1335 $allowUsertalk = ($wgBlockAllowsUTEdit ? $this->mAllowUsertalk : false);
1336 # If a user's name is suppressed, they cannot make edits anywhere
1337 if ( !$this->mHideName && $allowUsertalk && $title->getText() === $this->getName() &&
1338 $title->getNamespace() == NS_USER_TALK ) {
1339 $blocked = false;
1340 wfDebug( __METHOD__.": self-talk page, ignoring any blocks\n" );
1341 }
1342 wfProfileOut( __METHOD__ );
1343 return $blocked;
1344 }
1345
1346 /**
1347 * If user is blocked, return the name of the user who placed the block
1348 * @return \string name of blocker
1349 */
1350 function blockedBy() {
1351 $this->getBlockedStatus();
1352 return $this->mBlockedby;
1353 }
1354
1355 /**
1356 * If user is blocked, return the specified reason for the block
1357 * @return \string Blocking reason
1358 */
1359 function blockedFor() {
1360 $this->getBlockedStatus();
1361 return $this->mBlockreason;
1362 }
1363
1364 /**
1365 * If user is blocked, return the ID for the block
1366 * @return \int Block ID
1367 */
1368 function getBlockId() {
1369 $this->getBlockedStatus();
1370 return ($this->mBlock ? $this->mBlock->mId : false);
1371 }
1372
1373 /**
1374 * Check if user is blocked on all wikis.
1375 * Do not use for actual edit permission checks!
1376 * This is intented for quick UI checks.
1377 *
1378 * @param $ip \type{\string} IP address, uses current client if none given
1379 * @return \type{\bool} True if blocked, false otherwise
1380 */
1381 function isBlockedGlobally( $ip = '' ) {
1382 if( $this->mBlockedGlobally !== null ) {
1383 return $this->mBlockedGlobally;
1384 }
1385 // User is already an IP?
1386 if( IP::isIPAddress( $this->getName() ) ) {
1387 $ip = $this->getName();
1388 } else if( !$ip ) {
1389 $ip = wfGetIP();
1390 }
1391 $blocked = false;
1392 wfRunHooks( 'UserIsBlockedGlobally', array( &$this, $ip, &$blocked ) );
1393 $this->mBlockedGlobally = (bool)$blocked;
1394 return $this->mBlockedGlobally;
1395 }
1396
1397 /**
1398 * Check if user account is locked
1399 *
1400 * @return \type{\bool} True if locked, false otherwise
1401 */
1402 function isLocked() {
1403 if( $this->mLocked !== null ) {
1404 return $this->mLocked;
1405 }
1406 global $wgAuth;
1407 $authUser = $wgAuth->getUserInstance( $this );
1408 $this->mLocked = (bool)$authUser->isLocked();
1409 return $this->mLocked;
1410 }
1411
1412 /**
1413 * Check if user account is hidden
1414 *
1415 * @return \type{\bool} True if hidden, false otherwise
1416 */
1417 function isHidden() {
1418 if( $this->mHideName !== null ) {
1419 return $this->mHideName;
1420 }
1421 $this->getBlockedStatus();
1422 if( !$this->mHideName ) {
1423 global $wgAuth;
1424 $authUser = $wgAuth->getUserInstance( $this );
1425 $this->mHideName = (bool)$authUser->isHidden();
1426 }
1427 return $this->mHideName;
1428 }
1429
1430 /**
1431 * Get the user's ID.
1432 * @return \int The user's ID; 0 if the user is anonymous or nonexistent
1433 */
1434 function getId() {
1435 if( $this->mId === null and $this->mName !== null
1436 and User::isIP( $this->mName ) ) {
1437 // Special case, we know the user is anonymous
1438 return 0;
1439 } elseif( $this->mId === null ) {
1440 // Don't load if this was initialized from an ID
1441 $this->load();
1442 }
1443 return $this->mId;
1444 }
1445
1446 /**
1447 * Set the user and reload all fields according to a given ID
1448 * @param $v \int User ID to reload
1449 */
1450 function setId( $v ) {
1451 $this->mId = $v;
1452 $this->clearInstanceCache( 'id' );
1453 }
1454
1455 /**
1456 * Get the user name, or the IP of an anonymous user
1457 * @return \string User's name or IP address
1458 */
1459 function getName() {
1460 if ( !$this->mDataLoaded && $this->mFrom == 'name' ) {
1461 # Special case optimisation
1462 return $this->mName;
1463 } else {
1464 $this->load();
1465 if ( $this->mName === false ) {
1466 # Clean up IPs
1467 $this->mName = IP::sanitizeIP( wfGetIP() );
1468 }
1469 return $this->mName;
1470 }
1471 }
1472
1473 /**
1474 * Set the user name.
1475 *
1476 * This does not reload fields from the database according to the given
1477 * name. Rather, it is used to create a temporary "nonexistent user" for
1478 * later addition to the database. It can also be used to set the IP
1479 * address for an anonymous user to something other than the current
1480 * remote IP.
1481 *
1482 * @note User::newFromName() has rougly the same function, when the named user
1483 * does not exist.
1484 * @param $str \string New user name to set
1485 */
1486 function setName( $str ) {
1487 $this->load();
1488 $this->mName = $str;
1489 }
1490
1491 /**
1492 * Get the user's name escaped by underscores.
1493 * @return \string Username escaped by underscores.
1494 */
1495 function getTitleKey() {
1496 return str_replace( ' ', '_', $this->getName() );
1497 }
1498
1499 /**
1500 * Check if the user has new messages.
1501 * @return \bool True if the user has new messages
1502 */
1503 function getNewtalk() {
1504 $this->load();
1505
1506 # Load the newtalk status if it is unloaded (mNewtalk=-1)
1507 if( $this->mNewtalk === -1 ) {
1508 $this->mNewtalk = false; # reset talk page status
1509
1510 # Check memcached separately for anons, who have no
1511 # entire User object stored in there.
1512 if( !$this->mId ) {
1513 global $wgMemc;
1514 $key = wfMemcKey( 'newtalk', 'ip', $this->getName() );
1515 $newtalk = $wgMemc->get( $key );
1516 if( strval( $newtalk ) !== '' ) {
1517 $this->mNewtalk = (bool)$newtalk;
1518 } else {
1519 // Since we are caching this, make sure it is up to date by getting it
1520 // from the master
1521 $this->mNewtalk = $this->checkNewtalk( 'user_ip', $this->getName(), true );
1522 $wgMemc->set( $key, (int)$this->mNewtalk, 1800 );
1523 }
1524 } else {
1525 $this->mNewtalk = $this->checkNewtalk( 'user_id', $this->mId );
1526 }
1527 }
1528
1529 return (bool)$this->mNewtalk;
1530 }
1531
1532 /**
1533 * Return the talk page(s) this user has new messages on.
1534 * @return \type{\arrayof{\string}} Array of page URLs
1535 */
1536 function getNewMessageLinks() {
1537 $talks = array();
1538 if (!wfRunHooks('UserRetrieveNewTalks', array(&$this, &$talks)))
1539 return $talks;
1540
1541 if (!$this->getNewtalk())
1542 return array();
1543 $up = $this->getUserPage();
1544 $utp = $up->getTalkPage();
1545 return array(array("wiki" => wfWikiID(), "link" => $utp->getLocalURL()));
1546 }
1547
1548
1549 /**
1550 * Internal uncached check for new messages
1551 *
1552 * @see getNewtalk()
1553 * @param $field \string 'user_ip' for anonymous users, 'user_id' otherwise
1554 * @param $id \types{\string,\int} User's IP address for anonymous users, User ID otherwise
1555 * @param $fromMaster \bool true to fetch from the master, false for a slave
1556 * @return \bool True if the user has new messages
1557 * @private
1558 */
1559 function checkNewtalk( $field, $id, $fromMaster = false ) {
1560 if ( $fromMaster ) {
1561 $db = wfGetDB( DB_MASTER );
1562 } else {
1563 $db = wfGetDB( DB_SLAVE );
1564 }
1565 $ok = $db->selectField( 'user_newtalk', $field,
1566 array( $field => $id ), __METHOD__ );
1567 return $ok !== false;
1568 }
1569
1570 /**
1571 * Add or update the new messages flag
1572 * @param $field \string 'user_ip' for anonymous users, 'user_id' otherwise
1573 * @param $id \types{\string,\int} User's IP address for anonymous users, User ID otherwise
1574 * @return \bool True if successful, false otherwise
1575 * @private
1576 */
1577 function updateNewtalk( $field, $id ) {
1578 $dbw = wfGetDB( DB_MASTER );
1579 $dbw->insert( 'user_newtalk',
1580 array( $field => $id ),
1581 __METHOD__,
1582 'IGNORE' );
1583 if ( $dbw->affectedRows() ) {
1584 wfDebug( __METHOD__.": set on ($field, $id)\n" );
1585 return true;
1586 } else {
1587 wfDebug( __METHOD__." already set ($field, $id)\n" );
1588 return false;
1589 }
1590 }
1591
1592 /**
1593 * Clear the new messages flag for the given user
1594 * @param $field \string 'user_ip' for anonymous users, 'user_id' otherwise
1595 * @param $id \types{\string,\int} User's IP address for anonymous users, User ID otherwise
1596 * @return \bool True if successful, false otherwise
1597 * @private
1598 */
1599 function deleteNewtalk( $field, $id ) {
1600 $dbw = wfGetDB( DB_MASTER );
1601 $dbw->delete( 'user_newtalk',
1602 array( $field => $id ),
1603 __METHOD__ );
1604 if ( $dbw->affectedRows() ) {
1605 wfDebug( __METHOD__.": killed on ($field, $id)\n" );
1606 return true;
1607 } else {
1608 wfDebug( __METHOD__.": already gone ($field, $id)\n" );
1609 return false;
1610 }
1611 }
1612
1613 /**
1614 * Update the 'You have new messages!' status.
1615 * @param $val \bool Whether the user has new messages
1616 */
1617 function setNewtalk( $val ) {
1618 if( wfReadOnly() ) {
1619 return;
1620 }
1621
1622 $this->load();
1623 $this->mNewtalk = $val;
1624
1625 if( $this->isAnon() ) {
1626 $field = 'user_ip';
1627 $id = $this->getName();
1628 } else {
1629 $field = 'user_id';
1630 $id = $this->getId();
1631 }
1632 global $wgMemc;
1633
1634 if( $val ) {
1635 $changed = $this->updateNewtalk( $field, $id );
1636 } else {
1637 $changed = $this->deleteNewtalk( $field, $id );
1638 }
1639
1640 if( $this->isAnon() ) {
1641 // Anons have a separate memcached space, since
1642 // user records aren't kept for them.
1643 $key = wfMemcKey( 'newtalk', 'ip', $id );
1644 $wgMemc->set( $key, $val ? 1 : 0, 1800 );
1645 }
1646 if ( $changed ) {
1647 $this->invalidateCache();
1648 }
1649 }
1650
1651 /**
1652 * Generate a current or new-future timestamp to be stored in the
1653 * user_touched field when we update things.
1654 * @return \string Timestamp in TS_MW format
1655 */
1656 private static function newTouchedTimestamp() {
1657 global $wgClockSkewFudge;
1658 return wfTimestamp( TS_MW, time() + $wgClockSkewFudge );
1659 }
1660
1661 /**
1662 * Clear user data from memcached.
1663 * Use after applying fun updates to the database; caller's
1664 * responsibility to update user_touched if appropriate.
1665 *
1666 * Called implicitly from invalidateCache() and saveSettings().
1667 */
1668 private function clearSharedCache() {
1669 $this->load();
1670 if( $this->mId ) {
1671 global $wgMemc;
1672 $wgMemc->delete( wfMemcKey( 'user', 'id', $this->mId ) );
1673 }
1674 }
1675
1676 /**
1677 * Immediately touch the user data cache for this account.
1678 * Updates user_touched field, and removes account data from memcached
1679 * for reload on the next hit.
1680 */
1681 function invalidateCache() {
1682 if( wfReadOnly() ) {
1683 return;
1684 }
1685 $this->load();
1686 if( $this->mId ) {
1687 $this->mTouched = self::newTouchedTimestamp();
1688
1689 $dbw = wfGetDB( DB_MASTER );
1690 $dbw->update( 'user',
1691 array( 'user_touched' => $dbw->timestamp( $this->mTouched ) ),
1692 array( 'user_id' => $this->mId ),
1693 __METHOD__ );
1694
1695 $this->clearSharedCache();
1696 }
1697 }
1698
1699 /**
1700 * Validate the cache for this account.
1701 * @param $timestamp \string A timestamp in TS_MW format
1702 */
1703 function validateCache( $timestamp ) {
1704 $this->load();
1705 return ($timestamp >= $this->mTouched);
1706 }
1707
1708 /**
1709 * Get the user touched timestamp
1710 */
1711 function getTouched() {
1712 $this->load();
1713 return $this->mTouched;
1714 }
1715
1716 /**
1717 * Set the password and reset the random token.
1718 * Calls through to authentication plugin if necessary;
1719 * will have no effect if the auth plugin refuses to
1720 * pass the change through or if the legal password
1721 * checks fail.
1722 *
1723 * As a special case, setting the password to null
1724 * wipes it, so the account cannot be logged in until
1725 * a new password is set, for instance via e-mail.
1726 *
1727 * @param $str \string New password to set
1728 * @throws PasswordError on failure
1729 */
1730 function setPassword( $str ) {
1731 global $wgAuth;
1732
1733 if( $str !== null ) {
1734 if( !$wgAuth->allowPasswordChange() ) {
1735 throw new PasswordError( wfMsg( 'password-change-forbidden' ) );
1736 }
1737
1738 $valid = $this->isValidPassword( $str );
1739 if( $valid !== true ) {
1740 global $wgMinimalPasswordLength;
1741 throw new PasswordError( wfMsgExt( $valid, array( 'parsemag' ),
1742 $wgMinimalPasswordLength ) );
1743 }
1744 }
1745
1746 if( !$wgAuth->setPassword( $this, $str ) ) {
1747 throw new PasswordError( wfMsg( 'externaldberror' ) );
1748 }
1749
1750 $this->setInternalPassword( $str );
1751
1752 return true;
1753 }
1754
1755 /**
1756 * Set the password and reset the random token unconditionally.
1757 *
1758 * @param $str \string New password to set
1759 */
1760 function setInternalPassword( $str ) {
1761 $this->load();
1762 $this->setToken();
1763
1764 if( $str === null ) {
1765 // Save an invalid hash...
1766 $this->mPassword = '';
1767 } else {
1768 $this->mPassword = self::crypt( $str );
1769 }
1770 $this->mNewpassword = '';
1771 $this->mNewpassTime = null;
1772 }
1773
1774 /**
1775 * Get the user's current token.
1776 * @return \string Token
1777 */
1778 function getToken() {
1779 $this->load();
1780 return $this->mToken;
1781 }
1782
1783 /**
1784 * Set the random token (used for persistent authentication)
1785 * Called from loadDefaults() among other places.
1786 *
1787 * @param $token \string If specified, set the token to this value
1788 * @private
1789 */
1790 function setToken( $token = false ) {
1791 global $wgSecretKey, $wgProxyKey;
1792 $this->load();
1793 if ( !$token ) {
1794 if ( $wgSecretKey ) {
1795 $key = $wgSecretKey;
1796 } elseif ( $wgProxyKey ) {
1797 $key = $wgProxyKey;
1798 } else {
1799 $key = microtime();
1800 }
1801 $this->mToken = md5( $key . mt_rand( 0, 0x7fffffff ) . wfWikiID() . $this->mId );
1802 } else {
1803 $this->mToken = $token;
1804 }
1805 }
1806
1807 /**
1808 * Set the cookie password
1809 *
1810 * @param $str \string New cookie password
1811 * @private
1812 */
1813 function setCookiePassword( $str ) {
1814 $this->load();
1815 $this->mCookiePassword = md5( $str );
1816 }
1817
1818 /**
1819 * Set the password for a password reminder or new account email
1820 *
1821 * @param $str \string New password to set
1822 * @param $throttle \bool If true, reset the throttle timestamp to the present
1823 */
1824 function setNewpassword( $str, $throttle = true ) {
1825 $this->load();
1826 $this->mNewpassword = self::crypt( $str );
1827 if ( $throttle ) {
1828 $this->mNewpassTime = wfTimestampNow();
1829 }
1830 }
1831
1832 /**
1833 * Has password reminder email been sent within the last
1834 * $wgPasswordReminderResendTime hours?
1835 * @return \bool True or false
1836 */
1837 function isPasswordReminderThrottled() {
1838 global $wgPasswordReminderResendTime;
1839 $this->load();
1840 if ( !$this->mNewpassTime || !$wgPasswordReminderResendTime ) {
1841 return false;
1842 }
1843 $expiry = wfTimestamp( TS_UNIX, $this->mNewpassTime ) + $wgPasswordReminderResendTime * 3600;
1844 return time() < $expiry;
1845 }
1846
1847 /**
1848 * Get the user's e-mail address
1849 * @return \string User's email address
1850 */
1851 function getEmail() {
1852 $this->load();
1853 wfRunHooks( 'UserGetEmail', array( $this, &$this->mEmail ) );
1854 return $this->mEmail;
1855 }
1856
1857 /**
1858 * Get the timestamp of the user's e-mail authentication
1859 * @return \string TS_MW timestamp
1860 */
1861 function getEmailAuthenticationTimestamp() {
1862 $this->load();
1863 wfRunHooks( 'UserGetEmailAuthenticationTimestamp', array( $this, &$this->mEmailAuthenticated ) );
1864 return $this->mEmailAuthenticated;
1865 }
1866
1867 /**
1868 * Set the user's e-mail address
1869 * @param $str \string New e-mail address
1870 */
1871 function setEmail( $str ) {
1872 $this->load();
1873 $this->mEmail = $str;
1874 wfRunHooks( 'UserSetEmail', array( $this, &$this->mEmail ) );
1875 }
1876
1877 /**
1878 * Get the user's real name
1879 * @return \string User's real name
1880 */
1881 function getRealName() {
1882 $this->load();
1883 return $this->mRealName;
1884 }
1885
1886 /**
1887 * Set the user's real name
1888 * @param $str \string New real name
1889 */
1890 function setRealName( $str ) {
1891 $this->load();
1892 $this->mRealName = $str;
1893 }
1894
1895 /**
1896 * Get the user's current setting for a given option.
1897 *
1898 * @param $oname \string The option to check
1899 * @param $defaultOverride \string A default value returned if the option does not exist
1900 * @return \string User's current value for the option
1901 * @see getBoolOption()
1902 * @see getIntOption()
1903 */
1904 function getOption( $oname, $defaultOverride = null ) {
1905 $this->loadOptions();
1906
1907 if ( is_null( $this->mOptions ) ) {
1908 if($defaultOverride != '') {
1909 return $defaultOverride;
1910 }
1911 $this->mOptions = User::getDefaultOptions();
1912 }
1913
1914 if ( array_key_exists( $oname, $this->mOptions ) ) {
1915 return $this->mOptions[$oname];
1916 } else {
1917 return $defaultOverride;
1918 }
1919 }
1920
1921 /**
1922 * Get the user's current setting for a given option, as a boolean value.
1923 *
1924 * @param $oname \string The option to check
1925 * @return \bool User's current value for the option
1926 * @see getOption()
1927 */
1928 function getBoolOption( $oname ) {
1929 return (bool)$this->getOption( $oname );
1930 }
1931
1932
1933 /**
1934 * Get the user's current setting for a given option, as a boolean value.
1935 *
1936 * @param $oname \string The option to check
1937 * @param $defaultOverride \int A default value returned if the option does not exist
1938 * @return \int User's current value for the option
1939 * @see getOption()
1940 */
1941 function getIntOption( $oname, $defaultOverride=0 ) {
1942 $val = $this->getOption( $oname );
1943 if( $val == '' ) {
1944 $val = $defaultOverride;
1945 }
1946 return intval( $val );
1947 }
1948
1949 /**
1950 * Set the given option for a user.
1951 *
1952 * @param $oname \string The option to set
1953 * @param $val \mixed New value to set
1954 */
1955 function setOption( $oname, $val ) {
1956 $this->load();
1957 $this->loadOptions();
1958
1959 if ( $oname == 'skin' ) {
1960 # Clear cached skin, so the new one displays immediately in Special:Preferences
1961 unset( $this->mSkin );
1962 }
1963
1964 // Explicitly NULL values should refer to defaults
1965 global $wgDefaultUserOptions;
1966 if( is_null($val) && isset($wgDefaultUserOptions[$oname]) ) {
1967 $val = $wgDefaultUserOptions[$oname];
1968 }
1969
1970 $this->mOptions[$oname] = $val;
1971 }
1972
1973 /**
1974 * Reset all options to the site defaults
1975 */
1976 function resetOptions() {
1977 $this->mOptions = User::getDefaultOptions();
1978 }
1979
1980 /**
1981 * Get the user's preferred date format.
1982 * @return \string User's preferred date format
1983 */
1984 function getDatePreference() {
1985 // Important migration for old data rows
1986 if ( is_null( $this->mDatePreference ) ) {
1987 global $wgLang;
1988 $value = $this->getOption( 'date' );
1989 $map = $wgLang->getDatePreferenceMigrationMap();
1990 if ( isset( $map[$value] ) ) {
1991 $value = $map[$value];
1992 }
1993 $this->mDatePreference = $value;
1994 }
1995 return $this->mDatePreference;
1996 }
1997
1998 /**
1999 * Get the permissions this user has.
2000 * @return \type{\arrayof{\string}} Array of permission names
2001 */
2002 function getRights() {
2003 if ( is_null( $this->mRights ) ) {
2004 $this->mRights = self::getGroupPermissions( $this->getEffectiveGroups() );
2005 wfRunHooks( 'UserGetRights', array( $this, &$this->mRights ) );
2006 // Force reindexation of rights when a hook has unset one of them
2007 $this->mRights = array_values( $this->mRights );
2008 }
2009 return $this->mRights;
2010 }
2011
2012 /**
2013 * Get the list of explicit group memberships this user has.
2014 * The implicit * and user groups are not included.
2015 * @return \type{\arrayof{\string}} Array of internal group names
2016 */
2017 function getGroups() {
2018 $this->load();
2019 return $this->mGroups;
2020 }
2021
2022 /**
2023 * Get the list of implicit group memberships this user has.
2024 * This includes all explicit groups, plus 'user' if logged in,
2025 * '*' for all accounts and autopromoted groups
2026 * @param $recache \bool Whether to avoid the cache
2027 * @return \type{\arrayof{\string}} Array of internal group names
2028 */
2029 function getEffectiveGroups( $recache = false ) {
2030 if ( $recache || is_null( $this->mEffectiveGroups ) ) {
2031 $this->mEffectiveGroups = $this->getGroups();
2032 $this->mEffectiveGroups[] = '*';
2033 if( $this->getId() ) {
2034 $this->mEffectiveGroups[] = 'user';
2035
2036 $this->mEffectiveGroups = array_unique( array_merge(
2037 $this->mEffectiveGroups,
2038 Autopromote::getAutopromoteGroups( $this )
2039 ) );
2040
2041 # Hook for additional groups
2042 wfRunHooks( 'UserEffectiveGroups', array( &$this, &$this->mEffectiveGroups ) );
2043 }
2044 }
2045 return $this->mEffectiveGroups;
2046 }
2047
2048 /**
2049 * Get the user's edit count.
2050 * @return \int User'e edit count
2051 */
2052 function getEditCount() {
2053 if ($this->getId()) {
2054 if ( !isset( $this->mEditCount ) ) {
2055 /* Populate the count, if it has not been populated yet */
2056 $this->mEditCount = User::edits($this->mId);
2057 }
2058 return $this->mEditCount;
2059 } else {
2060 /* nil */
2061 return null;
2062 }
2063 }
2064
2065 /**
2066 * Add the user to the given group.
2067 * This takes immediate effect.
2068 * @param $group \string Name of the group to add
2069 */
2070 function addGroup( $group ) {
2071 $dbw = wfGetDB( DB_MASTER );
2072 if( $this->getId() ) {
2073 $dbw->insert( 'user_groups',
2074 array(
2075 'ug_user' => $this->getID(),
2076 'ug_group' => $group,
2077 ),
2078 'User::addGroup',
2079 array( 'IGNORE' ) );
2080 }
2081
2082 $this->loadGroups();
2083 $this->mGroups[] = $group;
2084 $this->mRights = User::getGroupPermissions( $this->getEffectiveGroups( true ) );
2085
2086 $this->invalidateCache();
2087 }
2088
2089 /**
2090 * Remove the user from the given group.
2091 * This takes immediate effect.
2092 * @param $group \string Name of the group to remove
2093 */
2094 function removeGroup( $group ) {
2095 $this->load();
2096 $dbw = wfGetDB( DB_MASTER );
2097 $dbw->delete( 'user_groups',
2098 array(
2099 'ug_user' => $this->getID(),
2100 'ug_group' => $group,
2101 ),
2102 'User::removeGroup' );
2103
2104 $this->loadGroups();
2105 $this->mGroups = array_diff( $this->mGroups, array( $group ) );
2106 $this->mRights = User::getGroupPermissions( $this->getEffectiveGroups( true ) );
2107
2108 $this->invalidateCache();
2109 }
2110
2111
2112 /**
2113 * Get whether the user is logged in
2114 * @return \bool True or false
2115 */
2116 function isLoggedIn() {
2117 return $this->getID() != 0;
2118 }
2119
2120 /**
2121 * Get whether the user is anonymous
2122 * @return \bool True or false
2123 */
2124 function isAnon() {
2125 return !$this->isLoggedIn();
2126 }
2127
2128 /**
2129 * Get whether the user is a bot
2130 * @return \bool True or false
2131 * @deprecated
2132 */
2133 function isBot() {
2134 wfDeprecated( __METHOD__ );
2135 return $this->isAllowed( 'bot' );
2136 }
2137
2138 /**
2139 * Check if user is allowed to access a feature / make an action
2140 * @param $action \string action to be checked
2141 * @return \bool True if action is allowed, else false
2142 */
2143 function isAllowed( $action = '' ) {
2144 if ( $action === '' )
2145 return true; // In the spirit of DWIM
2146 # Patrolling may not be enabled
2147 if( $action === 'patrol' || $action === 'autopatrol' ) {
2148 global $wgUseRCPatrol, $wgUseNPPatrol;
2149 if( !$wgUseRCPatrol && !$wgUseNPPatrol )
2150 return false;
2151 }
2152 # Use strict parameter to avoid matching numeric 0 accidentally inserted
2153 # by misconfiguration: 0 == 'foo'
2154 return in_array( $action, $this->getRights(), true );
2155 }
2156
2157 /**
2158 * Check whether to enable recent changes patrol features for this user
2159 * @return \bool True or false
2160 */
2161 public function useRCPatrol() {
2162 global $wgUseRCPatrol;
2163 return( $wgUseRCPatrol && ($this->isAllowed('patrol') || $this->isAllowed('patrolmarks')) );
2164 }
2165
2166 /**
2167 * Check whether to enable new pages patrol features for this user
2168 * @return \bool True or false
2169 */
2170 public function useNPPatrol() {
2171 global $wgUseRCPatrol, $wgUseNPPatrol;
2172 return( ($wgUseRCPatrol || $wgUseNPPatrol) && ($this->isAllowed('patrol') || $this->isAllowed('patrolmarks')) );
2173 }
2174
2175 /**
2176 * Get the current skin, loading it if required, and setting a title
2177 * @param $t Title: the title to use in the skin
2178 * @return Skin The current skin
2179 * @todo FIXME : need to check the old failback system [AV]
2180 */
2181 function &getSkin( $t = null ) {
2182 if ( ! isset( $this->mSkin ) ) {
2183 wfProfileIn( __METHOD__ );
2184
2185 global $wgHiddenPrefs;
2186 if( !in_array( 'skin', $wgHiddenPrefs ) ) {
2187 # get the user skin
2188 global $wgRequest;
2189 $userSkin = $this->getOption( 'skin' );
2190 $userSkin = $wgRequest->getVal('useskin', $userSkin);
2191 } else {
2192 # if we're not allowing users to override, then use the default
2193 global $wgDefaultSkin;
2194 $userSkin = $wgDefaultSkin;
2195 }
2196
2197 $this->mSkin =& Skin::newFromKey( $userSkin );
2198 wfProfileOut( __METHOD__ );
2199 }
2200 if( $t || !$this->mSkin->getTitle() ) {
2201 if ( !$t ) {
2202 global $wgOut;
2203 $t = $wgOut->getTitle();
2204 }
2205 $this->mSkin->setTitle( $t );
2206 }
2207 return $this->mSkin;
2208 }
2209
2210 /**
2211 * Check the watched status of an article.
2212 * @param $title \type{Title} Title of the article to look at
2213 * @return \bool True if article is watched
2214 */
2215 function isWatched( $title ) {
2216 $wl = WatchedItem::fromUserTitle( $this, $title );
2217 return $wl->isWatched();
2218 }
2219
2220 /**
2221 * Watch an article.
2222 * @param $title \type{Title} Title of the article to look at
2223 */
2224 function addWatch( $title ) {
2225 $wl = WatchedItem::fromUserTitle( $this, $title );
2226 $wl->addWatch();
2227 $this->invalidateCache();
2228 }
2229
2230 /**
2231 * Stop watching an article.
2232 * @param $title \type{Title} Title of the article to look at
2233 */
2234 function removeWatch( $title ) {
2235 $wl = WatchedItem::fromUserTitle( $this, $title );
2236 $wl->removeWatch();
2237 $this->invalidateCache();
2238 }
2239
2240 /**
2241 * Clear the user's notification timestamp for the given title.
2242 * If e-notif e-mails are on, they will receive notification mails on
2243 * the next change of the page if it's watched etc.
2244 * @param $title \type{Title} Title of the article to look at
2245 */
2246 function clearNotification( &$title ) {
2247 global $wgUser, $wgUseEnotif, $wgShowUpdatedMarker;
2248
2249 # Do nothing if the database is locked to writes
2250 if( wfReadOnly() ) {
2251 return;
2252 }
2253
2254 if ($title->getNamespace() == NS_USER_TALK &&
2255 $title->getText() == $this->getName() ) {
2256 if (!wfRunHooks('UserClearNewTalkNotification', array(&$this)))
2257 return;
2258 $this->setNewtalk( false );
2259 }
2260
2261 if( !$wgUseEnotif && !$wgShowUpdatedMarker ) {
2262 return;
2263 }
2264
2265 if( $this->isAnon() ) {
2266 // Nothing else to do...
2267 return;
2268 }
2269
2270 // Only update the timestamp if the page is being watched.
2271 // The query to find out if it is watched is cached both in memcached and per-invocation,
2272 // and when it does have to be executed, it can be on a slave
2273 // If this is the user's newtalk page, we always update the timestamp
2274 if ($title->getNamespace() == NS_USER_TALK &&
2275 $title->getText() == $wgUser->getName())
2276 {
2277 $watched = true;
2278 } elseif ( $this->getId() == $wgUser->getId() ) {
2279 $watched = $title->userIsWatching();
2280 } else {
2281 $watched = true;
2282 }
2283
2284 // If the page is watched by the user (or may be watched), update the timestamp on any
2285 // any matching rows
2286 if ( $watched ) {
2287 $dbw = wfGetDB( DB_MASTER );
2288 $dbw->update( 'watchlist',
2289 array( /* SET */
2290 'wl_notificationtimestamp' => NULL
2291 ), array( /* WHERE */
2292 'wl_title' => $title->getDBkey(),
2293 'wl_namespace' => $title->getNamespace(),
2294 'wl_user' => $this->getID()
2295 ), __METHOD__
2296 );
2297 }
2298 }
2299
2300 /**
2301 * Resets all of the given user's page-change notification timestamps.
2302 * If e-notif e-mails are on, they will receive notification mails on
2303 * the next change of any watched page.
2304 *
2305 * @param $currentUser \int User ID
2306 */
2307 function clearAllNotifications( $currentUser ) {
2308 global $wgUseEnotif, $wgShowUpdatedMarker;
2309 if ( !$wgUseEnotif && !$wgShowUpdatedMarker ) {
2310 $this->setNewtalk( false );
2311 return;
2312 }
2313 if( $currentUser != 0 ) {
2314 $dbw = wfGetDB( DB_MASTER );
2315 $dbw->update( 'watchlist',
2316 array( /* SET */
2317 'wl_notificationtimestamp' => NULL
2318 ), array( /* WHERE */
2319 'wl_user' => $currentUser
2320 ), __METHOD__
2321 );
2322 # We also need to clear here the "you have new message" notification for the own user_talk page
2323 # This is cleared one page view later in Article::viewUpdates();
2324 }
2325 }
2326
2327 /**
2328 * Set this user's options from an encoded string
2329 * @param $str \string Encoded options to import
2330 * @private
2331 */
2332 function decodeOptions( $str ) {
2333 if (!$str)
2334 return;
2335
2336 $this->mOptionsLoaded = true;
2337 $this->mOptionOverrides = array();
2338
2339 $this->mOptions = array();
2340 $a = explode( "\n", $str );
2341 foreach ( $a as $s ) {
2342 $m = array();
2343 if ( preg_match( "/^(.[^=]*)=(.*)$/", $s, $m ) ) {
2344 $this->mOptions[$m[1]] = $m[2];
2345 $this->mOptionOverrides[$m[1]] = $m[2];
2346 }
2347 }
2348 }
2349
2350 /**
2351 * Set a cookie on the user's client. Wrapper for
2352 * WebResponse::setCookie
2353 * @param $name \string Name of the cookie to set
2354 * @param $value \string Value to set
2355 * @param $exp \int Expiration time, as a UNIX time value;
2356 * if 0 or not specified, use the default $wgCookieExpiration
2357 */
2358 protected function setCookie( $name, $value, $exp=0 ) {
2359 global $wgRequest;
2360 $wgRequest->response()->setcookie( $name, $value, $exp );
2361 }
2362
2363 /**
2364 * Clear a cookie on the user's client
2365 * @param $name \string Name of the cookie to clear
2366 */
2367 protected function clearCookie( $name ) {
2368 $this->setCookie( $name, '', time() - 86400 );
2369 }
2370
2371 /**
2372 * Set the default cookies for this session on the user's client.
2373 */
2374 function setCookies() {
2375 $this->load();
2376 if ( 0 == $this->mId ) return;
2377 $session = array(
2378 'wsUserID' => $this->mId,
2379 'wsToken' => $this->mToken,
2380 'wsUserName' => $this->getName()
2381 );
2382 $cookies = array(
2383 'UserID' => $this->mId,
2384 'UserName' => $this->getName(),
2385 );
2386 if ( 1 == $this->getOption( 'rememberpassword' ) ) {
2387 $cookies['Token'] = $this->mToken;
2388 } else {
2389 $cookies['Token'] = false;
2390 }
2391
2392 wfRunHooks( 'UserSetCookies', array( $this, &$session, &$cookies ) );
2393 #check for null, since the hook could cause a null value
2394 if ( !is_null( $session ) && isset( $_SESSION ) ){
2395 $_SESSION = $session + $_SESSION;
2396 }
2397 foreach ( $cookies as $name => $value ) {
2398 if ( $value === false ) {
2399 $this->clearCookie( $name );
2400 } else {
2401 $this->setCookie( $name, $value );
2402 }
2403 }
2404 }
2405
2406 /**
2407 * Log this user out.
2408 */
2409 function logout() {
2410 if( wfRunHooks( 'UserLogout', array(&$this) ) ) {
2411 $this->doLogout();
2412 }
2413 }
2414
2415 /**
2416 * Clear the user's cookies and session, and reset the instance cache.
2417 * @private
2418 * @see logout()
2419 */
2420 function doLogout() {
2421 $this->clearInstanceCache( 'defaults' );
2422
2423 $_SESSION['wsUserID'] = 0;
2424
2425 $this->clearCookie( 'UserID' );
2426 $this->clearCookie( 'Token' );
2427
2428 # Remember when user logged out, to prevent seeing cached pages
2429 $this->setCookie( 'LoggedOut', wfTimestampNow(), time() + 86400 );
2430 }
2431
2432 /**
2433 * Save this user's settings into the database.
2434 * @todo Only rarely do all these fields need to be set!
2435 */
2436 function saveSettings() {
2437 $this->load();
2438 if ( wfReadOnly() ) { return; }
2439 if ( 0 == $this->mId ) { return; }
2440
2441 $this->mTouched = self::newTouchedTimestamp();
2442
2443 $dbw = wfGetDB( DB_MASTER );
2444 $dbw->update( 'user',
2445 array( /* SET */
2446 'user_name' => $this->mName,
2447 'user_password' => $this->mPassword,
2448 'user_newpassword' => $this->mNewpassword,
2449 'user_newpass_time' => $dbw->timestampOrNull( $this->mNewpassTime ),
2450 'user_real_name' => $this->mRealName,
2451 'user_email' => $this->mEmail,
2452 'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
2453 'user_options' => '',
2454 'user_touched' => $dbw->timestamp($this->mTouched),
2455 'user_token' => $this->mToken,
2456 'user_email_token' => $this->mEmailToken,
2457 'user_email_token_expires' => $dbw->timestampOrNull( $this->mEmailTokenExpires ),
2458 ), array( /* WHERE */
2459 'user_id' => $this->mId
2460 ), __METHOD__
2461 );
2462
2463 $this->saveOptions();
2464
2465 wfRunHooks( 'UserSaveSettings', array( $this ) );
2466 $this->clearSharedCache();
2467 $this->getUserPage()->invalidateCache();
2468 }
2469
2470 /**
2471 * If only this user's username is known, and it exists, return the user ID.
2472 */
2473 function idForName() {
2474 $s = trim( $this->getName() );
2475 if ( $s === '' ) return 0;
2476
2477 $dbr = wfGetDB( DB_SLAVE );
2478 $id = $dbr->selectField( 'user', 'user_id', array( 'user_name' => $s ), __METHOD__ );
2479 if ( $id === false ) {
2480 $id = 0;
2481 }
2482 return $id;
2483 }
2484
2485 /**
2486 * Add a user to the database, return the user object
2487 *
2488 * @param $name \string Username to add
2489 * @param $params \type{\arrayof{\string}} Non-default parameters to save to the database:
2490 * - password The user's password. Password logins will be disabled if this is omitted.
2491 * - newpassword A temporary password mailed to the user
2492 * - email The user's email address
2493 * - email_authenticated The email authentication timestamp
2494 * - real_name The user's real name
2495 * - options An associative array of non-default options
2496 * - token Random authentication token. Do not set.
2497 * - registration Registration timestamp. Do not set.
2498 *
2499 * @return \type{User} A new User object, or null if the username already exists
2500 */
2501 static function createNew( $name, $params = array() ) {
2502 $user = new User;
2503 $user->load();
2504 if ( isset( $params['options'] ) ) {
2505 $user->mOptions = $params['options'] + (array)$user->mOptions;
2506 unset( $params['options'] );
2507 }
2508 $dbw = wfGetDB( DB_MASTER );
2509 $seqVal = $dbw->nextSequenceValue( 'user_user_id_seq' );
2510 $fields = array(
2511 'user_id' => $seqVal,
2512 'user_name' => $name,
2513 'user_password' => $user->mPassword,
2514 'user_newpassword' => $user->mNewpassword,
2515 'user_newpass_time' => $dbw->timestamp( $user->mNewpassTime ),
2516 'user_email' => $user->mEmail,
2517 'user_email_authenticated' => $dbw->timestampOrNull( $user->mEmailAuthenticated ),
2518 'user_real_name' => $user->mRealName,
2519 'user_options' => '',
2520 'user_token' => $user->mToken,
2521 'user_registration' => $dbw->timestamp( $user->mRegistration ),
2522 'user_editcount' => 0,
2523 );
2524 foreach ( $params as $name => $value ) {
2525 $fields["user_$name"] = $value;
2526 }
2527 $dbw->insert( 'user', $fields, __METHOD__, array( 'IGNORE' ) );
2528 if ( $dbw->affectedRows() ) {
2529 $newUser = User::newFromId( $dbw->insertId() );
2530 } else {
2531 $newUser = null;
2532 }
2533 return $newUser;
2534 }
2535
2536 /**
2537 * Add this existing user object to the database
2538 */
2539 function addToDatabase() {
2540 $this->load();
2541 $dbw = wfGetDB( DB_MASTER );
2542 $seqVal = $dbw->nextSequenceValue( 'user_user_id_seq' );
2543 $dbw->insert( 'user',
2544 array(
2545 'user_id' => $seqVal,
2546 'user_name' => $this->mName,
2547 'user_password' => $this->mPassword,
2548 'user_newpassword' => $this->mNewpassword,
2549 'user_newpass_time' => $dbw->timestamp( $this->mNewpassTime ),
2550 'user_email' => $this->mEmail,
2551 'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
2552 'user_real_name' => $this->mRealName,
2553 'user_options' => '',
2554 'user_token' => $this->mToken,
2555 'user_registration' => $dbw->timestamp( $this->mRegistration ),
2556 'user_editcount' => 0,
2557 ), __METHOD__
2558 );
2559 $this->mId = $dbw->insertId();
2560
2561 // Clear instance cache other than user table data, which is already accurate
2562 $this->clearInstanceCache();
2563
2564 $this->saveOptions();
2565 }
2566
2567 /**
2568 * If this (non-anonymous) user is blocked, block any IP address
2569 * they've successfully logged in from.
2570 */
2571 function spreadBlock() {
2572 wfDebug( __METHOD__."()\n" );
2573 $this->load();
2574 if ( $this->mId == 0 ) {
2575 return;
2576 }
2577
2578 $userblock = Block::newFromDB( '', $this->mId );
2579 if ( !$userblock ) {
2580 return;
2581 }
2582
2583 $userblock->doAutoblock( wfGetIp() );
2584
2585 }
2586
2587 /**
2588 * Generate a string which will be different for any combination of
2589 * user options which would produce different parser output.
2590 * This will be used as part of the hash key for the parser cache,
2591 * so users will the same options can share the same cached data
2592 * safely.
2593 *
2594 * Extensions which require it should install 'PageRenderingHash' hook,
2595 * which will give them a chance to modify this key based on their own
2596 * settings.
2597 *
2598 * @return \string Page rendering hash
2599 */
2600 function getPageRenderingHash() {
2601 global $wgUseDynamicDates, $wgRenderHashAppend, $wgLang, $wgContLang;
2602 if( $this->mHash ){
2603 return $this->mHash;
2604 }
2605
2606 // stubthreshold is only included below for completeness,
2607 // it will always be 0 when this function is called by parsercache.
2608
2609 $confstr = $this->getOption( 'math' );
2610 $confstr .= '!' . $this->getOption( 'stubthreshold' );
2611 if ( $wgUseDynamicDates ) {
2612 $confstr .= '!' . $this->getDatePreference();
2613 }
2614 $confstr .= '!' . ($this->getOption( 'numberheadings' ) ? '1' : '');
2615 $confstr .= '!' . $wgLang->getCode();
2616 $confstr .= '!' . $this->getOption( 'thumbsize' );
2617 // add in language specific options, if any
2618 $extra = $wgContLang->getExtraHashOptions();
2619 $confstr .= $extra;
2620
2621 $confstr .= $wgRenderHashAppend;
2622
2623 // Give a chance for extensions to modify the hash, if they have
2624 // extra options or other effects on the parser cache.
2625 wfRunHooks( 'PageRenderingHash', array( &$confstr ) );
2626
2627 // Make it a valid memcached key fragment
2628 $confstr = str_replace( ' ', '_', $confstr );
2629 $this->mHash = $confstr;
2630 return $confstr;
2631 }
2632
2633 /**
2634 * Get whether the user is explicitly blocked from account creation.
2635 * @return \bool True if blocked
2636 */
2637 function isBlockedFromCreateAccount() {
2638 $this->getBlockedStatus();
2639 return $this->mBlock && $this->mBlock->mCreateAccount;
2640 }
2641
2642 /**
2643 * Get whether the user is blocked from using Special:Emailuser.
2644 * @return \bool True if blocked
2645 */
2646 function isBlockedFromEmailuser() {
2647 $this->getBlockedStatus();
2648 return $this->mBlock && $this->mBlock->mBlockEmail;
2649 }
2650
2651 /**
2652 * Get whether the user is allowed to create an account.
2653 * @return \bool True if allowed
2654 */
2655 function isAllowedToCreateAccount() {
2656 return $this->isAllowed( 'createaccount' ) && !$this->isBlockedFromCreateAccount();
2657 }
2658
2659 /**
2660 * @deprecated
2661 */
2662 function setLoaded( $loaded ) {
2663 wfDeprecated( __METHOD__ );
2664 }
2665
2666 /**
2667 * Get this user's personal page title.
2668 *
2669 * @return \type{Title} User's personal page title
2670 */
2671 function getUserPage() {
2672 return Title::makeTitle( NS_USER, $this->getName() );
2673 }
2674
2675 /**
2676 * Get this user's talk page title.
2677 *
2678 * @return \type{Title} User's talk page title
2679 */
2680 function getTalkPage() {
2681 $title = $this->getUserPage();
2682 return $title->getTalkPage();
2683 }
2684
2685 /**
2686 * Get the maximum valid user ID.
2687 * @return \int User ID
2688 * @static
2689 */
2690 function getMaxID() {
2691 static $res; // cache
2692
2693 if ( isset( $res ) )
2694 return $res;
2695 else {
2696 $dbr = wfGetDB( DB_SLAVE );
2697 return $res = $dbr->selectField( 'user', 'max(user_id)', false, 'User::getMaxID' );
2698 }
2699 }
2700
2701 /**
2702 * Determine whether the user is a newbie. Newbies are either
2703 * anonymous IPs, or the most recently created accounts.
2704 * @return \bool True if the user is a newbie
2705 */
2706 function isNewbie() {
2707 return !$this->isAllowed( 'autoconfirmed' );
2708 }
2709
2710 /**
2711 * Check to see if the given clear-text password is one of the accepted passwords
2712 * @param $password \string user password.
2713 * @return \bool True if the given password is correct, otherwise False.
2714 */
2715 function checkPassword( $password ) {
2716 global $wgAuth;
2717 $this->load();
2718
2719 // Even though we stop people from creating passwords that
2720 // are shorter than this, doesn't mean people wont be able
2721 // to. Certain authentication plugins do NOT want to save
2722 // domain passwords in a mysql database, so we should
2723 // check this (incase $wgAuth->strict() is false).
2724 if( $this->isValidPassword( $password ) !== true ) {
2725 return false;
2726 }
2727
2728 if( $wgAuth->authenticate( $this->getName(), $password ) ) {
2729 return true;
2730 } elseif( $wgAuth->strict() ) {
2731 /* Auth plugin doesn't allow local authentication */
2732 return false;
2733 } elseif( $wgAuth->strictUserAuth( $this->getName() ) ) {
2734 /* Auth plugin doesn't allow local authentication for this user name */
2735 return false;
2736 }
2737 if ( self::comparePasswords( $this->mPassword, $password, $this->mId ) ) {
2738 return true;
2739 } elseif ( function_exists( 'iconv' ) ) {
2740 # Some wikis were converted from ISO 8859-1 to UTF-8, the passwords can't be converted
2741 # Check for this with iconv
2742 $cp1252Password = iconv( 'UTF-8', 'WINDOWS-1252//TRANSLIT', $password );
2743 if ( self::comparePasswords( $this->mPassword, $cp1252Password, $this->mId ) ) {
2744 return true;
2745 }
2746 }
2747 return false;
2748 }
2749
2750 /**
2751 * Check if the given clear-text password matches the temporary password
2752 * sent by e-mail for password reset operations.
2753 * @return \bool True if matches, false otherwise
2754 */
2755 function checkTemporaryPassword( $plaintext ) {
2756 global $wgNewPasswordExpiry;
2757 if( self::comparePasswords( $this->mNewpassword, $plaintext, $this->getId() ) ) {
2758 $this->load();
2759 $expiry = wfTimestamp( TS_UNIX, $this->mNewpassTime ) + $wgNewPasswordExpiry;
2760 return ( time() < $expiry );
2761 } else {
2762 return false;
2763 }
2764 }
2765
2766 /**
2767 * Initialize (if necessary) and return a session token value
2768 * which can be used in edit forms to show that the user's
2769 * login credentials aren't being hijacked with a foreign form
2770 * submission.
2771 *
2772 * @param $salt \types{\string,\arrayof{\string}} Optional function-specific data for hashing
2773 * @return \string The new edit token
2774 */
2775 function editToken( $salt = '' ) {
2776 if ( $this->isAnon() ) {
2777 return EDIT_TOKEN_SUFFIX;
2778 } else {
2779 if( !isset( $_SESSION['wsEditToken'] ) ) {
2780 $token = $this->generateToken();
2781 $_SESSION['wsEditToken'] = $token;
2782 } else {
2783 $token = $_SESSION['wsEditToken'];
2784 }
2785 if( is_array( $salt ) ) {
2786 $salt = implode( '|', $salt );
2787 }
2788 return md5( $token . $salt ) . EDIT_TOKEN_SUFFIX;
2789 }
2790 }
2791
2792 /**
2793 * Generate a looking random token for various uses.
2794 *
2795 * @param $salt \string Optional salt value
2796 * @return \string The new random token
2797 */
2798 function generateToken( $salt = '' ) {
2799 $token = dechex( mt_rand() ) . dechex( mt_rand() );
2800 return md5( $token . $salt );
2801 }
2802
2803 /**
2804 * Check given value against the token value stored in the session.
2805 * A match should confirm that the form was submitted from the
2806 * user's own login session, not a form submission from a third-party
2807 * site.
2808 *
2809 * @param $val \string Input value to compare
2810 * @param $salt \string Optional function-specific data for hashing
2811 * @return \bool Whether the token matches
2812 */
2813 function matchEditToken( $val, $salt = '' ) {
2814 $sessionToken = $this->editToken( $salt );
2815 if ( $val != $sessionToken ) {
2816 wfDebug( "User::matchEditToken: broken session data\n" );
2817 }
2818 return $val == $sessionToken;
2819 }
2820
2821 /**
2822 * Check given value against the token value stored in the session,
2823 * ignoring the suffix.
2824 *
2825 * @param $val \string Input value to compare
2826 * @param $salt \string Optional function-specific data for hashing
2827 * @return \bool Whether the token matches
2828 */
2829 function matchEditTokenNoSuffix( $val, $salt = '' ) {
2830 $sessionToken = $this->editToken( $salt );
2831 return substr( $sessionToken, 0, 32 ) == substr( $val, 0, 32 );
2832 }
2833
2834 /**
2835 * Generate a new e-mail confirmation token and send a confirmation/invalidation
2836 * mail to the user's given address.
2837 *
2838 * @return \types{\bool,\type{WikiError}} True on success, a WikiError object on failure.
2839 */
2840 function sendConfirmationMail() {
2841 global $wgLang;
2842 $expiration = null; // gets passed-by-ref and defined in next line.
2843 $token = $this->confirmationToken( $expiration );
2844 $url = $this->confirmationTokenUrl( $token );
2845 $invalidateURL = $this->invalidationTokenUrl( $token );
2846 $this->saveSettings();
2847
2848 return $this->sendMail( wfMsg( 'confirmemail_subject' ),
2849 wfMsg( 'confirmemail_body',
2850 wfGetIP(),
2851 $this->getName(),
2852 $url,
2853 $wgLang->timeanddate( $expiration, false ),
2854 $invalidateURL,
2855 $wgLang->date( $expiration, false ),
2856 $wgLang->time( $expiration, false ) ) );
2857 }
2858
2859 /**
2860 * Send an e-mail to this user's account. Does not check for
2861 * confirmed status or validity.
2862 *
2863 * @param $subject \string Message subject
2864 * @param $body \string Message body
2865 * @param $from \string Optional From address; if unspecified, default $wgPasswordSender will be used
2866 * @param $replyto \string Reply-To address
2867 * @return \types{\bool,\type{WikiError}} True on success, a WikiError object on failure
2868 */
2869 function sendMail( $subject, $body, $from = null, $replyto = null ) {
2870 if( is_null( $from ) ) {
2871 global $wgPasswordSender;
2872 $from = $wgPasswordSender;
2873 }
2874
2875 $to = new MailAddress( $this );
2876 $sender = new MailAddress( $from );
2877 return UserMailer::send( $to, $sender, $subject, $body, $replyto );
2878 }
2879
2880 /**
2881 * Generate, store, and return a new e-mail confirmation code.
2882 * A hash (unsalted, since it's used as a key) is stored.
2883 *
2884 * @note Call saveSettings() after calling this function to commit
2885 * this change to the database.
2886 *
2887 * @param[out] &$expiration \mixed Accepts the expiration time
2888 * @return \string New token
2889 * @private
2890 */
2891 function confirmationToken( &$expiration ) {
2892 $now = time();
2893 $expires = $now + 7 * 24 * 60 * 60;
2894 $expiration = wfTimestamp( TS_MW, $expires );
2895 $token = $this->generateToken( $this->mId . $this->mEmail . $expires );
2896 $hash = md5( $token );
2897 $this->load();
2898 $this->mEmailToken = $hash;
2899 $this->mEmailTokenExpires = $expiration;
2900 return $token;
2901 }
2902
2903 /**
2904 * Return a URL the user can use to confirm their email address.
2905 * @param $token \string Accepts the email confirmation token
2906 * @return \string New token URL
2907 * @private
2908 */
2909 function confirmationTokenUrl( $token ) {
2910 return $this->getTokenUrl( 'ConfirmEmail', $token );
2911 }
2912 /**
2913 * Return a URL the user can use to invalidate their email address.
2914 * @param $token \string Accepts the email confirmation token
2915 * @return \string New token URL
2916 * @private
2917 */
2918 function invalidationTokenUrl( $token ) {
2919 return $this->getTokenUrl( 'Invalidateemail', $token );
2920 }
2921
2922 /**
2923 * Internal function to format the e-mail validation/invalidation URLs.
2924 * This uses $wgArticlePath directly as a quickie hack to use the
2925 * hardcoded English names of the Special: pages, for ASCII safety.
2926 *
2927 * @note Since these URLs get dropped directly into emails, using the
2928 * short English names avoids insanely long URL-encoded links, which
2929 * also sometimes can get corrupted in some browsers/mailers
2930 * (bug 6957 with Gmail and Internet Explorer).
2931 *
2932 * @param $page \string Special page
2933 * @param $token \string Token
2934 * @return \string Formatted URL
2935 */
2936 protected function getTokenUrl( $page, $token ) {
2937 global $wgArticlePath;
2938 return wfExpandUrl(
2939 str_replace(
2940 '$1',
2941 "Special:$page/$token",
2942 $wgArticlePath ) );
2943 }
2944
2945 /**
2946 * Mark the e-mail address confirmed.
2947 *
2948 * @note Call saveSettings() after calling this function to commit the change.
2949 */
2950 function confirmEmail() {
2951 $this->setEmailAuthenticationTimestamp( wfTimestampNow() );
2952 return true;
2953 }
2954
2955 /**
2956 * Invalidate the user's e-mail confirmation, and unauthenticate the e-mail
2957 * address if it was already confirmed.
2958 *
2959 * @note Call saveSettings() after calling this function to commit the change.
2960 */
2961 function invalidateEmail() {
2962 $this->load();
2963 $this->mEmailToken = null;
2964 $this->mEmailTokenExpires = null;
2965 $this->setEmailAuthenticationTimestamp( null );
2966 return true;
2967 }
2968
2969 /**
2970 * Set the e-mail authentication timestamp.
2971 * @param $timestamp \string TS_MW timestamp
2972 */
2973 function setEmailAuthenticationTimestamp( $timestamp ) {
2974 $this->load();
2975 $this->mEmailAuthenticated = $timestamp;
2976 wfRunHooks( 'UserSetEmailAuthenticationTimestamp', array( $this, &$this->mEmailAuthenticated ) );
2977 }
2978
2979 /**
2980 * Is this user allowed to send e-mails within limits of current
2981 * site configuration?
2982 * @return \bool True if allowed
2983 */
2984 function canSendEmail() {
2985 global $wgEnableEmail, $wgEnableUserEmail;
2986 if( !$wgEnableEmail || !$wgEnableUserEmail ) {
2987 return false;
2988 }
2989 $canSend = $this->isEmailConfirmed();
2990 wfRunHooks( 'UserCanSendEmail', array( &$this, &$canSend ) );
2991 return $canSend;
2992 }
2993
2994 /**
2995 * Is this user allowed to receive e-mails within limits of current
2996 * site configuration?
2997 * @return \bool True if allowed
2998 */
2999 function canReceiveEmail() {
3000 return $this->isEmailConfirmed() && !$this->getOption( 'disablemail' );
3001 }
3002
3003 /**
3004 * Is this user's e-mail address valid-looking and confirmed within
3005 * limits of the current site configuration?
3006 *
3007 * @note If $wgEmailAuthentication is on, this may require the user to have
3008 * confirmed their address by returning a code or using a password
3009 * sent to the address from the wiki.
3010 *
3011 * @return \bool True if confirmed
3012 */
3013 function isEmailConfirmed() {
3014 global $wgEmailAuthentication;
3015 $this->load();
3016 $confirmed = true;
3017 if( wfRunHooks( 'EmailConfirmed', array( &$this, &$confirmed ) ) ) {
3018 if( $this->isAnon() )
3019 return false;
3020 if( !self::isValidEmailAddr( $this->mEmail ) )
3021 return false;
3022 if( $wgEmailAuthentication && !$this->getEmailAuthenticationTimestamp() )
3023 return false;
3024 return true;
3025 } else {
3026 return $confirmed;
3027 }
3028 }
3029
3030 /**
3031 * Check whether there is an outstanding request for e-mail confirmation.
3032 * @return \bool True if pending
3033 */
3034 function isEmailConfirmationPending() {
3035 global $wgEmailAuthentication;
3036 return $wgEmailAuthentication &&
3037 !$this->isEmailConfirmed() &&
3038 $this->mEmailToken &&
3039 $this->mEmailTokenExpires > wfTimestamp();
3040 }
3041
3042 /**
3043 * Get the timestamp of account creation.
3044 *
3045 * @return \types{\string,\bool} string Timestamp of account creation, or false for
3046 * non-existent/anonymous user accounts.
3047 */
3048 public function getRegistration() {
3049 return $this->getId() > 0
3050 ? $this->mRegistration
3051 : false;
3052 }
3053
3054 /**
3055 * Get the timestamp of the first edit
3056 *
3057 * @return \types{\string,\bool} string Timestamp of first edit, or false for
3058 * non-existent/anonymous user accounts.
3059 */
3060 public function getFirstEditTimestamp() {
3061 if( $this->getId() == 0 ) return false; // anons
3062 $dbr = wfGetDB( DB_SLAVE );
3063 $time = $dbr->selectField( 'revision', 'rev_timestamp',
3064 array( 'rev_user' => $this->getId() ),
3065 __METHOD__,
3066 array( 'ORDER BY' => 'rev_timestamp ASC' )
3067 );
3068 if( !$time ) return false; // no edits
3069 return wfTimestamp( TS_MW, $time );
3070 }
3071
3072 /**
3073 * Get the permissions associated with a given list of groups
3074 *
3075 * @param $groups \type{\arrayof{\string}} List of internal group names
3076 * @return \type{\arrayof{\string}} List of permission key names for given groups combined
3077 */
3078 static function getGroupPermissions( $groups ) {
3079 global $wgGroupPermissions, $wgRevokePermissions;
3080 $rights = array();
3081 // grant every granted permission first
3082 foreach( $groups as $group ) {
3083 if( isset( $wgGroupPermissions[$group] ) ) {
3084 $rights = array_merge( $rights,
3085 // array_filter removes empty items
3086 array_keys( array_filter( $wgGroupPermissions[$group] ) ) );
3087 }
3088 }
3089 // now revoke the revoked permissions
3090 foreach( $groups as $group ) {
3091 if( isset( $wgRevokePermissions[$group] ) ) {
3092 $rights = array_diff( $rights,
3093 array_keys( array_filter( $wgRevokePermissions[$group] ) ) );
3094 }
3095 }
3096 return array_unique($rights);
3097 }
3098
3099 /**
3100 * Get all the groups who have a given permission
3101 *
3102 * @param $role \string Role to check
3103 * @return \type{\arrayof{\string}} List of internal group names with the given permission
3104 */
3105 static function getGroupsWithPermission( $role ) {
3106 global $wgGroupPermissions;
3107 $allowedGroups = array();
3108 foreach ( $wgGroupPermissions as $group => $rights ) {
3109 if ( isset( $rights[$role] ) && $rights[$role] ) {
3110 $allowedGroups[] = $group;
3111 }
3112 }
3113 return $allowedGroups;
3114 }
3115
3116 /**
3117 * Get the localized descriptive name for a group, if it exists
3118 *
3119 * @param $group \string Internal group name
3120 * @return \string Localized descriptive group name
3121 */
3122 static function getGroupName( $group ) {
3123 global $wgMessageCache;
3124 $wgMessageCache->loadAllMessages();
3125 $key = "group-$group";
3126 $name = wfMsg( $key );
3127 return $name == '' || wfEmptyMsg( $key, $name )
3128 ? $group
3129 : $name;
3130 }
3131
3132 /**
3133 * Get the localized descriptive name for a member of a group, if it exists
3134 *
3135 * @param $group \string Internal group name
3136 * @return \string Localized name for group member
3137 */
3138 static function getGroupMember( $group ) {
3139 global $wgMessageCache;
3140 $wgMessageCache->loadAllMessages();
3141 $key = "group-$group-member";
3142 $name = wfMsg( $key );
3143 return $name == '' || wfEmptyMsg( $key, $name )
3144 ? $group
3145 : $name;
3146 }
3147
3148 /**
3149 * Return the set of defined explicit groups.
3150 * The implicit groups (by default *, 'user' and 'autoconfirmed')
3151 * are not included, as they are defined automatically, not in the database.
3152 * @return \type{\arrayof{\string}} Array of internal group names
3153 */
3154 static function getAllGroups() {
3155 global $wgGroupPermissions, $wgRevokePermissions;
3156 return array_diff(
3157 array_merge( array_keys( $wgGroupPermissions ), array_keys( $wgRevokePermissions ) ),
3158 self::getImplicitGroups()
3159 );
3160 }
3161
3162 /**
3163 * Get a list of all available permissions.
3164 * @return \type{\arrayof{\string}} Array of permission names
3165 */
3166 static function getAllRights() {
3167 if ( self::$mAllRights === false ) {
3168 global $wgAvailableRights;
3169 if ( count( $wgAvailableRights ) ) {
3170 self::$mAllRights = array_unique( array_merge( self::$mCoreRights, $wgAvailableRights ) );
3171 } else {
3172 self::$mAllRights = self::$mCoreRights;
3173 }
3174 wfRunHooks( 'UserGetAllRights', array( &self::$mAllRights ) );
3175 }
3176 return self::$mAllRights;
3177 }
3178
3179 /**
3180 * Get a list of implicit groups
3181 * @return \type{\arrayof{\string}} Array of internal group names
3182 */
3183 public static function getImplicitGroups() {
3184 global $wgImplicitGroups;
3185 $groups = $wgImplicitGroups;
3186 wfRunHooks( 'UserGetImplicitGroups', array( &$groups ) ); #deprecated, use $wgImplictGroups instead
3187 return $groups;
3188 }
3189
3190 /**
3191 * Get the title of a page describing a particular group
3192 *
3193 * @param $group \string Internal group name
3194 * @return \types{\type{Title},\bool} Title of the page if it exists, false otherwise
3195 */
3196 static function getGroupPage( $group ) {
3197 global $wgMessageCache;
3198 $wgMessageCache->loadAllMessages();
3199 $page = wfMsgForContent( 'grouppage-' . $group );
3200 if( !wfEmptyMsg( 'grouppage-' . $group, $page ) ) {
3201 $title = Title::newFromText( $page );
3202 if( is_object( $title ) )
3203 return $title;
3204 }
3205 return false;
3206 }
3207
3208 /**
3209 * Create a link to the group in HTML, if available;
3210 * else return the group name.
3211 *
3212 * @param $group \string Internal name of the group
3213 * @param $text \string The text of the link
3214 * @return \string HTML link to the group
3215 */
3216 static function makeGroupLinkHTML( $group, $text = '' ) {
3217 if( $text == '' ) {
3218 $text = self::getGroupName( $group );
3219 }
3220 $title = self::getGroupPage( $group );
3221 if( $title ) {
3222 global $wgUser;
3223 $sk = $wgUser->getSkin();
3224 return $sk->link( $title, htmlspecialchars( $text ) );
3225 } else {
3226 return $text;
3227 }
3228 }
3229
3230 /**
3231 * Create a link to the group in Wikitext, if available;
3232 * else return the group name.
3233 *
3234 * @param $group \string Internal name of the group
3235 * @param $text \string The text of the link
3236 * @return \string Wikilink to the group
3237 */
3238 static function makeGroupLinkWiki( $group, $text = '' ) {
3239 if( $text == '' ) {
3240 $text = self::getGroupName( $group );
3241 }
3242 $title = self::getGroupPage( $group );
3243 if( $title ) {
3244 $page = $title->getPrefixedText();
3245 return "[[$page|$text]]";
3246 } else {
3247 return $text;
3248 }
3249 }
3250
3251 /**
3252 * Returns an array of the groups that a particular group can add/remove.
3253 *
3254 * @param $group String: the group to check for whether it can add/remove
3255 * @return Array array( 'add' => array( addablegroups ),
3256 * 'remove' => array( removablegroups ),
3257 * 'add-self' => array( addablegroups to self),
3258 * 'remove-self' => array( removable groups from self) )
3259 */
3260 static function changeableByGroup( $group ) {
3261 global $wgAddGroups, $wgRemoveGroups, $wgGroupsAddToSelf, $wgGroupsRemoveFromSelf;
3262
3263 $groups = array( 'add' => array(), 'remove' => array(), 'add-self' => array(), 'remove-self' => array() );
3264 if( empty($wgAddGroups[$group]) ) {
3265 // Don't add anything to $groups
3266 } elseif( $wgAddGroups[$group] === true ) {
3267 // You get everything
3268 $groups['add'] = self::getAllGroups();
3269 } elseif( is_array($wgAddGroups[$group]) ) {
3270 $groups['add'] = $wgAddGroups[$group];
3271 }
3272
3273 // Same thing for remove
3274 if( empty($wgRemoveGroups[$group]) ) {
3275 } elseif($wgRemoveGroups[$group] === true ) {
3276 $groups['remove'] = self::getAllGroups();
3277 } elseif( is_array($wgRemoveGroups[$group]) ) {
3278 $groups['remove'] = $wgRemoveGroups[$group];
3279 }
3280
3281 // Re-map numeric keys of AddToSelf/RemoveFromSelf to the 'user' key for backwards compatibility
3282 if( empty($wgGroupsAddToSelf['user']) || $wgGroupsAddToSelf['user'] !== true ) {
3283 foreach($wgGroupsAddToSelf as $key => $value) {
3284 if( is_int($key) ) {
3285 $wgGroupsAddToSelf['user'][] = $value;
3286 }
3287 }
3288 }
3289
3290 if( empty($wgGroupsRemoveFromSelf['user']) || $wgGroupsRemoveFromSelf['user'] !== true ) {
3291 foreach($wgGroupsRemoveFromSelf as $key => $value) {
3292 if( is_int($key) ) {
3293 $wgGroupsRemoveFromSelf['user'][] = $value;
3294 }
3295 }
3296 }
3297
3298 // Now figure out what groups the user can add to him/herself
3299 if( empty($wgGroupsAddToSelf[$group]) ) {
3300 } elseif( $wgGroupsAddToSelf[$group] === true ) {
3301 // No idea WHY this would be used, but it's there
3302 $groups['add-self'] = User::getAllGroups();
3303 } elseif( is_array($wgGroupsAddToSelf[$group]) ) {
3304 $groups['add-self'] = $wgGroupsAddToSelf[$group];
3305 }
3306
3307 if( empty($wgGroupsRemoveFromSelf[$group]) ) {
3308 } elseif( $wgGroupsRemoveFromSelf[$group] === true ) {
3309 $groups['remove-self'] = User::getAllGroups();
3310 } elseif( is_array($wgGroupsRemoveFromSelf[$group]) ) {
3311 $groups['remove-self'] = $wgGroupsRemoveFromSelf[$group];
3312 }
3313
3314 return $groups;
3315 }
3316
3317 /**
3318 * Returns an array of groups that this user can add and remove
3319 * @return Array array( 'add' => array( addablegroups ),
3320 * 'remove' => array( removablegroups ),
3321 * 'add-self' => array( addablegroups to self),
3322 * 'remove-self' => array( removable groups from self) )
3323 */
3324 function changeableGroups() {
3325 if( $this->isAllowed( 'userrights' ) ) {
3326 // This group gives the right to modify everything (reverse-
3327 // compatibility with old "userrights lets you change
3328 // everything")
3329 // Using array_merge to make the groups reindexed
3330 $all = array_merge( User::getAllGroups() );
3331 return array(
3332 'add' => $all,
3333 'remove' => $all,
3334 'add-self' => array(),
3335 'remove-self' => array()
3336 );
3337 }
3338
3339 // Okay, it's not so simple, we will have to go through the arrays
3340 $groups = array(
3341 'add' => array(),
3342 'remove' => array(),
3343 'add-self' => array(),
3344 'remove-self' => array() );
3345 $addergroups = $this->getEffectiveGroups();
3346
3347 foreach ($addergroups as $addergroup) {
3348 $groups = array_merge_recursive(
3349 $groups, $this->changeableByGroup($addergroup)
3350 );
3351 $groups['add'] = array_unique( $groups['add'] );
3352 $groups['remove'] = array_unique( $groups['remove'] );
3353 $groups['add-self'] = array_unique( $groups['add-self'] );
3354 $groups['remove-self'] = array_unique( $groups['remove-self'] );
3355 }
3356 return $groups;
3357 }
3358
3359 /**
3360 * Increment the user's edit-count field.
3361 * Will have no effect for anonymous users.
3362 */
3363 function incEditCount() {
3364 if( !$this->isAnon() ) {
3365 $dbw = wfGetDB( DB_MASTER );
3366 $dbw->update( 'user',
3367 array( 'user_editcount=user_editcount+1' ),
3368 array( 'user_id' => $this->getId() ),
3369 __METHOD__ );
3370
3371 // Lazy initialization check...
3372 if( $dbw->affectedRows() == 0 ) {
3373 // Pull from a slave to be less cruel to servers
3374 // Accuracy isn't the point anyway here
3375 $dbr = wfGetDB( DB_SLAVE );
3376 $count = $dbr->selectField( 'revision',
3377 'COUNT(rev_user)',
3378 array( 'rev_user' => $this->getId() ),
3379 __METHOD__ );
3380
3381 // Now here's a goddamn hack...
3382 if( $dbr !== $dbw ) {
3383 // If we actually have a slave server, the count is
3384 // at least one behind because the current transaction
3385 // has not been committed and replicated.
3386 $count++;
3387 } else {
3388 // But if DB_SLAVE is selecting the master, then the
3389 // count we just read includes the revision that was
3390 // just added in the working transaction.
3391 }
3392
3393 $dbw->update( 'user',
3394 array( 'user_editcount' => $count ),
3395 array( 'user_id' => $this->getId() ),
3396 __METHOD__ );
3397 }
3398 }
3399 // edit count in user cache too
3400 $this->invalidateCache();
3401 }
3402
3403 /**
3404 * Get the description of a given right
3405 *
3406 * @param $right \string Right to query
3407 * @return \string Localized description of the right
3408 */
3409 static function getRightDescription( $right ) {
3410 global $wgMessageCache;
3411 $wgMessageCache->loadAllMessages();
3412 $key = "right-$right";
3413 $name = wfMsg( $key );
3414 return $name == '' || wfEmptyMsg( $key, $name )
3415 ? $right
3416 : $name;
3417 }
3418
3419 /**
3420 * Make an old-style password hash
3421 *
3422 * @param $password \string Plain-text password
3423 * @param $userId \string User ID
3424 * @return \string Password hash
3425 */
3426 static function oldCrypt( $password, $userId ) {
3427 global $wgPasswordSalt;
3428 if ( $wgPasswordSalt ) {
3429 return md5( $userId . '-' . md5( $password ) );
3430 } else {
3431 return md5( $password );
3432 }
3433 }
3434
3435 /**
3436 * Make a new-style password hash
3437 *
3438 * @param $password \string Plain-text password
3439 * @param $salt \string Optional salt, may be random or the user ID.
3440 * If unspecified or false, will generate one automatically
3441 * @return \string Password hash
3442 */
3443 static function crypt( $password, $salt = false ) {
3444 global $wgPasswordSalt;
3445
3446 $hash = '';
3447 if( !wfRunHooks( 'UserCryptPassword', array( &$password, &$salt, &$wgPasswordSalt, &$hash ) ) ) {
3448 return $hash;
3449 }
3450
3451 if( $wgPasswordSalt ) {
3452 if ( $salt === false ) {
3453 $salt = substr( wfGenerateToken(), 0, 8 );
3454 }
3455 return ':B:' . $salt . ':' . md5( $salt . '-' . md5( $password ) );
3456 } else {
3457 return ':A:' . md5( $password );
3458 }
3459 }
3460
3461 /**
3462 * Compare a password hash with a plain-text password. Requires the user
3463 * ID if there's a chance that the hash is an old-style hash.
3464 *
3465 * @param $hash \string Password hash
3466 * @param $password \string Plain-text password to compare
3467 * @param $userId \string User ID for old-style password salt
3468 * @return \bool
3469 */
3470 static function comparePasswords( $hash, $password, $userId = false ) {
3471 $m = false;
3472 $type = substr( $hash, 0, 3 );
3473
3474 $result = false;
3475 if( !wfRunHooks( 'UserComparePasswords', array( &$hash, &$password, &$userId, &$result ) ) ) {
3476 return $result;
3477 }
3478
3479 if ( $type == ':A:' ) {
3480 # Unsalted
3481 return md5( $password ) === substr( $hash, 3 );
3482 } elseif ( $type == ':B:' ) {
3483 # Salted
3484 list( $salt, $realHash ) = explode( ':', substr( $hash, 3 ), 2 );
3485 return md5( $salt.'-'.md5( $password ) ) == $realHash;
3486 } else {
3487 # Old-style
3488 return self::oldCrypt( $password, $userId ) === $hash;
3489 }
3490 }
3491
3492 /**
3493 * Add a newuser log entry for this user
3494 * @param $byEmail Boolean: account made by email?
3495 */
3496 public function addNewUserLogEntry( $byEmail = false ) {
3497 global $wgUser, $wgContLang, $wgNewUserLog;
3498 if( empty($wgNewUserLog) ) {
3499 return true; // disabled
3500 }
3501 $talk = $wgContLang->getFormattedNsText( NS_TALK );
3502 if( $this->getName() == $wgUser->getName() ) {
3503 $action = 'create';
3504 $message = '';
3505 } else {
3506 $action = 'create2';
3507 $message = $byEmail ? wfMsgForContent( 'newuserlog-byemail' ) : '';
3508 }
3509 $log = new LogPage( 'newusers' );
3510 $log->addEntry( $action, $this->getUserPage(), $message, array( $this->getId() ) );
3511 return true;
3512 }
3513
3514 /**
3515 * Add an autocreate newuser log entry for this user
3516 * Used by things like CentralAuth and perhaps other authplugins.
3517 */
3518 public function addNewUserLogEntryAutoCreate() {
3519 global $wgNewUserLog;
3520 if( empty($wgNewUserLog) ) {
3521 return true; // disabled
3522 }
3523 $log = new LogPage( 'newusers', false );
3524 $log->addEntry( 'autocreate', $this->getUserPage(), '', array( $this->getId() ) );
3525 return true;
3526 }
3527
3528 protected function loadOptions() {
3529 $this->load();
3530 if ($this->mOptionsLoaded || !$this->getId() )
3531 return;
3532
3533 $this->mOptions = self::getDefaultOptions();
3534
3535 // Maybe load from the object
3536
3537 if ( !is_null($this->mOptionOverrides) ) {
3538 wfDebug( "Loading options for user ".$this->getId()." from override cache.\n" );
3539 foreach( $this->mOptionOverrides as $key => $value ) {
3540 $this->mOptions[$key] = $value;
3541 }
3542 } else {
3543 wfDebug( "Loading options for user ".$this->getId()." from database.\n" );
3544 // Load from database
3545 $dbr = wfGetDB( DB_SLAVE );
3546
3547 $res = $dbr->select( 'user_properties',
3548 '*',
3549 array('up_user' => $this->getId()),
3550 __METHOD__
3551 );
3552
3553 while( $row = $dbr->fetchObject( $res ) ) {
3554 $this->mOptionOverrides[$row->up_property] = $row->up_value;
3555 $this->mOptions[$row->up_property] = $row->up_value;
3556 }
3557 }
3558
3559 $this->mOptionsLoaded = true;
3560
3561 wfRunHooks( 'UserLoadOptions', array( $this, &$this->mOptions ) );
3562 }
3563
3564 protected function saveOptions() {
3565 global $wgAllowPrefChange;
3566
3567 $extuser = ExternalUser::newFromUser( $this );
3568
3569 $this->loadOptions();
3570 $dbw = wfGetDB( DB_MASTER );
3571
3572 $insert_rows = array();
3573
3574 $saveOptions = $this->mOptions;
3575
3576 // Allow hooks to abort, for instance to save to a global profile.
3577 // Reset options to default state before saving.
3578 if (!wfRunHooks( 'UserSaveOptions', array($this, &$saveOptions) ) )
3579 return;
3580
3581 foreach( $saveOptions as $key => $value ) {
3582 # Don't bother storing default values
3583 if ( ( is_null( self::getDefaultOption( $key ) ) &&
3584 !( $value === false || is_null($value) ) ) ||
3585 $value != self::getDefaultOption( $key ) ) {
3586 $insert_rows[] = array(
3587 'up_user' => $this->getId(),
3588 'up_property' => $key,
3589 'up_value' => $value,
3590 );
3591 }
3592 if ( $extuser && isset( $wgAllowPrefChange[$key] ) ) {
3593 switch ( $wgAllowPrefChange[$key] ) {
3594 case 'local': case 'message':
3595 break;
3596 case 'semiglobal': case 'global':
3597 $extuser->setPref( $key, $value );
3598 }
3599 }
3600 }
3601
3602 $dbw->begin();
3603 $dbw->delete( 'user_properties', array( 'up_user' => $this->getId() ), __METHOD__ );
3604 $dbw->insert( 'user_properties', $insert_rows, __METHOD__ );
3605 $dbw->commit();
3606 }
3607
3608 /**
3609 * Provide an array of HTML 5 attributes to put on an input element
3610 * intended for the user to enter a new password. This may include
3611 * required, title, and/or pattern, depending on $wgMinimalPasswordLength.
3612 *
3613 * Do *not* use this when asking the user to enter his current password!
3614 * Regardless of configuration, users may have invalid passwords for whatever
3615 * reason (e.g., they were set before requirements were tightened up).
3616 * Only use it when asking for a new password, like on account creation or
3617 * ResetPass.
3618 *
3619 * Obviously, you still need to do server-side checking.
3620 *
3621 * @return array Array of HTML attributes suitable for feeding to
3622 * Html::element(), directly or indirectly. (Don't feed to Xml::*()!
3623 * That will potentially output invalid XHTML 1.0 Transitional, and will
3624 * get confused by the boolean attribute syntax used.)
3625 */
3626 public static function passwordChangeInputAttribs() {
3627 global $wgMinimalPasswordLength;
3628
3629 if ( $wgMinimalPasswordLength == 0 ) {
3630 return array();
3631 }
3632
3633 # Note that the pattern requirement will always be satisfied if the
3634 # input is empty, so we need required in all cases.
3635 $ret = array( 'required' );
3636
3637 # We can't actually do this right now, because Opera 9.6 will print out
3638 # the entered password visibly in its error message! When other
3639 # browsers add support for this attribute, or Opera fixes its support,
3640 # we can add support with a version check to avoid doing this on Opera
3641 # versions where it will be a problem. Reported to Opera as
3642 # DSK-262266, but they don't have a public bug tracker for us to follow.
3643 /*
3644 if ( $wgMinimalPasswordLength > 1 ) {
3645 $ret['pattern'] = '.{' . intval( $wgMinimalPasswordLength ) . ',}';
3646 $ret['title'] = wfMsgExt( 'passwordtooshort', 'parsemag',
3647 $wgMinimalPasswordLength );
3648 }
3649 */
3650
3651 return $ret;
3652 }
3653 }