Inherits WatchedItemStoreInterface.

Collaboration diagram for NoWriteWatchedItemStore:

[legend]

Public Member Functions

__construct (WatchedItemStoreInterface $actualStore)

Initially set WatchedItemStore that will be used in cases where writing is not needed.

addWatch (UserIdentity $user, $target, ?string $expiry=null)

Must be called separately for Subject & Talk namespaces.

Since: 1.31 Method added.; 1.35 Accepts $expiry parameter.

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36
string \| null	$expiry	Optional expiry timestamp in any format acceptable to wfTimestamp(). null will not create an expiry, or leave it unchanged should one already exist.

addWatchBatchForUser (UserIdentity $user, array $targets, ?string $expiry=null)

Since: 1.31 Method added.; 1.35 Accepts $expiry parameter.

Parameters

UserIdentity	$user
LinkTarget[] \| PageIdentity[]	$targets	deprecated passing LinkTarget[] since 1.36
string \| null	$expiry	Optional expiry timestamp in any format acceptable to wfTimestamp(), null will not create expiries, or leave them unchanged should they already exist.

Returns: bool success

clearUserWatchedItems (UserIdentity $user)

Synchronously clear the users watchlist.

Since: 1.31

Parameters

UserIdentity $user

Returns: bool True on success, false if {

See also: clearUserWatchedItemsUsingJobQueue} must be used instead

clearUserWatchedItemsUsingJobQueue (UserIdentity $user)

Queues a job that will clear the users watchlist using the Job Queue.

Since: 1.31

Parameters

UserIdentity $user

countExpired ()

Get the number of watchlist items that expire before the current time.

Since: 1.35

Returns: int

countUnreadNotifications (UserIdentity $user, $unreadLimit=null)

Since: 1.31

Parameters

UserIdentity	$user
int \| null	$unreadLimit

Returns: int|bool The number of unread notifications true if greater than or equal to $unreadLimit

countVisitingWatchers ( $target, $threshold)

Number of page watchers who also visited a "recent" edit.

Since: 1.31

Parameters

LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36
mixed	$threshold	timestamp accepted by wfTimestamp

Returns: int

countVisitingWatchersMultiple (array $targetsWithVisitThresholds, $minimumWatchers=null)

Number of watchers of each page who have visited recent edits to that page.

Since: 1.31

Parameters

array	$targetsWithVisitThresholds	array of pairs (LinkTarget\|PageIdentity $target, mixed $threshold), $threshold is: a timestamp of the recent edit if $target exists (format accepted by wfTimestamp) null if $target doesn't exist deprecated passing LinkTarget since 1.36
int \| null	$minimumWatchers

Returns

array multi-dimensional like $return[$namespaceId][$titleString] = $watchers, where $watchers is an int:

if the page exists, number of users watching who have visited the page recently
if the page doesn't exist, number of users that have the page on their watchlist
0 means there are no visiting watchers or their number is below the minimumWatchers option (if passed).

countWatchedItems (UserIdentity $user)

Count the number of individual items that are watched by the user.If a subject and corresponding talk page are watched this will return 2.

Since: 1.31

Parameters

UserIdentity $user

Returns: int

countWatchers ( $target)

Since: 1.31

Parameters

LinkTarget | PageIdentity $target deprecated passing LinkTarget since 1.36

Returns: int

countWatchersMultiple (array $targets, array $options=[])

Since: 1.31

Parameters

LinkTarget[] \| PageIdentity[]	$targets	deprecated passing LinkTarget[] since 1.36
array	$options	Allowed keys: 'minimumWatchers' => int

Returns: array multi dimensional like $return[$namespaceId][$titleString] = int $watchers All targets will be present in the result. 0 either means no watchers or the number of watchers was below the minimumWatchers option if passed.

duplicateAllAssociatedEntries ( $oldTarget, $newTarget)

Check if the given title already is watched by the user, and if so add a watch for the new title.To be used for page renames and such.

Since: 1.31

Parameters

LinkTarget \| PageIdentity	$oldTarget	deprecated passing LinkTarget since 1.36
LinkTarget \| PageIdentity	$newTarget	deprecated passing LinkTarget since 1.36

duplicateEntry ( $oldTarget, $newTarget)

Check if the given title already is watched by the user, and if so add a watch for the new title.To be used for page renames and such. This must be called separately for Subject and Talk pages

Since: 1.31

Parameters

LinkTarget \| PageIdentity	$oldTarget	deprecated passing LinkTarget since 1.36
LinkTarget \| PageIdentity	$newTarget	deprecated passing LinkTarget since 1.36

getLatestNotificationTimestamp ( $timestamp, UserIdentity $user, $target)

