Inheritance diagram for NoWriteWatchedItemStore:

Collaboration diagram for NoWriteWatchedItemStore:

Public Member Functions
	__construct (WatchedItemStoreInterface $actualStore)
	Initialy set WatchedItemStore that will be used in cases where writing is not needed. More...

	addWatch (User $user, LinkTarget $target)
	Must be called separately for Subject & Talk namespaces. More...

	addWatchBatchForUser (User $user, array $targets)

	clearUserWatchedItems (User $user)
	Queues a job that will clear the users watchlist using the Job Queue. More...

	clearUserWatchedItemsUsingJobQueue (User $user)
	Queues a job that will clear the users watchlist using the Job Queue. More...

	countUnreadNotifications (User $user, $unreadLimit=null)

	countVisitingWatchers (LinkTarget $target, $threshold)
	Number of page watchers who also visited a "recent" edit. More...

	countVisitingWatchersMultiple (array $targetsWithVisitThresholds, $minimumWatchers=null)
	Number of watchers of each page who have visited recent edits to that page. More...

	countWatchedItems (User $user)
	Count the number of individual items that are watched by the user. More...

	countWatchers (LinkTarget $target)

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

	duplicateAllAssociatedEntries (LinkTarget $oldTarget, LinkTarget $newTarget)
	Check if the given title already is watched by the user, and if so add a watch for the new title. More...

	duplicateEntry (LinkTarget $oldTarget, LinkTarget $newTarget)
	Check if the given title already is watched by the user, and if so add a watch for the new title. More...

	getLatestNotificationTimestamp ( $timestamp, User $user, LinkTarget $target)
	Convert $timestamp to TS_MW or return null if the page was visited since then by $user. More...

	getNotificationTimestampsBatch (User $user, array $targets)

	getWatchedItem (User $user, LinkTarget $target)
	Get an item (may be cached) More...

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

	isWatched (User $user, LinkTarget $target)
	Must be called separately for Subject & Talk namespaces. More...

	loadWatchedItem (User $user, LinkTarget $target)
	Loads an item from the db. More...

	removeWatch (User $user, LinkTarget $target)
	Removes an entry for the User watching the LinkTarget Must be called separately for Subject & Talk namespaces. More...

	removeWatchBatchForUser (User $user, array $titles)

	resetAllNotificationTimestampsForUser (User $user)
	Reset all watchlist notificaton timestamps for a user using the job queue. More...

	resetNotificationTimestamp (User $user, Title $title, $force='', $oldid=0)
	Reset the notification timestamp of this entry. More...

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

	updateNotificationTimestamp (User $editor, LinkTarget $target, $timestamp)

Private Attributes
WatchedItemStoreInterface	$actualStore

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

const	SORT_DESC = 'DESC'

Detailed Description

Definition at line 28 of file NoWriteWatchedItemStore.php.

Constructor & Destructor Documentation

◆ __construct()

NoWriteWatchedItemStore::__construct ( WatchedItemStoreInterface $actualStore )

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

Parameters

WatchedItemStoreInterface $actualStore

Definition at line 44 of file NoWriteWatchedItemStore.php.

References $actualStore.

Member Function Documentation

◆ addWatch()

NoWriteWatchedItemStore::addWatch	(	User	$user,
		LinkTarget	$target
	)

Must be called separately for Subject & Talk namespaces.

Since: 1.31

Parameters

User	$user
LinkTarget	$target

Implements WatchedItemStoreInterface.

Definition at line 106 of file NoWriteWatchedItemStore.php.

◆ addWatchBatchForUser()

NoWriteWatchedItemStore::addWatchBatchForUser	(	User	$user,
		array	$targets
	)

Since: 1.31

Parameters

User	$user
LinkTarget[]	$targets

Returns: bool success

Implements WatchedItemStoreInterface.

Definition at line 110 of file NoWriteWatchedItemStore.php.

◆ clearUserWatchedItems()

NoWriteWatchedItemStore::clearUserWatchedItems ( User $user )

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

Since: 1.31

Parameters

User $user

Implements WatchedItemStoreInterface.

Definition at line 143 of file NoWriteWatchedItemStore.php.

◆ clearUserWatchedItemsUsingJobQueue()

NoWriteWatchedItemStore::clearUserWatchedItemsUsingJobQueue ( User $user )

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

Since: 1.31

