* (bug 2094) Multiple use of a template produced wrong results in some cases
[lhc/web/wiklou.git] / includes / User.php
index 5272730..7fafeb7 100644 (file)
@@ -1,6 +1,6 @@
 <?php
 /**
- * See user.doc
+ * See user.txt
  *
  * @package MediaWiki
  */
@@ -23,7 +23,7 @@ class User {
         * @access private
         */
        var $mId, $mName, $mPassword, $mEmail, $mNewtalk;
-       var $mEmailAuthenticationtimestamp;
+       var $mEmailAuthenticated;
        var $mRights, $mOptions;
        var $mDataLoaded, $mNewpassword;
        var $mSkin;
@@ -43,8 +43,9 @@ class User {
 
        /**
         * Static factory method
-        * @static
         * @param string $name Username, validated by Title:newFromText()
+        * @return User
+        * @static
         */
        function newFromName( $name ) {
                $u = new User();
@@ -60,6 +61,30 @@ class User {
                        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 {
+                       return null;
+               }
+       }
 
        /**
         * Get username given an id.
@@ -108,21 +133,36 @@ 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("/^
+                       (?:[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);*/
        }
 
        /**
         * does the string match roughly an email address ?
+        *
+        * @bug 959
+        *
         * @param string $addr email address
         * @static
+        * @return bool
         */
        function isValidEmailAddr ( $addr ) {
-               return preg_match( '/^([a-z0-9_.-]+([a-z0-9_.-]+)*\@[a-z0-9_-]+([a-z0-9_.-]+)*([a-z.]{2,})+)$/', strtolower($addr));
+               # There used to be a regular expression here, it got removed because it
+               # rejected valid addresses.
+               return ( trim( $addr ) != '' ) &&
+                       (false !== strpos( $addr, '@' ) );
        }
 
        /**
@@ -160,7 +200,7 @@ class User {
                $this->mNewtalk = -1;
                $this->mName = $wgIP;
                $this->mRealName = $this->mEmail = '';
-               $this->mEmailAuthenticationtimestamp = 0;
+               $this->mEmailAuthenticated = null;
                $this->mPassword = $this->mNewpassword = '';
                $this->mRights = array();
                $this->mGroups = array();
@@ -251,8 +291,8 @@ class User {
         * 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( $bFromSlave = false ) {
-               global $wgIP, $wgBlockCache, $wgProxyList;
+       function getBlockedStatus( $bFromSlave = true ) {
+               global $wgIP, $wgBlockCache, $wgProxyList, $wgEnableSorbs, $wgProxyWhitelist;
 
                if ( -1 != $this->mBlockedby ) { return; }
 
@@ -265,6 +305,7 @@ class User {
                        if ( $block->load( $wgIP , $this->mId ) ) {
                                $this->mBlockedby = $block->mBy;
                                $this->mBlockreason = $block->mReason;
+                               $this->spreadBlock();
                        }
                }
 
@@ -272,7 +313,7 @@ class User {
                if ( !$this->mBlockedby ) {
                        # Check first against slave, and optionally from master.
                        $block = $wgBlockCache->get( $wgIP, true );
-                       if ( !block && !$bFromSlave )
+                       if ( !$block && !$bFromSlave )
                                {
                                # Not blocked: check against master, to make sure.
                                $wgBlockCache->clearLocal( );
@@ -285,22 +326,143 @@ 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' );
                        }
+
+                       # DNSBL
+                       if ( !$this->mBlockedby && $wgEnableSorbs ) {
+                               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( $bFromSlave = false ) {
                $this->getBlockedStatus( $bFromSlave );
-               if ( 0 === $this->mBlockedby ) { return false; }
-               return true;
+               return $this->mBlockedby !== 0;
        }
        
        /**
@@ -392,7 +554,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
@@ -431,14 +592,14 @@ class User {
                
                $dbr =& wfGetDB( DB_SLAVE );
                $s = $dbr->selectRow( 'user', array( 'user_name','user_password','user_newpassword','user_email',
-                 'user_emailauthenticationtimestamp',
+                 '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->mEmailAuthenticationtimestamp = wfTimestamp(TS_MW,$s->user_emailauthenticationtimestamp);
+                       $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;
@@ -448,13 +609,16 @@ class User {
 
                        // Get groups id
                        $res = $dbr->select( 'user_groups', array( 'ug_group' ), array( 'ug_user' => $this->mId ) );
+                       
+                       // add the default group for logged in user
+                       $this->mGroups = array( $wgLoggedInGroupId );
 
                        while($group = $dbr->fetchRow($res)) {
-                               $this->mGroups[] = $group[0];
+                               if ( $group[0] != $wgLoggedInGroupId ) {
+                                       $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
@@ -592,13 +756,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( $wgSecretKey . mt_rand( 0, 0x7fffffff ) . $wgDBname . $this->mId );
                } else {
                        $this->mToken = $token;
                }
@@ -620,9 +787,9 @@ class User {
                return $this->mEmail;
        }
 
-       function getEmailAuthenticationtimestamp() {
+       function getEmailAuthenticationTimestamp() {
                $this->loadFromDatabase();
-               return $this->mEmailAuthenticationtimestamp;
+               return $this->mEmailAuthenticated;
        }
 
        function setEmail( $str ) {
@@ -681,41 +848,43 @@ class User {
                $this->invalidateCache();
        }
 
+       /**
+        * 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' );
        }
 
        /**
@@ -724,10 +893,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 );
        }
 
@@ -836,20 +1001,41 @@ class User {
         * 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 ) {
-               $userid = $this->getId();
+       function clearNotification( &$title ) {
+               global $wgUser;
+
+               $userid = $this->getID();
                if ($userid==0)
                        return;
-               $dbw =& wfGetDB( DB_MASTER );
-               $success = $dbw->update( 'watchlist',
-                               array( /* SET */
-                                       'wl_notificationtimestamp' => $dbw->timestamp(0)
-                               ), array( /* WHERE */
-                                       'wl_title' => $title->getDBkey(),
-                                       'wl_namespace' => $title->getNamespace(),
-                                       'wl_user' => $this->getId()
-                               ), 'User::clearLastVisited'
-               );
+               
+               // 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'
+                       );
+               }
        }
        
        /**#@-*/