Convert $timestamp to TS_MW or return null if the page was visited since then by $user.Use this only on single-user methods (having higher read-after-write expectations) and not in places involving arbitrary batches of different usersUsage of this method should be limited to WatchedItem* classes

Parameters

string \| null	$timestamp	Value of wl_notificationtimestamp from the DB
UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: string|null TS_MW timestamp of first unseen revision or null if there isn't one

getNotificationTimestampsBatch (UserIdentity $user, array $targets)

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget[] \| PageIdentity[]	$targets	deprecated passing LinkTarget[] since 1.36

Returns

array multi-dimensional like $return[$namespaceId][$titleString] = $timestamp, where $timestamp is:

string|null value of wl_notificationtimestamp,
false if $target is not watched by $user.

getWatchedItem (UserIdentity $user, $target)

Get an item (may be cached)

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: WatchedItem|false

getWatchedItemsForUser (UserIdentity $user, array $options=[])

Since: 1.31 Method Added; 1.35 Allows 'sortByExpiry' as a key in $options

Parameters

UserIdentity	$user
array	$options	Allowed keys: 'forWrite' => bool defaults to false 'sort' => string optional sorting by namespace ID and title one of the self::SORT_* constants 'sortByExpiry' => bool optional sorts by expiration date, with the titles that will expire soonest at the top.

Returns: WatchedItem[]

isTempWatched (UserIdentity $user, $target)

Whether the page is only being watched temporarily (has expiry).Must be called separately for Subject & Talk namespaces.

Since: 1.35

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: bool

isWatched (UserIdentity $user, $target)

Must be called separately for Subject & Talk namespaces.

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: bool

loadWatchedItem (UserIdentity $user, $target)

Loads an item from the db.

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: WatchedItem|false

loadWatchedItemsBatch (UserIdentity $user, array $targets)

Loads a set of WatchedItems from the db.

Since: 1.36

Parameters

UserIdentity	$user
LinkTarget[] \| PageIdentity[]	$targets	deprecated passing LinkTarget[] since 1.36

Returns: WatchedItem[]|false

maybeEnqueueWatchlistExpiryJob ()

Probabilistically add a job to purge the expired watchlist items, if watchlist expiration is enabled, based on the value of $wgWatchlistPurgeRate.

Since: 1.36

mustClearWatchedItemsUsingJobQueue (UserIdentity $user)

Does the size of the users watchlist require clearUserWatchedItemsUsingJobQueue() to be used instead of clearUserWatchedItems()

Since: 1.35

Parameters

UserIdentity $user

Returns: bool

removeExpired (int $limit, bool $deleteOrphans=false)

Remove some number of expired watchlist items.

Since: 1.35

Parameters

int	$limit	The number of items to remove.
bool	$deleteOrphans	Whether to also delete `watchlist_expiry` rows that have no related `watchlist` rows (because not all code knows about the expiry table yet). This runs two extra queries, so is only done from the purgeExpiredWatchlistItems.php maintenance script.

removeWatch (UserIdentity $user, $target)

Removes an entry for the UserIdentity watching the target (LinkTarget or PageIdentity) Must be called separately for Subject & Talk namespaces.

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36

Returns: bool success

removeWatchBatchForUser (UserIdentity $user, array $targets)

Since: 1.32

Parameters

UserIdentity	$user
LinkTarget[] \| PageIdentity[]	$targets	deprecated passing LinkTarget[] since 1.36

Returns: bool success

resetAllNotificationTimestampsForUser (UserIdentity $user, $timestamp=null)

Reset all watchlist notification timestamps for a user using the job queue.

Since: 1.31

Parameters

UserIdentity	$user	The user to reset the timestamps for
string \| int \| null	$timestamp	Value to set all timestamps to, null to clear them

resetNotificationTimestamp (UserIdentity $user, $title, $force='', $oldid=0)

Reset the notification timestamp of this entry.

Since: 1.31

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$title	deprecated passing LinkTarget since 1.36
string	$force	Whether to force the write query to be executed even if the page is not watched or the notification timestamp is already NULL. 'force' in order to force
int	$oldid	The revision id being viewed. If not given or 0, latest revision is assumed.

Returns: bool success Whether a job was enqueued

setNotificationTimestampsForUser (UserIdentity $user, $timestamp, array $targets=[])

Since: 1.31

Parameters

UserIdentity	$user	The user to set the timestamps for
string \| null	$timestamp	Set the update timestamp to this value
LinkTarget[] \| PageIdentity[]	$targets	List of targets to update. Default to all targets. deprecated passing LinkTarget[] since 1.36

Returns: bool success

updateNotificationTimestamp (UserIdentity $editor, $target, $timestamp)

Since: 1.31

Parameters

