* Fixed unclosed <p> tag
[lhc/web/wiklou.git] / includes / User.php
index b6f4238..42a6a89 100644 (file)
@@ -1,6 +1,6 @@
 <?php
 /**
- * See user.doc
+ * See user.txt
  *
  * @package MediaWiki
  */
@@ -9,11 +9,13 @@
  *
  */
 require_once( 'WatchedItem.php' );
-require_once( 'Group.php' );
 
 # Number of characters in user_token field
 define( 'USER_TOKEN_LENGTH', 32 );
 
+# Serialized record version
+define( 'MW_USER_VERSION', 2 );
+
 /**
  *
  * @package MediaWiki
@@ -23,6 +25,7 @@ class User {
         * @access private
         */
        var $mId, $mName, $mPassword, $mEmail, $mNewtalk;
+       var $mEmailAuthenticated;
        var $mRights, $mOptions;
        var $mDataLoaded, $mNewpassword;
        var $mSkin;
@@ -31,33 +34,79 @@ class User {
        var $mToken;
        var $mRealName;
        var $mHash;
-       /** Array of group id the user belong to */
        var $mGroups;
-       /**#@-*/
+       var $mVersion; // serialized version
 
        /** Construct using User:loadDefaults() */
        function User() {
                $this->loadDefaults();
+               $this->mVersion = MW_USER_VERSION;
        }
 
        /**
         * Static factory method
-        * @static
         * @param string $name Username, validated by Title:newFromText()
+        * @return User
+        * @static
         */
        function newFromName( $name ) {
                $u = new User();
 
+               # Force usernames to capital
+               global $wgContLang;
+               $name = $wgContLang->ucfirst( $name );
+               
                # Clean up name according to title rules
-
                $t = Title::newFromText( $name );
                if( is_null( $t ) ) {
-                       return NULL;
+                       return null;
+               }
+               
+               # Reject various classes of invalid names
+               $canonicalName = $t->getText();
+               if( !User::isValidUserName( $canonicalName ) ) {
+                       return null;
+               }
+               
+               $u->setName( $canonicalName );
+               $u->setId( $u->idFromName( $t->getText() ) );
+               return $u;
+       }
+       
+       /**
+        * Factory method to fetch whichever use has a given email confirmation code.
+        * This code is generated when an account is created or its e-mail address
+        * has changed.
+        *
+        * If the code is invalid or has expired, returns NULL.
+        *
+        * @param string $code
+        * @return User
+        * @static
+        */
+       function newFromConfirmationCode( $code ) {
+               $dbr =& wfGetDB( DB_SLAVE );
+               $name = $dbr->selectField( 'user', 'user_name', array(
+                       'user_email_token' => md5( $code ),
+                       'user_email_token_expires > ' . $dbr->addQuotes( $dbr->timestamp() ),
+                       ) );
+               if( is_string( $name ) ) {
+                       return User::newFromName( $name );
                } else {
-                       $u->setName( $t->getText() );
-                       return $u;
+                       return null;
                }
        }
+       
+       /**
+        * Serialze sleep function, for better cache efficiency and avoidance of 
+        * silly "incomplete type" errors when skins are cached
+        */
+       function __sleep() {
+               return array( 'mId', 'mName', 'mPassword', 'mEmail', 'mNewtalk',
+                       'mEmailAuthenticated', 'mRights', 'mOptions', 'mDataLoaded', 
+                       'mNewpassword', 'mBlockedby', 'mBlockreason', 'mTouched', 
+                       'mToken', 'mRealName', 'mHash', 'mGroups' );
+       }
 
        /**
         * Get username given an id.
@@ -106,12 +155,91 @@ class User {
        }
 
        /**
-        * does the string match an anonymous user IP address?
-        * @param string $name Nickname of a user
+        * does the string match an anonymous IPv4 address?
+        *
         * @static
+        * @param string $name Nickname of a user
+        * @return bool
         */
        function isIP( $name ) {
-               return preg_match("/^\d{1,3}\.\d{1,3}.\d{1,3}\.\d{1,3}$/",$name);
+               return preg_match("/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/",$name);
+               /*return preg_match("/^
+                       (?:[01]?\d{1,2}|2(:?[0-4]\d|5[0-5]))\.
+                       (?:[01]?\d{1,2}|2(:?[0-4]\d|5[0-5]))\.
+                       (?:[01]?\d{1,2}|2(:?[0-4]\d|5[0-5]))\.
+                       (?:[01]?\d{1,2}|2(:?[0-4]\d|5[0-5]))
+               $/x", $name);*/
+       }
+
+       /**
+        * Is the input a valid username?
+        *
+        * Checks if the input is a valid username, we don't want an empty string,
+        * an IP address, anything that containins slashes (would mess up subpages),
+        * is longer than the maximum allowed username size or doesn't begin with
+        * a capital letter.
+        *
+        * @param string $name
+        * @return bool
+        * @static
+        */
+       function isValidUserName( $name ) {
+               global $wgContLang, $wgMaxNameChars;
+               
+               if ( $name == ''
+               || User::isIP( $name )
+               || strpos( $name, '/' ) !== false
+               || strlen( $name ) > $wgMaxNameChars
+               || $name != $wgContLang->ucfirst( $name ) )
+                       return false;
+               else
+                       return true;
+       }
+
+       /**
+        * Is the input a valid password?
+        *
+        * @param string $password
+        * @return bool
+        * @static
+        */
+       function isValidPassword( $password ) {
+               global $wgMinimalPasswordLength;
+               return strlen( $password ) >= $wgMinimalPasswordLength;
+       }
+
+       /**     
+        * does the string match roughly an email address ?
+        *
+        * @todo Check for RFC 2822 compilance
+        * @bug 959
+        *
+        * @param string $addr email address
+        * @static
+        * @return bool
+        */
+       function isValidEmailAddr ( $addr ) {
+               # There used to be a regular expression here, it got removed because it
+               # rejected valid addresses.
+               return ( trim( $addr ) != '' ) &&
+                       (false !== strpos( $addr, '@' ) );
+       }
+
+       /**
+        * Count the number of edits of a user 
+        *
+        * @param int $uid The user ID to check
+        * @return int
+        */
+       function edits( $uid ) {
+               $fname = 'User::editCount';
+               
+               $dbr =& wfGetDB( DB_SLAVE );
+               return $dbr->selectField(
+                       'revision', 'count(*)',
+                       array( 'rev_user' => $uid ),
+                       $fname
+               );
        }
 
        /**
@@ -137,55 +265,99 @@ class User {
         * if we have an available language object.
         */
        function loadDefaults() {
-               global $wgContLang, $wgIP;
+               static $n=0;
+               $n++;
+               $fname = 'User::loadDefaults' . $n;
+               wfProfileIn( $fname );
+               
+               global $wgContLang, $wgIP, $wgDBname;
                global $wgNamespacesToBeSearchedDefault;
 
                $this->mId = 0;
                $this->mNewtalk = -1;
                $this->mName = $wgIP;
                $this->mRealName = $this->mEmail = '';
+               $this->mEmailAuthenticated = null;
                $this->mPassword = $this->mNewpassword = '';
                $this->mRights = array();
                $this->mGroups = array();
+               $this->mOptions = User::getDefaultOptions();
                
-               // Getting user defaults only if we have an available language
-               if(isset($wgContLang)) { $this->loadDefaultFromLanguage(); }
-               
-               foreach ($wgNamespacesToBeSearchedDefault as $nsnum => $val) {
+               foreach( $wgNamespacesToBeSearchedDefault as $nsnum => $val ) {
                        $this->mOptions['searchNs'.$nsnum] = $val;
                }
                unset( $this->mSkin );
                $this->mDataLoaded = false;
                $this->mBlockedby = -1; # Unset
-               $this->mTouched = '0'; # Allow any pages to be cached
                $this->setToken(); # Random
                $this->mHash = false;
-       }
 
+               if ( isset( $_COOKIE[$wgDBname.'LoggedOut'] ) ) {
+                       $this->mTouched = wfTimestamp( TS_MW, $_COOKIE[$wgDBname.'LoggedOut'] );
+               }
+               else {
+                       $this->mTouched = '0'; # Allow any pages to be cached
+               }
+
+               wfProfileOut( $fname );
+       }
+       
        /**
-        * Used to load user options from a language.
-        * This is not in loadDefault() cause we sometime create user before having
-        * a language object.
-        */     
-       function loadDefaultFromLanguage(){
-               global $wgContLang;
-               $defOpt = $wgContLang->getDefaultUserOptions() ;
-               foreach ( $defOpt as $oname => $val ) {
-                       $this->mOptions[$oname] = $val;
-               }               
-               /* 
-                 default language setting
-               */
-               $this->setOption('variant', $wgContLang->getPreferredVariant());
-               $this->setOption('language', $wgContLang->getPreferredVariant());
+        * Combine the language default options with any site-specific options
+        * and add the default language variants.
+        *
+        * @return array
+        * @static
+        * @access private
+        */
+       function getDefaultOptions() {
+               /**
+                * Site defaults will override the global/language defaults
+                */
+               global $wgContLang, $wgDefaultUserOptions;
+               $defOpt = $wgDefaultUserOptions + $wgContLang->getDefaultUserOptions();
+               
+               /**
+                * default language setting
+                */
+               $variant = $wgContLang->getPreferredVariant();
+               $defOpt['variant'] = $variant;
+               $defOpt['language'] = $variant;
+               
+               return $defOpt;
+       }
+       
+       /**
+        * Get a given default option value.
+        *
+        * @param string $opt
+        * @return string
+        * @static
+        * @access public
+        */
+       function getDefaultOption( $opt ) {
+               $defOpts = User::getDefaultOptions();
+               if( isset( $defOpts[$opt] ) ) {
+                       return $defOpts[$opt];
+               } else {
+                       return '';
+               }
        }
 
        /**
         * Get blocking information
         * @access private
+        * @param bool $bFromSlave Specify whether to check slave or master. To improve performance,
+        *  non-critical checks are done against slaves. Check when actually saving should be done against
+        *  master.
+        *
+        * Note that even if $bFromSlave is false, the check is done first against slave, then master.
+        * The logic is that if blocked on slave, we'll assume it's either blocked on master or
+        * just slightly outta sync and soon corrected - safer to block slightly more that less.
+        * And it's cheaper to check slave first, then master if needed, than master always.
         */
-       function getBlockedStatus() {
-               global $wgIP, $wgBlockCache, $wgProxyList;
+       function getBlockedStatus( $bFromSlave = true ) {
+               global $wgIP, $wgBlockCache, $wgProxyList, $wgEnableSorbs, $wgProxyWhitelist;
 
                if ( -1 != $this->mBlockedby ) { return; }
 
@@ -194,15 +366,24 @@ class User {
                # User blocking
                if ( $this->mId ) {
                        $block = new Block();
-                       if ( $block->load( $wgIP , $this->mId ) ) {
+                       $block->forUpdate( $bFromSlave );
+                       if ( $block->load( $wgIP , $this->mId ) ) {
                                $this->mBlockedby = $block->mBy;
                                $this->mBlockreason = $block->mReason;
+                               $this->spreadBlock();
                        }
                }
 
                # IP/range blocking
                if ( !$this->mBlockedby ) {
-                       $block = $wgBlockCache->get( $wgIP );
+                       # Check first against slave, and optionally from master.
+                       $block = $wgBlockCache->get( $wgIP, true );
+                       if ( !$block && !$bFromSlave )
+                               {
+                               # Not blocked: check against master, to make sure.
+                               $wgBlockCache->clearLocal( );
+                               $block = $wgBlockCache->get( $wgIP, false );
+                               }
                        if ( $block !== false ) {
                                $this->mBlockedby = $block->mBy;
                                $this->mBlockreason = $block->mReason;
@@ -210,22 +391,157 @@ class User {
                }
 
                # Proxy blocking
-               if ( !$this->mBlockedby ) {
+               if ( !$this->isSysop() && !in_array( $wgIP, $wgProxyWhitelist ) ) {
+               
+                       # Local list
                        if ( array_key_exists( $wgIP, $wgProxyList ) ) {
+                               $this->mBlockedby = wfMsg( 'proxyblocker' );
                                $this->mBlockreason = wfMsg( 'proxyblockreason' );
-                               $this->mBlockedby = "Proxy blocker";
+                       }
+
+                       # DNSBL
+                       if ( !$this->mBlockedby && $wgEnableSorbs && !$this->getID() ) {
+                               if ( $this->inSorbsBlacklist( $wgIP ) ) {
+                                       $this->mBlockedby = wfMsg( 'sorbs' );
+                                       $this->mBlockreason = wfMsg( 'sorbsreason' );
+                               }
                        }
                }
        }
 
+       function inSorbsBlacklist( $ip ) {
+               global $wgEnableSorbs;
+               return $wgEnableSorbs &&
+                       $this->inDnsBlacklist( $ip, 'http.dnsbl.sorbs.net.' );
+       }
+       
+       function inOpmBlacklist( $ip ) {
+               global $wgEnableOpm;
+               return $wgEnableOpm &&
+                       $this->inDnsBlacklist( $ip, 'opm.blitzed.org.' );
+       }
+       
+       function inDnsBlacklist( $ip, $base ) {
+               $fname = 'User::inDnsBlacklist';
+               wfProfileIn( $fname );
+               
+               $found = false;
+               $host = '';
+               
+               if ( preg_match( '/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/', $ip, $m ) ) {
+                       # Make hostname
+                       for ( $i=4; $i>=1; $i-- ) {
+                               $host .= $m[$i] . '.';
+                       }
+                       $host .= $base;
+
+                       # Send query
+                       $ipList = gethostbynamel( $host );
+                       
+                       if ( $ipList ) {
+                               wfDebug( "Hostname $host is {$ipList[0]}, it's a proxy says $base!\n" );
+                               $found = true;
+                       } else {
+                               wfDebug( "Requested $host, not found in $base.\n" );
+                       }
+               }
+
+               wfProfileOut( $fname );
+               return $found;
+       }
+       
+       /**
+        * Primitive rate limits: enforce maximum actions per time period
+        * to put a brake on flooding.
+        *
+        * Note: when using a shared cache like memcached, IP-address
+        * last-hit counters will be shared across wikis.
+        *
+        * @return bool true if a rate limiter was tripped
+        * @access public
+        */
+       function pingLimiter( $action='edit' ) {
+               global $wgRateLimits;
+               if( !isset( $wgRateLimits[$action] ) ) {
+                       return false;
+               }
+               if( $this->isAllowed( 'delete' ) ) {
+                       // goddam cabal
+                       return false;
+               }
+               
+               global $wgMemc, $wgIP, $wgDBname, $wgRateLimitLog;
+               $fname = 'User::pingLimiter';
+               $limits = $wgRateLimits[$action];
+               $keys = array();
+               $id = $this->getId();
+               
+               if( isset( $limits['anon'] ) && $id == 0 ) {
+                       $keys["$wgDBname:limiter:$action:anon"] = $limits['anon'];
+               }
+               
+               if( isset( $limits['user'] ) && $id != 0 ) {
+                       $keys["$wgDBname:limiter:$action:user:$id"] = $limits['user'];
+               }
+               if( $this->isNewbie() ) {
+                       if( isset( $limits['newbie'] ) && $id != 0 ) {
+                               $keys["$wgDBname:limiter:$action:user:$id"] = $limits['newbie'];
+                       }
+                       if( isset( $limits['ip'] ) ) {
+                               $keys["mediawiki:limiter:$action:ip:$wgIP"] = $limits['ip'];
+                       }
+                       if( isset( $limits['subnet'] ) && preg_match( '/^(\d+\.\d+\.\d+)\.\d+$/', $wgIP, $matches ) ) {
+                               $subnet = $matches[1];
+                               $keys["mediawiki:limiter:$action:subnet:$subnet"] = $limits['subnet'];
+                       }
+               }
+               
+               $triggered = false;
+               foreach( $keys as $key => $limit ) {
+                       list( $max, $period ) = $limit;
+                       $summary = "(limit $max in {$period}s)";
+                       $count = $wgMemc->get( $key );
+                       if( $count ) {
+                               if( $count > $max ) {
+                                       wfDebug( "$fname: tripped! $key at $count $summary\n" );
+                                       if( $wgRateLimitLog ) {
+                                               @error_log( wfTimestamp( TS_MW ) . ' ' . $wgDBname . ': ' . $this->getName() . " tripped $key at $count $summary\n", 3, $wgRateLimitLog );
+                                       }
+                                       $triggered = true;
+                               } else {
+                                       wfDebug( "$fname: ok. $key at $count $summary\n" );
+                               }
+                       } else {
+                               wfDebug( "$fname: adding record for $key $summary\n" );
+                               $wgMemc->add( $key, 1, IntVal( $period ) );
+                       }
+                       $wgMemc->incr( $key );
+               }
+               
+               return $triggered;
+       }
+       
        /**
         * Check if user is blocked
         * @return bool True if blocked, false otherwise
         */
-       function isBlocked() {
-               $this->getBlockedStatus();
-               if ( 0 === $this->mBlockedby ) { return false; }
-               return true;
+       function isBlocked( $bFromSlave = false ) {
+               $this->getBlockedStatus( $bFromSlave );
+               return $this->mBlockedby !== 0;
+       }
+
+       /**
+        * Check if user is blocked from editing a particular article
+        */
+       function isBlockedFrom( $title, $bFromSlave = false ) {
+               global $wgBlockAllowsUTEdit;
+               if ( $wgBlockAllowsUTEdit && $title->getText() === $this->getName() && 
+                 $title->getNamespace() == NS_USER_TALK )
+               {
+                       return false;
+               } else {
+                       return $this->isBlocked( $bFromSlave );
+               }
        }
        
        /**
@@ -293,6 +609,10 @@ class User {
 
                $passwordCorrect = FALSE;
                $user = $wgMemc->get( $key = "$wgDBname:user:id:$sId" );
+               if( !is_object( $user ) || $user->mVersion < MW_USER_VERSION ) {
+                       # Expire old serialized objects; they may be corrupt.
+                       $user = false;
+               }
                if($makenew = !$user) {
                        wfDebug( "User::loadFromSession() unable to load from memcached\n" );
                        $user = new User();
@@ -317,7 +637,6 @@ class User {
                                else
                                        wfDebug( "User::loadFromSession() unable to save to memcached\n" );
                        }
-                       $user->spreadBlock();
                        return $user;
                }
                return new User(); # Can't log in from session
@@ -327,9 +646,13 @@ class User {
         * Load a user from the database
         */
        function loadFromDatabase() {
-               global $wgCommandLineMode, $wgAnonGroupId, $wgLoggedInGroupId;
+               global $wgCommandLineMode;
                $fname = "User::loadFromDatabase";
-               if ( $this->mDataLoaded || $wgCommandLineMode ) {
+               
+               # Counter-intuitive, breaks various things, use User::setLoaded() if you want to suppress 
+               # loading in a command line script, don't assume all command line scripts need it like this
+               #if ( $this->mDataLoaded || $wgCommandLineMode ) {
+               if ( $this->mDataLoaded ) {
                        return;
                }
 
@@ -337,27 +660,23 @@ class User {
                $this->mId = IntVal( $this->mId );
 
                /** Anonymous user */
-               if(!$this->mId) {
+               if( !$this->mId ) {
                        /** Get rights */
-                       $anong = Group::newFromId($wgAnonGroupId);
-                       if (!$anong) 
-                               wfDebugDieBacktrace("Please update your database schema "
-                                       ."and populate initial group data from "
-                                       ."maintenance/archives patches");
-                       $anong->loadFromDatabase();
-                       $this->mRights = explode(',', $anong->getRights());
+                       $this->mRights = $this->getGroupPermissions( array( '*' ) );
                        $this->mDataLoaded = true;
                        return;
                } # the following stuff is for non-anonymous users only
                
                $dbr =& wfGetDB( DB_SLAVE );
                $s = $dbr->selectRow( 'user', array( 'user_name','user_password','user_newpassword','user_email',
+                 'user_email_authenticated',
                  'user_real_name','user_options','user_touched', 'user_token' ),
                  array( 'user_id' => $this->mId ), $fname );
                
                if ( $s !== false ) {
                        $this->mName = $s->user_name;
                        $this->mEmail = $s->user_email;
+                       $this->mEmailAuthenticated = wfTimestampOrNull( TS_MW, $s->user_email_authenticated );
                        $this->mRealName = $s->user_real_name;
                        $this->mPassword = $s->user_password;
                        $this->mNewpassword = $s->user_newpassword;
@@ -365,28 +684,16 @@ class User {
                        $this->mTouched = wfTimestamp(TS_MW,$s->user_touched);
                        $this->mToken = $s->user_token;
 
-                       // Get groups id
-                       $res = $dbr->select( 'user_groups', array( 'ug_group' ), array( 'ug_user' => $this->mId ) );
-
-                       while($group = $dbr->fetchRow($res)) {
-                               $this->mGroups[] = $group[0];
-                       }
-
-                       // add the default group for logged in user
-                       $this->mGroups[] = $wgLoggedInGroupId;
-
-                       $this->mRights = array();
-                       // now we merge groups rights to get this user rights
-                       foreach($this->mGroups as $aGroupId) {
-                               $g = Group::newFromId($aGroupId);
-                               $g->loadFromDatabase();
-                               $this->mRights = array_merge($this->mRights, explode(',', $g->getRights()));
+                       $res = $dbr->select( 'user_groups',
+                               array( 'ug_group' ),
+                               array( 'ug_user' => $this->mId ),
+                               $fname );
+                       $this->mGroups = array();
+                       while( $row = $dbr->fetchObject( $res ) ) {
+                               $this->mGroups[] = $row->ug_group;
                        }
-                       
-                       // array merge duplicate rights which are part of several groups
-                       $this->mRights = array_unique($this->mRights);
-                       
-                       $dbr->freeResult($res);
+                       $effectiveGroups = array_merge( array( '*', 'user' ), $this->mGroups );
+                       $this->mRights = $this->getGroupPermissions( $effectiveGroups );
                }
 
                $this->mDataLoaded = true;
@@ -408,15 +715,51 @@ class User {
                $this->mName = $str;
        }
 
+       
+       /**
+        * Return the title dbkey form of the name, for eg user pages.
+        * @return string
+        * @access public
+        */
+       function getTitleKey() {
+               return str_replace( ' ', '_', $this->getName() );
+       }
+       
        function getNewtalk() {
+               global $wgUseEnotif;
                $fname = 'User::getNewtalk';
                $this->loadFromDatabase();
                
                # Load the newtalk status if it is unloaded (mNewtalk=-1)
-               if ( $this->mNewtalk == -1 ) {
-                       $this->mNewtalk=0; # reset talk page status
+               if( $this->mNewtalk == -1 ) {
+                       $this->mNewtalk = 0; # reset talk page status
+
+                       # Check memcached separately for anons, who have no
+                       # entire User object stored in there.
+                       if( !$this->mId ) {
+                               global $wgDBname, $wgMemc;
+                               $key = "$wgDBname:newtalk:ip:{$this->mName}";
+                               $newtalk = $wgMemc->get( $key );
+                               if( is_integer( $newtalk ) ) {
+                                       $this->mNewtalk = $newtalk ? 1 : 0;
+                                       return (bool)$this->mNewtalk;
+                               }
+                       } 
+                       
                        $dbr =& wfGetDB( DB_SLAVE );
-                       if($this->mId) {
+                       if ( $wgUseEnotif ) {
+                               $res = $dbr->select( 'watchlist',
+                                       array( 'wl_user' ),
+                                       array( 'wl_title'     => $this->getTitleKey(),
+                                                  'wl_namespace' => NS_USER_TALK,
+                                                  'wl_user'      => $this->mId,
+                                                  'wl_notificationtimestamp != 0' ),
+                                       'User::getNewtalk' );
+                               if( $dbr->numRows($res) > 0 ) {
+                                       $this->mNewtalk = 1;
+                               }
+                               $dbr->freeResult( $res );
+                       } elseif ( $this->mId ) {
                                $res = $dbr->select( 'user_newtalk', 1, array( 'user_id' => $this->mId ), $fname );
 
                                if ( $dbr->numRows($res)>0 ) {
@@ -424,19 +767,13 @@ class User {
                                }
                                $dbr->freeResult( $res );
                        } else {
-                               global $wgDBname, $wgMemc;
-                               $key = "$wgDBname:newtalk:ip:{$this->mName}";
-                               $newtalk = $wgMemc->get( $key );
-                               if( ! is_integer( $newtalk ) ){
-                                       $res = $dbr->select( 'user_newtalk', 1, array( 'user_ip' => $this->mName ), $fname );
-
-                                       $this->mNewtalk = $dbr->numRows( $res ) > 0 ? 1 : 0;
-                                       $dbr->freeResult( $res );
-
-                                       $wgMemc->set( $key, $this->mNewtalk, time() ); // + 1800 );
-                               } else {
-                                       $this->mNewtalk = $newtalk ? 1 : 0;
-                               }
+                               $res = $dbr->select( 'user_newtalk', 1, array( 'user_ip' => $this->mName ), $fname );
+                               $this->mNewtalk = $dbr->numRows( $res ) > 0 ? 1 : 0;
+                               $dbr->freeResult( $res );
+                       }
+                       
+                       if( !$this->mId ) {
+                               $wgMemc->set( $key, $this->mNewtalk, time() ); // + 1800 );
                        }
                }
 
@@ -450,8 +787,9 @@ class User {
        }
 
        function invalidateCache() {
+               global $wgClockSkewFudge;
                $this->loadFromDatabase();
-               $this->mTouched = wfTimestampNow();
+               $this->mTouched = wfTimestamp(TS_MW, time() + $wgClockSkewFudge );
                # Don't forget to save the options after this or
                # it won't take effect!
        }
@@ -495,13 +833,16 @@ class User {
 
        # Set the random token (used for persistent authentication)
        function setToken( $token = false ) {
+               global $wgSecretKey, $wgProxyKey, $wgDBname;
                if ( !$token ) {
-                       $this->mToken = '';
-                       # Take random data from PRNG
-                       # This is reasonably secure if the PRNG has been seeded correctly
-                       for ($i = 0; $i<USER_TOKEN_LENGTH / 4; $i++) {
-                               $this->mToken .= sprintf( "%04X", mt_rand( 0, 65535 ) );
+                       if ( $wgSecretKey ) {
+                               $key = $wgSecretKey;
+                       } elseif ( $wgProxyKey ) {
+                               $key = $wgProxyKey;
+                       } else {
+                               $key = microtime();
                        }
+                       $this->mToken = md5( $key . mt_rand( 0, 0x7fffffff ) . $wgDBname . $this->mId );
                } else {
                        $this->mToken = $token;
                }
@@ -523,6 +864,11 @@ class User {
                return $this->mEmail;
        }
 
+       function getEmailAuthenticationTimestamp() {
+               $this->loadFromDatabase();
+               return $this->mEmailAuthenticated;
+       }
+
        function setEmail( $str ) {
                $this->loadFromDatabase();
                $this->mEmail = $str;
@@ -541,7 +887,7 @@ class User {
        function getOption( $oname ) {
                $this->loadFromDatabase();
                if ( array_key_exists( $oname, $this->mOptions ) ) {
-                       return $this->mOptions[$oname];
+                       return trim( $this->mOptions[$oname] );
                } else {
                        return '';
                }
@@ -561,59 +907,112 @@ class User {
                $this->loadFromDatabase();
                return $this->mRights;
        }
-       
-       function addRight( $rname )     {
-               $this->loadFromDatabase();
-               array_push( $this->mRights, $rname );
-               $this->invalidateCache();
-       }
 
+       /**
+        * Get the list of explicit group memberships this user has.
+        * The implicit * and user groups are not included.
+        * @return array of strings
+        */
        function getGroups() {
                $this->loadFromDatabase();
                return $this->mGroups;
        }
 
-       function setGroups($groups) {
-               $this->loadFromDatabase();
-               $this->mGroups = $groups;
+       /**
+        * Get the list of implicit group memberships this user has.
+        * This includes all explicit groups, plus 'user' if logged in
+        * and '*' for all accounts.
+        * @return array of strings
+        */
+       function getEffectiveGroups() {
+               $base = array( '*' );
+               if( $this->isLoggedIn() ) {
+                       $base[] = 'user';
+               }
+               return array_merge( $base, $this->getGroups() );
+       }
+       
+       /**
+        * Remove the user from the given group.
+        * This takes immediate effect.
+        * @string $group
+        */
+       function addGroup( $group ) {
+               $dbw =& wfGetDB( DB_MASTER );
+               $dbw->insert( 'user_groups',
+                       array(
+                               'ug_user'  => $this->getID(),
+                               'ug_group' => $group,
+                       ),
+                       'User::addGroup',
+                       array( 'IGNORE' ) );
+               
+               $this->mGroups = array_merge( $this->mGroups, array( $group ) );
+               $this->mRights = User::getGroupPermissions( $this->getEffectiveGroups() );
+               
+               $this->invalidateCache();
+               $this->saveSettings();
+       }
+       
+       /**
+        * Remove the user from the given group.
+        * This takes immediate effect.
+        * @string $group
+        */
+       function removeGroup( $group ) {
+               $dbw =& wfGetDB( DB_MASTER );
+               $dbw->delete( 'user_groups',
+                       array(
+                               'ug_user'  => $this->getID(),
+                               'ug_group' => $group,
+                       ),
+                       'User::removeGroup' );
+               
+               $this->mGroups = array_diff( $this->mGroups, array( $group ) );
+               $this->mRights = User::getGroupPermissions( $this->getEffectiveGroups() );
+               
                $this->invalidateCache();
+               $this->saveSettings();
        }
 
+
+       /**
+        * A more legible check for non-anonymousness.
+        * Returns true if the user is not an anonymous visitor.
+        *
+        * @return bool
+        */
+       function isLoggedIn() {
+               return( $this->getID() != 0 );
+       }
+       
+       /**
+        * A more legible check for anonymousness.
+        * Returns true if the user is an anonymous visitor.
+        *
+        * @return bool
+        */
+       function isAnon() {
+               return !$this->isLoggedIn();
+       }
+       
        /**
         * Check if a user is sysop
         * Die with backtrace. Use User:isAllowed() instead.
         * @deprecated
         */
        function isSysop() {
-       /**
-               $this->loadFromDatabase();
-               if ( 0 == $this->mId ) { return false; }
-
-               return in_array( 'sysop', $this->mRights );
-       */
-       wfDebugDieBacktrace("User::isSysop() is deprecated. Use User::isAllowed() instead");
+               return $this->isAllowed( 'protect' );
        }
 
        /** @deprecated */
        function isDeveloper() {
-       /**
-               $this->loadFromDatabase();
-               if ( 0 == $this->mId ) { return false; }
-
-               return in_array( 'developer', $this->mRights );
-       */
-       wfDebugDieBacktrace("User::isDeveloper() is deprecated. Use User::isAllowed() instead");
+               return $this->isAllowed( 'siteadmin' );
        }
 
        /** @deprecated */
        function isBureaucrat() {
-       /**
-               $this->loadFromDatabase();
-               if ( 0 == $this->mId ) { return false; }
-
-               return in_array( 'bureaucrat', $this->mRights );
-       */
-       wfDebugDieBacktrace("User::isBureaucrat() is deprecated. Use User::isAllowed() instead");
+               return $this->isAllowed( 'makesysop' );
        }
 
        /**
@@ -622,10 +1021,6 @@ class User {
         */
        function isBot() {
                $this->loadFromDatabase();
-
-               # Why was this here? I need a UID=0 conversion script [TS]
-               # if ( 0 == $this->mId ) { return false; }
-
                return in_array( 'bot', $this->mRights );
        }
 
@@ -646,8 +1041,12 @@ class User {
        function &getSkin() {
                global $IP;
                if ( ! isset( $this->mSkin ) ) {
+                       $fname = 'User::getSkin';
+                       wfProfileIn( $fname );
+                       
                        # get all skin names available
                        $skinNames = Skin::getSkinNames();
+                       
                        # get the user skin
                        $userSkin = $this->getOption( 'skin' );
                        if ( $userSkin == '' ) { $userSkin = 'standard'; }
@@ -688,7 +1087,8 @@ class User {
                                $className = 'SkinStandard';
                                require_once( $IP.'/skins/Standard.php' );
                        }
-                       $this->mSkin = new $className;
+                       $this->mSkin =& new $className;
+                       wfProfileOut( $fname );
                }
                return $this->mSkin;
        }
@@ -723,8 +1123,85 @@ class User {
                $wl->removeWatch();
                $this->invalidateCache();
        }
+
+       /**
+        * Clear the user's notification timestamp for the given title.
+        * If e-notif e-mails are on, they will receive notification mails on
+        * the next change of the page if it's watched etc.
+        */
+       function clearNotification( &$title ) {
+               global $wgUser, $wgUseEnotif;
+
+               if ( !$wgUseEnotif ) {
+                       return;
+               }
+
+               $userid = $this->getID();
+               if ($userid==0) {
+                       return;
+               }
+               
+               // Only update the timestamp if the page is being watched. 
+               // The query to find out if it is watched is cached both in memcached and per-invocation,
+               // and when it does have to be executed, it can be on a slave
+               // If this is the user's newtalk page, we always update the timestamp
+               if ($title->getNamespace() == NS_USER_TALK &&
+                       $title->getText() == $wgUser->getName()) 
+               {
+                       $watched = true;
+               } elseif ( $this->getID() == $wgUser->getID() ) {
+                       $watched = $title->userIsWatching();
+               } else {
+                       $watched = true;
+               }
+               
+               // If the page is watched by the user (or may be watched), update the timestamp on any 
+               // any matching rows
+               if ( $watched ) {
+                       $dbw =& wfGetDB( DB_MASTER );
+                       $success = $dbw->update( 'watchlist',
+                                       array( /* SET */
+                                               'wl_notificationtimestamp' => 0
+                                       ), array( /* WHERE */
+                                               'wl_title' => $title->getDBkey(),
+                                               'wl_namespace' => $title->getNamespace(),
+                                               'wl_user' => $this->getID()
+                                       ), 'User::clearLastVisited'
+                       );
+               }
+       }
+       
        /**#@-*/
 
+       /**
+        * Resets all of the given user's page-change notification timestamps.
+        * If e-notif e-mails are on, they will receive notification mails on
+        * the next change of any watched page.
+        *
+        * @param int $currentUser user ID number
+        * @access public
+        */
+       function clearAllNotifications( $currentUser ) {
+               global $wgUseEnotif;
+               if ( !$wgUseEnotif ) {
+                       return;
+               }
+               if( $currentUser != 0 )  {
+       
+                       $dbw =& wfGetDB( DB_MASTER );
+                       $success = $dbw->update( 'watchlist',
+                               array( /* SET */
+                                       'wl_notificationtimestamp' => 0
+                               ), array( /* WHERE */
+                                       'wl_user' => $currentUser
+                               ), 'UserMailer::clearAll'
+                       );
+
+               #       we also need to clear here the "you have new message" notification for the own user_talk page
+               #       This is cleared one page view later in Article::viewUpdates();
+               }
+       }
+
        /**
         * @access private
         * @return string Encoding options
@@ -783,27 +1260,23 @@ class User {
 
                setcookie( $wgDBname.'UserID', '', time() - 3600, $wgCookiePath, $wgCookieDomain );
                setcookie( $wgDBname.'Token', '', time() - 3600, $wgCookiePath, $wgCookieDomain );
+
+               # Remember when user logged out, to prevent seeing cached pages
+               setcookie( $wgDBname.'LoggedOut', wfTimestampNow(), time() + 86400, $wgCookiePath, $wgCookieDomain );
        }
 
        /**
         * Save object settings into database
         */
        function saveSettings() {
-               global $wgMemc, $wgDBname;
+               global $wgMemc, $wgDBname, $wgUseEnotif;
                $fname = 'User::saveSettings';
 
-               $dbw =& wfGetDB( DB_MASTER );
-               if ( ! $this->getNewtalk() ) {
-                       # Delete user_newtalk row
-                       if( $this->mId ) {
-                               $dbw->delete( 'user_newtalk', array( 'user_id' => $this->mId ), $fname );
-                       } else {
-                               $dbw->delete( 'user_newtalk', array( 'user_ip' => $this->mName ), $fname );
-                               $wgMemc->delete( "$wgDBname:newtalk:ip:{$this->mName}" );
-                       }
-               }
+               if ( wfReadOnly() ) { return; }
+               $this->saveNewtalk();
                if ( 0 == $this->mId ) { return; }
-
+               
+               $dbw =& wfGetDB( DB_MASTER );
                $dbw->update( 'user',
                        array( /* SET */
                                'user_name' => $this->mName,
@@ -811,6 +1284,7 @@ class User {
                                'user_newpassword' => $this->mNewpassword,
                                'user_real_name' => $this->mRealName,
                                'user_email' => $this->mEmail,
+                               'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
                                'user_options' => $this->encodeOptions(),
                                'user_touched' => $dbw->timestamp($this->mTouched),
                                'user_token' => $this->mToken
@@ -818,22 +1292,80 @@ class User {
                                'user_id' => $this->mId
                        ), $fname
                );
-               $dbw->set( 'user_rights', 'ur_rights', implode( ',', $this->mRights ),
-                       'ur_user='. $this->mId, $fname ); 
                $wgMemc->delete( "$wgDBname:user:id:$this->mId" );
+       }
+       
+       /**
+        * Save value of new talk flag.
+        */
+       function saveNewtalk() {
+               global $wgDBname, $wgMemc, $wgUseEnotif;
                
-               // delete old groups
-               $dbw->delete( 'user_groups', array( 'ug_user' => $this->mId), $fname);
-               
-               // save new ones
-               foreach ($this->mGroups as $group) {
-                       $dbw->replace( 'user_groups',
-                               array(array('ug_user','ug_group')),
-                               array(
-                                       'ug_user' => $this->mId,
-                                       'ug_group' => $group
-                               ), $fname
-                       );
+               $fname = 'User::saveNewtalk';
+
+               $changed = false;
+
+               if ( wfReadOnly() ) { return ; }
+               $dbr =& wfGetDB( DB_SLAVE );
+               $dbw =& wfGetDB( DB_MASTER );
+               $changed = false;
+               if ( $wgUseEnotif ) {
+                       if ( ! $this->getNewtalk() ) {
+                               # Delete the watchlist entry for user_talk page X watched by user X
+                               $dbw->delete( 'watchlist',
+                                       array( 'wl_user'      => $this->mId,
+                                                  'wl_title'     => $this->getTitleKey(),
+                                                  'wl_namespace' => NS_USER_TALK ),
+                                       $fname );
+                               if ( $dbw->affectedRows() ) {
+                                       $changed = true;
+                               }
+                               if( !$this->mId ) {
+                                       # Anon users have a separate memcache space for newtalk
+                                       # since they don't store their own info. Trim...
+                                       $wgMemc->delete( "$wgDBname:newtalk:ip:{$this->mName}" );
+                               }
+                       }
+               } else {
+                       if ($this->getID() != 0) {
+                               $field = 'user_id';
+                               $value = $this->getID();
+                               $key = false;
+                       } else {
+                               $field = 'user_ip';
+                               $value = $this->mName;
+                               $key = "$wgDBname:newtalk:ip:$this->mName";
+                       }
+                       
+                       $dbr =& wfGetDB( DB_SLAVE );
+                       $dbw =& wfGetDB( DB_MASTER );
+
+                       $res = $dbr->selectField('user_newtalk', $field,
+                                                                        array($field => $value), $fname);
+
+                       $changed = true;
+                       if ($res !== false && $this->mNewtalk == 0) {
+                               $dbw->delete('user_newtalk', array($field => $value), $fname);
+                               if ( $key ) {
+                                       $wgMemc->set( $key, 0 );
+                               }
+                       } else if ($res === false && $this->mNewtalk == 1) {
+                               $dbw->insert('user_newtalk', array($field => $value), $fname);
+                               if ( $key ) {
+                                       $wgMemc->set( $key, 1 );
+                               }
+                       } else {
+                               $changed = false;
+                       }
+               }
+
+               # Update user_touched, so that newtalk notifications in the client cache are invalidated
+               if ( $changed && $this->getID() ) {
+                       $dbw->update('user', 
+                               /*SET*/ array( 'user_touched' => $this->mTouched ),
+                               /*WHERE*/ array( 'user_id' => $this->getID() ),
+                               $fname);
+                       $wgMemc->set( "$wgDBname:user:id:{$this->mId}", $this, 86400 );
                }
        }
 
@@ -869,31 +1401,17 @@ class User {
                                'user_password' => $this->mPassword,
                                'user_newpassword' => $this->mNewpassword,
                                'user_email' => $this->mEmail,
+                               'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
                                'user_real_name' => $this->mRealName,
                                'user_options' => $this->encodeOptions(),
                                'user_token' => $this->mToken
                        ), $fname
                );
                $this->mId = $dbw->insertId();
-               $dbw->insert( 'user_rights',
-                       array(
-                               'ur_user' => $this->mId,
-                               'ur_rights' => implode( ',', $this->mRights )
-                       ), $fname
-               );
-               
-               foreach ($this->mGroups as $group) {
-                       $dbw->insert( 'user_groups',
-                               array(
-                                       'ug_user' => $this->mId,
-                                       'ug_group' => $group
-                               ), $fname
-                       );
-               }
        }
 
        function spreadBlock() {
-               global $wgIP;
+               global $wgIP;
                # If the (non-anonymous) user is blocked, this function will block any IP address
                # that they successfully log on from.
                $fname = 'User::spreadBlock';
@@ -938,7 +1456,7 @@ class User {
        }
 
        function getPageRenderingHash() {
-        global $wgContLang;
+               global $wgContLang;
                if( $this->mHash ){
                        return $this->mHash;
                }
@@ -947,34 +1465,21 @@ class User {
                // it will always be 0 when this function is called by parsercache.
 
                $confstr =        $this->getOption( 'math' );
-               $confstr .= '!' . $this->getOption( 'highlightbroken' );
                $confstr .= '!' . $this->getOption( 'stubthreshold' );
-               $confstr .= '!' . $this->getOption( 'editsection' );
-               $confstr .= '!' . $this->getOption( 'editsectiononrightclick' );
-               $confstr .= '!' . $this->getOption( 'showtoc' );
                $confstr .= '!' . $this->getOption( 'date' );
                $confstr .= '!' . $this->getOption( 'numberheadings' );
                $confstr .= '!' . $this->getOption( 'language' );
-               // add in language variant option if there are multiple variants
-               // supported by the language object
-               if(sizeof($wgContLang->getVariants())>1) {
-                       $confstr .= '!' . $this->getOption( 'variant' );
-               }
+               $confstr .= '!' . $this->getOption( 'thumbsize' );
+               // add in language specific options, if any
+               $extra = $wgContLang->getExtraHashOptions();
+               $confstr .= $extra;
 
                $this->mHash = $confstr;
                return $confstr ;
        }
 
        function isAllowedToCreateAccount() {
-               global $wgWhitelistAccount;
-               $allowed = false;
-
-               if (!$wgWhitelistAccount) { return 1; }; // default behaviour
-               foreach ($wgWhitelistAccount as $right => $ok) {
-                       $userHasRight = (!strcmp($right, 'user') || in_array($right, $this->getRights()));
-                       $allowed |= ($ok && $userHasRight);
-               }
-               return $allowed;
+               return $this->isAllowed( 'createaccount' );
        }
 
        /**
@@ -985,9 +1490,26 @@ class User {
                return wfSetVar( $this->mDataLoaded, $loaded );
        }
 
+       /**
+        * Get this user's personal page title.
+        *
+        * @return Title
+        * @access public
+        */
        function getUserPage() {
                return Title::makeTitle( NS_USER, $this->mName );
        }
+       
+       /**
+        * Get this user's talk page title.
+        *
+        * @return Title
+        * @access public
+        */
+       function getTalkPage() {
+               $title = $this->getUserPage();
+               return $title->getTalkPage();
+       }
 
        /**
         * @static
@@ -1004,7 +1526,7 @@ class User {
         * @return bool True if it is a newbie.
         */
        function isNewbie() {
-               return $this->mId > User::getMaxID() * 0.99 && !$this->isSysop() && !$this->isBot() || $this->getID() == 0;
+               return $this->isAnon() || $this->mId > User::getMaxID() * 0.99 && !$this->isAllowed( 'delete' ) && !$this->isBot();
        }
 
        /**
@@ -1013,31 +1535,266 @@ class User {
         * @return bool True if the given password is correct otherwise False.
         */
        function checkPassword( $password ) {
+               global $wgAuth, $wgMinimalPasswordLength;
                $this->loadFromDatabase();
+
+               // Even though we stop people from creating passwords that
+               // are shorter than this, doesn't mean people wont be able
+               // to. Certain authentication plugins do NOT want to save
+               // domain passwords in a mysql database, so we should
+               // check this (incase $wgAuth->strict() is false).
+               if( strlen( $password ) < $wgMinimalPasswordLength ) {
+                       return false;
+               }
                
-               global $wgAuth;
                if( $wgAuth->authenticate( $this->getName(), $password ) ) {
                        return true;
                } elseif( $wgAuth->strict() ) {
                        /* Auth plugin doesn't allow local authentication */
                        return false;
                }
-               
                $ep = $this->encryptPassword( $password );
                if ( 0 == strcmp( $ep, $this->mPassword ) ) {
                        return true;
-               } elseif ( 0 == strcmp( $ep, $this->mNewpassword ) ) {
+               } elseif ( ($this->mNewpassword != '') && (0 == strcmp( $ep, $this->mNewpassword )) ) {
                        return true;
                } elseif ( function_exists( 'iconv' ) ) {
                        # Some wikis were converted from ISO 8859-1 to UTF-8, the passwords can't be converted
                        # Check for this with iconv
-/*                     $cp1252hash = $this->encryptPassword( iconv( 'UTF-8', 'WINDOWS-1252', $password ) );
+                       $cp1252hash = $this->encryptPassword( iconv( 'UTF-8', 'WINDOWS-1252', $password ) );
                        if ( 0 == strcmp( $cp1252hash, $this->mPassword ) ) {
                                return true;
-                       }*/
+                       }
                }
                return false;
        }
+       
+       /**
+        * Initialize (if necessary) and return a session token value
+        * which can be used in edit forms to show that the user's
+        * login credentials aren't being hijacked with a foreign form
+        * submission.
+        *
+        * @param mixed $salt - Optional function-specific data for hash.
+        *                      Use a string or an array of strings.
+        * @return string
+        * @access public
+        */
+       function editToken( $salt = '' ) {
+               if( !isset( $_SESSION['wsEditToken'] ) ) {
+                       $token = $this->generateToken();
+                       $_SESSION['wsEditToken'] = $token;
+               } else {
+                       $token = $_SESSION['wsEditToken'];
+               }
+               if( is_array( $salt ) ) {
+                       $salt = implode( '|', $salt );
+               }
+               return md5( $token . $salt );
+       }
+       
+       /**
+        * Generate a hex-y looking random token for various uses.
+        * Could be made more cryptographically sure if someone cares.
+        * @return string
+        */
+       function generateToken( $salt = '' ) {
+               $token = dechex( mt_rand() ) . dechex( mt_rand() );
+               return md5( $token . $salt );
+       }
+       
+       /**
+        * Check given value against the token value stored in the session.
+        * A match should confirm that the form was submitted from the
+        * user's own login session, not a form submission from a third-party
+        * site.
+        *
+        * @param string $val - the input value to compare
+        * @param string $salt - Optional function-specific data for hash
+        * @return bool
+        * @access public
+        */
+       function matchEditToken( $val, $salt = '' ) {
+               return ( $val == $this->editToken( $salt ) );
+       }
+       
+       /**
+        * Generate a new e-mail confirmation token and send a confirmation
+        * mail to the user's given address.
+        *
+        * @return mixed True on success, a WikiError object on failure.
+        */
+       function sendConfirmationMail() {
+               global $wgIP, $wgContLang;
+               $url = $this->confirmationTokenUrl( $expiration );
+               return $this->sendMail( wfMsg( 'confirmemail_subject' ),
+                       wfMsg( 'confirmemail_body',
+                               $wgIP,
+                               $this->getName(),
+                               $url,
+                               $wgContLang->timeanddate( $expiration, false ) ) );
+       }
+       
+       /**
+        * Send an e-mail to this user's account. Does not check for
+        * confirmed status or validity.
+        *
+        * @param string $subject
+        * @param string $body
+        * @param strong $from Optional from address; default $wgPasswordSender will be used otherwise.
+        * @return mixed True on success, a WikiError object on failure.
+        */
+       function sendMail( $subject, $body, $from = null ) {
+               if( is_null( $from ) ) {
+                       global $wgPasswordSender;
+                       $from = $wgPasswordSender;
+               }
+               
+               require_once( 'UserMailer.php' );
+               $error = userMailer( $this->getEmail(), $from, $subject, $body );
+               
+               if( $error == '' ) {
+                       return true;
+               } else {
+                       return new WikiError( $error );
+               }
+       }
+       
+       /**
+        * Generate, store, and return a new e-mail confirmation code.
+        * A hash (unsalted since it's used as a key) is stored.
+        * @param &$expiration mixed output: accepts the expiration time
+        * @return string
+        * @access private
+        */
+       function confirmationToken( &$expiration ) {
+               $fname = 'User::confirmationToken';
+               
+               $now = time();
+               $expires = $now + 7 * 24 * 60 * 60;
+               $expiration = wfTimestamp( TS_MW, $expires );
+               
+               $token = $this->generateToken( $this->mId . $this->mEmail . $expires );
+               $hash = md5( $token );
+               
+               $dbw =& wfGetDB( DB_MASTER );
+               $dbw->update( 'user',
+                       array( 'user_email_token'         => $hash,
+                              'user_email_token_expires' => $dbw->timestamp( $expires ) ),
+                       array( 'user_id'                  => $this->mId ),
+                       $fname );
+               
+               return $token;
+       }
+       
+       /**
+        * Generate and store a new e-mail confirmation token, and return
+        * the URL the user can use to confirm.
+        * @param &$expiration mixed output: accepts the expiration time
+        * @return string
+        * @access private
+        */
+       function confirmationTokenUrl( &$expiration ) {
+               $token = $this->confirmationToken( $expiration );
+               $title = Title::makeTitle( NS_SPECIAL, 'Confirmemail/' . $token );
+               return $title->getFullUrl();
+       }
+       
+       /**
+        * Mark the e-mail address confirmed and save.
+        */
+       function confirmEmail() {
+               $this->loadFromDatabase();
+               $this->mEmailAuthenticated = wfTimestampNow();
+               $this->saveSettings();
+               return true;
+       }
+       
+       /**
+        * Is this user allowed to send e-mails within limits of current
+        * site configuration?
+        * @return bool
+        */
+       function canSendEmail() {
+               return $this->isEmailConfirmed();
+       }
+       
+       /**
+        * Is this user allowed to receive e-mails within limits of current
+        * site configuration?
+        * @return bool
+        */
+       function canReceiveEmail() {
+               return $this->canSendEmail() && !$this->getOption( 'disablemail' );
+       }
+       
+       /**
+        * Is this user's e-mail address valid-looking and confirmed within
+        * limits of the current site configuration?
+        *
+        * If $wgEmailAuthentication is on, this may require the user to have
+        * confirmed their address by returning a code or using a password
+        * sent to the address from the wiki.
+        *
+        * @return bool
+        */
+       function isEmailConfirmed() {
+               global $wgEmailAuthentication;
+               $this->loadFromDatabase();
+               if( $this->isAnon() )
+                       return false;
+               if( !$this->isValidEmailAddr( $this->mEmail ) )
+                       return false;
+               if( $wgEmailAuthentication && !$this->getEmailAuthenticationTimestamp() )
+                       return false;
+               return true;
+       }
+       
+       /**
+        * @param array $groups list of groups
+        * @return array list of permission key names for given groups combined
+        * @static
+        */
+       function getGroupPermissions( $groups ) {
+               global $wgGroupPermissions;
+               $rights = array();
+               foreach( $groups as $group ) {
+                       if( isset( $wgGroupPermissions[$group] ) ) {
+                               $rights = array_merge( $rights,
+                                       array_keys( array_filter( $wgGroupPermissions[$group] ) ) );
+                       }
+               }
+               return $rights;
+       }
+
+       /**
+        * @param string $group key name
+        * @return string localized descriptive name, if provided
+        * @static
+        */
+       function getGroupName( $group ) {
+               $key = "group-$group-name";
+               $name = wfMsg( $key );
+               if( $name == '' || $name == "&lt;$key&gt;" ) {
+                       return $group;
+               } else {
+                       return $name;
+               }
+       }
+       
+       /**
+        * Return the set of defined explicit groups.
+        * The * and 'user' groups are not included.
+        * @return array
+        * @static
+        */
+       function getAllGroups() {
+               global $wgGroupPermissions;
+               return array_diff(
+                       array_keys( $wgGroupPermissions ),
+                       array( '*', 'user' ) );
+       }
+
 }
 
 ?>