Jump to content

Wikia code/includes/WatchedItem.php

From mediawiki.org
--- D:\Programming\SVN\mediawiki\branches\REL1_16\phase3\includes\WatchedItem.php	2011-07-18 22:31:28.034179700 +0100
+++ D:\Programming\SVN\wikia\trunk\includes\WatchedItem.php	2011-08-17 15:28:46.394531200 +0100
@@ -53,27 +53,30 @@
 	 */
 	public function addWatch() {
 		wfProfileIn( __METHOD__ );
+		$rows = array();
 
 		// Use INSERT IGNORE to avoid overwriting the notification timestamp
 		// if there's already an entry for this page
 		$dbw = wfGetDB( DB_MASTER );
-		$dbw->insert( 'watchlist',
-		  array(
+		$timestamp = null;
+		
+		$rows[] = array(
 			'wl_user' => $this->id,
 			'wl_namespace' => MWNamespace::getSubject($this->ns),
 			'wl_title' => $this->ti,
-			'wl_notificationtimestamp' => null
-		  ), __METHOD__, 'IGNORE' );
+			'wl_notificationtimestamp' => $timestamp
+		);
 
-		// Every single watched page needs now to be listed in watchlist;
-		// namespace:page and namespace_talk:page need separate entries:
-		$dbw->insert( 'watchlist',
-		  array(
+		$rows[] = array(
 			'wl_user' => $this->id,
 			'wl_namespace' => MWNamespace::getTalk($this->ns),
 			'wl_title' => $this->ti,
-			'wl_notificationtimestamp' => null
-		  ), __METHOD__, 'IGNORE' );
+			'wl_notificationtimestamp' => $timestamp
+		);
+		
+		$dbw->insert( 'watchlist', $rows, __METHOD__, 'IGNORE' );
+		
+		wfRunHooks( 'WatchedItem::addWatch', array ( $this ) );
 
 		wfProfileOut( __METHOD__ );
 		return true;
@@ -112,10 +116,50 @@
 		if ( $dbw->affectedRows() ) {
 			$success = true;
 		}
+		
+		wfRunHooks( 'WatchedItem::removeWatch', array ( $this, $success ) );
+				
 		return $success;
 	}
 
 	/**
+	 * Wikia changes: update watch in database
+	 * @param $watchers Array: array of users IDs. If empty, $this->id is taken
+	 * @param $timestamp: update timestamp
+	 * @return bool (always true)
+	 */
+	public function updateWatch( /*Array*/$watchers = null, $timestamp = null ) {
+		$dbw = wfGetDB( DB_MASTER );
+		
+		$user = ( !empty($watchers) ) ? $watchers : $this->id;
+		$ts = ( !is_null( $timestamp ) ) ? $dbw->timestamp( $timestamp ) : null;
+		
+		$dbw->begin();
+		$dbw->update( 'watchlist',
+				array( /* SET */
+					'wl_notificationtimestamp' => $ts
+				), array( /* WHERE */
+					'wl_title' => $this->ti,
+					'wl_namespace' => $this->ns,
+					'wl_user' => $user
+				), __METHOD__
+		);
+		$dbw->commit();
+		
+		wfRunHooks( 'WatchedItem::updateWatch', array ( $this, $user, $ts ) );
+		
+		return true;	
+	}
+	
+	/**
+	 * Wikia changes: clear user's notification 
+	 * @return bool (always true)
+	 */
+	public function clearWatch() {
+		return $this->updateWatch();
+	}
+
+	/**
 	 * Check if the given title already is watched by the user, and if so
 	 * add watches on a new title. To be used for page renames and such.
 	 *
@@ -161,6 +205,9 @@
 		# Note that multi-row replace is very efficient for MySQL but may be inefficient for
 		# some other DBMSes, mostly due to poor simulation by us
 		$dbw->replace( 'watchlist', array( array( 'wl_user', 'wl_namespace', 'wl_title' ) ), $values, __METHOD__ );
+		
+		wfRunHooks( 'WatchedItem::replaceWatch', array ( $ot, $nt, $values ) );
+				
 		return true;
 	}
 }