UserIdentity	$editor	The editor that triggered the update. Their notification timestamp will not be updated(they have already seen it)
LinkTarget \| PageIdentity	$target	The target to update timestamps for deprecated passing LinkTarget since 1.36
string	$timestamp	Set the update (first unseen revision) timestamp to this value

Returns: int[] Array of user IDs the timestamp has been updated for

Additional Inherited Members
Public Attributes inherited from WatchedItemStoreInterface
const	SORT_ASC = 'ASC'

const	SORT_DESC = 'DESC'

Detailed Description

Access: internal

Since: 1.31

Definition at line 30 of file NoWriteWatchedItemStore.php.

Constructor & Destructor Documentation

◆ __construct()

NoWriteWatchedItemStore::__construct ( WatchedItemStoreInterface $actualStore )

Initially set WatchedItemStore that will be used in cases where writing is not needed.

Parameters

WatchedItemStoreInterface $actualStore

Definition at line 40 of file NoWriteWatchedItemStore.php.

Member Function Documentation

◆ addWatch()

NoWriteWatchedItemStore::addWatch	(	UserIdentity	$user,
			$target,
		?string	$expiry = null )

Must be called separately for Subject & Talk namespaces.

Since: 1.31 Method added.; 1.35 Accepts $expiry parameter.

Parameters

UserIdentity	$user
LinkTarget \| PageIdentity	$target	deprecated passing LinkTarget since 1.36
string \| null	$expiry	Optional expiry timestamp in any format acceptable to wfTimestamp(). null will not create an expiry, or leave it unchanged should one already exist.

NoWriteWatchedItemStore::addWatchBatchForUser	(	UserIdentity	$user,
		array	$targets,
		?string	$expiry = null )

NoWriteWatchedItemStore::countUnreadNotifications	(	UserIdentity	$user,
			$unreadLimit = null )

NoWriteWatchedItemStore::countVisitingWatchers	(		$target,
			$threshold )

NoWriteWatchedItemStore::countVisitingWatchersMultiple	(	array	$targetsWithVisitThresholds,
			$minimumWatchers = null )

NoWriteWatchedItemStore::countWatchersMultiple	(	array	$targets,
		array	$options = [] )

NoWriteWatchedItemStore::duplicateAllAssociatedEntries	(		$oldTarget,
			$newTarget )

NoWriteWatchedItemStore::duplicateEntry	(		$oldTarget,
			$newTarget )

NoWriteWatchedItemStore::getLatestNotificationTimestamp	(		$timestamp,
		UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::getNotificationTimestampsBatch	(	UserIdentity	$user,
		array	$targets )

NoWriteWatchedItemStore::getWatchedItem	(	UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::getWatchedItemsForUser	(	UserIdentity	$user,
		array	$options = [] )

NoWriteWatchedItemStore::isTempWatched	(	UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::isWatched	(	UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::loadWatchedItem	(	UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::removeExpired	(	int	$limit,
		bool	$deleteOrphans = false )

NoWriteWatchedItemStore::removeWatch	(	UserIdentity	$user,
			$target )

NoWriteWatchedItemStore::removeWatchBatchForUser	(	UserIdentity	$user,
		array	$targets )

NoWriteWatchedItemStore::resetAllNotificationTimestampsForUser	(	UserIdentity	$user,
			$timestamp = null )

NoWriteWatchedItemStore::resetNotificationTimestamp	(	UserIdentity	$user,
			$title,
			$force = '',
			$oldid = 0 )

NoWriteWatchedItemStore::setNotificationTimestampsForUser	(	UserIdentity	$user,
			$timestamp,
		array	$targets = [] )

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addWatch()

◆ addWatchBatchForUser()

◆ clearUserWatchedItems()

◆ clearUserWatchedItemsUsingJobQueue()

◆ countExpired()

◆ countUnreadNotifications()

◆ countVisitingWatchers()

◆ countVisitingWatchersMultiple()

◆ countWatchedItems()

◆ countWatchers()

◆ countWatchersMultiple()

◆ duplicateAllAssociatedEntries()

◆ duplicateEntry()

◆ getLatestNotificationTimestamp()

◆ getNotificationTimestampsBatch()

◆ getWatchedItem()

◆ getWatchedItemsForUser()

◆ isTempWatched()

◆ isWatched()

◆ loadWatchedItem()

◆ loadWatchedItemsBatch()

◆ maybeEnqueueWatchlistExpiryJob()

◆ mustClearWatchedItemsUsingJobQueue()

◆ removeExpired()

◆ removeWatch()

◆ removeWatchBatchForUser()

◆ resetAllNotificationTimestampsForUser()

◆ resetNotificationTimestamp()

◆ setNotificationTimestampsForUser()

◆ updateNotificationTimestamp()

NoWriteWatchedItemStore::updateNotificationTimestamp	(	UserIdentity	$editor,
			$target,
			$timestamp )