Parameters

User $user

Implements WatchedItemStoreInterface.

Definition at line 147 of file NoWriteWatchedItemStore.php.

◆ countUnreadNotifications()

NoWriteWatchedItemStore::countUnreadNotifications	(	User	$user,
			$unreadLimit = `null`
	)

Since: 1.31

Parameters

User	$user
int \| null	$unreadLimit

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

Implements WatchedItemStoreInterface.

Definition at line 94 of file NoWriteWatchedItemStore.php.

References $user.

◆ countVisitingWatchers()

NoWriteWatchedItemStore::countVisitingWatchers	(	LinkTarget	$target,
			$threshold
	)

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

Since: 1.31

Parameters

LinkTarget	$target
mixed	$threshold	timestamp accepted by wfTimestamp

Returns: int

Exceptions

DBUnexpectedError
MWException

Implements WatchedItemStoreInterface.

Definition at line 56 of file NoWriteWatchedItemStore.php.

◆ countVisitingWatchersMultiple()

NoWriteWatchedItemStore::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 $target, mixed $threshold), $threshold is: a timestamp of the recent edit if $target exists (format accepted by wfTimestamp) null if $target doesn't exist
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).

Implements WatchedItemStoreInterface.

Definition at line 64 of file NoWriteWatchedItemStore.php.

◆ countWatchedItems()