@@ -973,7 +1159,7 @@ class User {
                                'user_newpassword' => $this->mNewpassword,
                                'user_real_name' => $this->mRealName,
                                'user_email' => $this->mEmail,
-                               'user_emailauthenticationtimestamp' => $dbw->timestamp($this->mEmailAuthenticationtimestamp),
+                               'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
                                'user_options' => $this->encodeOptions(),
                                'user_touched' => $dbw->timestamp($this->mTouched),
                                'user_token' => $this->mToken
@@ -1033,7 +1219,7 @@ class User {
                                'user_password' => $this->mPassword,
                                'user_newpassword' => $this->mNewpassword,
                                'user_email' => $this->mEmail,
-                               'user_emailauthenticationtimestamp' => $dbw->timestamp($this->mEmailAuthenticationtimestamp),
+                               'user_email_authenticated' => $dbw->timestampOrNull( $this->mEmailAuthenticated ),
                                'user_real_name' => $this->mRealName,
                                'user_options' => $this->encodeOptions(),
                                'user_token' => $this->mToken
@@ -1112,14 +1298,12 @@ 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' );
+               $confstr .= '!' . $this->getOption( 'thumbsize' );
                // add in language specific options, if any
                $extra = $wgContLang->getExtraHashOptions();
                $confstr .= $extra;
@@ -1148,9 +1332,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
@@ -1167,7 +1368,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();
        }
 
        /**
@@ -1189,9 +1390,6 @@ class User {
                if ( 0 == strcmp( $ep, $this->mPassword ) ) {
                        return true;
                } elseif ( ($this->mNewpassword != '') && (0 == strcmp( $ep, $this->mNewpassword )) ) {
-                       $this->mEmailAuthenticationtimestamp = wfTimestampNow();
-                       $this->mNewpassword = ''; # use the temporary one-time password only once: clear it now !
-                       $this->saveSettings();
                        return true;
                } elseif ( function_exists( 'iconv' ) ) {
                        # Some wikis were converted from ISO 8859-1 to UTF-8, the passwords can't be converted
@@ -1203,6 +1401,187 @@ class User {
                }
                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;
+       }
 }
 
 ?>