NoWriteWatchedItemStore::countWatchedItems ( User $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

User $user

Returns: int

Implements WatchedItemStoreInterface.

Definition at line 48 of file NoWriteWatchedItemStore.php.

References $user.

◆ countWatchers()

NoWriteWatchedItemStore::countWatchers ( LinkTarget $target )

Since: 1.31

Parameters

LinkTarget $target

Returns: int

Implements WatchedItemStoreInterface.

Definition at line 52 of file NoWriteWatchedItemStore.php.

◆ countWatchersMultiple()

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

Since: 1.31

Parameters

LinkTarget[]	$targets
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.

Implements WatchedItemStoreInterface.

Definition at line 60 of file NoWriteWatchedItemStore.php.

References $options.

◆ duplicateAllAssociatedEntries()

NoWriteWatchedItemStore::duplicateAllAssociatedEntries	(	LinkTarget	$oldTarget,
		LinkTarget	$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	$oldTarget
LinkTarget	$newTarget

Implements WatchedItemStoreInterface.

Definition at line 98 of file NoWriteWatchedItemStore.php.

◆ duplicateEntry()

NoWriteWatchedItemStore::duplicateEntry	(	LinkTarget	$oldTarget,
		LinkTarget	$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	$oldTarget
LinkTarget	$newTarget

Implements WatchedItemStoreInterface.

Definition at line 102 of file NoWriteWatchedItemStore.php.

◆ getLatestNotificationTimestamp()

NoWriteWatchedItemStore::getLatestNotificationTimestamp	(		$timestamp,
		User	$user,
		LinkTarget	$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 users

Usage of this method should be limited to WatchedItem* classes

Parameters

string \| null	$timestamp	Value of wl_notificationtimestamp from the DB
User	$user
LinkTarget	$target

Returns: string TS_MW timestamp or null

Implements WatchedItemStoreInterface.

Definition at line 155 of file NoWriteWatchedItemStore.php.

References wfTimestampOrNull().

◆ getNotificationTimestampsBatch()

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

Since: 1.31

Parameters

User	$user
LinkTarget[]	$targets

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.

Implements WatchedItemStoreInterface.

Definition at line 90 of file NoWriteWatchedItemStore.php.

References $user.

◆ getWatchedItem()

NoWriteWatchedItemStore::getWatchedItem	(	User	$user,
		LinkTarget	$target
	)

Get an item (may be cached)

Since: 1.31

Parameters

User	$user
LinkTarget	$target

Returns: WatchedItem|false

Implements WatchedItemStoreInterface.

Definition at line 74 of file NoWriteWatchedItemStore.php.

References $user.

◆ getWatchedItemsForUser()

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

Since: 1.31

Parameters

User	$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

Returns: WatchedItem[]

Implements WatchedItemStoreInterface.

Definition at line 82 of file NoWriteWatchedItemStore.php.

References $options, and $user.

◆ isWatched()

NoWriteWatchedItemStore::isWatched	(	User	$user,
		LinkTarget	$target
	)

Must be called separately for Subject & Talk namespaces.

Since: 1.31

Parameters

User	$user
LinkTarget	$target

Returns: bool

Implements WatchedItemStoreInterface.

Definition at line 86 of file NoWriteWatchedItemStore.php.

References $user.

◆ loadWatchedItem()

NoWriteWatchedItemStore::loadWatchedItem	(	User	$user,
		LinkTarget	$target
	)

Loads an item from the db.

Since: 1.31

Parameters

User	$user
LinkTarget	$target

Returns: WatchedItem|false

Implements WatchedItemStoreInterface.

Definition at line 78 of file NoWriteWatchedItemStore.php.

References $user.

◆ removeWatch()

NoWriteWatchedItemStore::removeWatch	(	User	$user,
		LinkTarget	$target
	)

Removes an entry for the User watching the LinkTarget Must be called separately for Subject & Talk namespaces.

Since: 1.31

Parameters

User	$user
LinkTarget	$target

Returns: bool success

Exceptions

DBUnexpectedError
MWException

Implements WatchedItemStoreInterface.

Definition at line 114 of file NoWriteWatchedItemStore.php.

◆ removeWatchBatchForUser()

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

Since: 1.32

Parameters

User	$user
LinkTarget[]	$targets

Returns: bool success

Implements WatchedItemStoreInterface.

Definition at line 151 of file NoWriteWatchedItemStore.php.

◆ resetAllNotificationTimestampsForUser()

NoWriteWatchedItemStore::resetAllNotificationTimestampsForUser ( User $user )

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

Since: 1.31

Parameters

User $user The user to reset the timestamps for

Implements WatchedItemStoreInterface.

Definition at line 130 of file NoWriteWatchedItemStore.php.

◆ resetNotificationTimestamp()

NoWriteWatchedItemStore::resetNotificationTimestamp	(	User	$user,
		Title	$title,
			$force = `''`,
			$oldid = `0`
	)

Reset the notification timestamp of this entry.

Since: 1.31

Parameters

User	$user
Title	$title
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

Implements WatchedItemStoreInterface.

Definition at line 134 of file NoWriteWatchedItemStore.php.

◆ setNotificationTimestampsForUser()

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

Since: 1.31

Parameters

User	$user	The user to set the timestamps for
string \| null	$timestamp	Set the update timestamp to this value
LinkTarget[]	$targets	List of targets to update. Default to all targets

Returns: bool success

Implements WatchedItemStoreInterface.

Definition at line 118 of file NoWriteWatchedItemStore.php.

◆ updateNotificationTimestamp()

NoWriteWatchedItemStore::updateNotificationTimestamp	(	User	$editor,
		LinkTarget	$target,
			$timestamp
	)

Since: 1.31

Parameters

User	$editor	The editor that triggered the update. Their notification timestamp will not be updated(they have already seen it)
LinkTarget	$target	The target to update timestamps for
string	$timestamp	Set the update timestamp to this value

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

Implements WatchedItemStoreInterface.

Definition at line 126 of file NoWriteWatchedItemStore.php.

Member Data Documentation

◆ $actualStore

WatchedItemStoreInterface NoWriteWatchedItemStore::$actualStore

private

Definition at line 33 of file NoWriteWatchedItemStore.php.

Referenced by __construct().

The documentation for this class was generated from the following file:

includes/watcheditem/NoWriteWatchedItemStore.php

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addWatch()

◆ addWatchBatchForUser()

◆ clearUserWatchedItems()

◆ clearUserWatchedItemsUsingJobQueue()

◆ countUnreadNotifications()

◆ countVisitingWatchers()

◆ countVisitingWatchersMultiple()

◆ countWatchedItems()

◆ countWatchers()

◆ countWatchersMultiple()

◆ duplicateAllAssociatedEntries()

◆ duplicateEntry()

◆ getLatestNotificationTimestamp()

◆ getNotificationTimestampsBatch()

◆ getWatchedItem()

◆ getWatchedItemsForUser()

◆ isWatched()

◆ loadWatchedItem()

◆ removeWatch()

◆ removeWatchBatchForUser()

◆ resetAllNotificationTimestampsForUser()

◆ resetNotificationTimestamp()

◆ setNotificationTimestampsForUser()

◆ updateNotificationTimestamp()

Member Data Documentation

◆ $actualStore