WatchlistNotificationManager service. More...
Public Member Functions | |
| __construct (ServiceOptions $options, HookContainer $hookContainer, PermissionManager $permissionManager, ReadOnlyMode $readOnlyMode, RevisionLookup $revisionLookup, TalkPageNotificationManager $talkPageNotificationManager, WatchedItemStoreInterface $watchedItemStore) | |
| clearAllUserNotifications (UserIdentity $user) | |
| Resets all of the given user's page-change notification timestamps. More... | |
| clearTitleUserNotifications (UserIdentity $user, LinkTarget $title, int $oldid=0) | |
| Clear the user's notification timestamp for the given title. More... | |
| getTitleNotificationTimestamp (UserIdentity $user, LinkTarget $title) | |
| Get the timestamp when this page was updated since the user last saw it. More... | |
Public Attributes | |
| const | CONSTRUCTOR_OPTIONS |
Private Attributes | |
| HookRunner | $hookRunner |
| array | $notificationTimestampCache = [] |
| Cache for getTitleNotificationTimestamp. More... | |
| ServiceOptions | $options |
| PermissionManager | $permissionManager |
| ReadOnlyMode | $readOnlyMode |
| RevisionLookup | $revisionLookup |
| TalkPageNotificationManager | $talkPageNotificationManager |
| WatchedItemStoreInterface | $watchedItemStore |
Detailed Description
WatchlistNotificationManager service.
- Since
- 1.35
Definition at line 40 of file WatchlistNotificationManager.php.
Constructor & Destructor Documentation
◆ __construct()
| MediaWiki\User\WatchlistNotificationManager::__construct | ( | ServiceOptions | $options, |
| HookContainer | $hookContainer, | ||
| PermissionManager | $permissionManager, | ||
| ReadOnlyMode | $readOnlyMode, | ||
| RevisionLookup | $revisionLookup, | ||
| TalkPageNotificationManager | $talkPageNotificationManager, | ||
| WatchedItemStoreInterface | $watchedItemStore | ||
| ) |
- Parameters
-
ServiceOptions $options HookContainer $hookContainer PermissionManager $permissionManager ReadOnlyMode $readOnlyMode RevisionLookup $revisionLookup TalkPageNotificationManager $talkPageNotificationManager WatchedItemStoreInterface $watchedItemStore
Definition at line 95 of file WatchlistNotificationManager.php.
References MediaWiki\User\WatchlistNotificationManager\$options, MediaWiki\User\WatchlistNotificationManager\$permissionManager, MediaWiki\User\WatchlistNotificationManager\$readOnlyMode, MediaWiki\User\WatchlistNotificationManager\$revisionLookup, MediaWiki\User\WatchlistNotificationManager\$talkPageNotificationManager, MediaWiki\User\WatchlistNotificationManager\$watchedItemStore, and MediaWiki\Config\ServiceOptions\assertRequiredOptions().
Member Function Documentation
◆ clearAllUserNotifications()
| MediaWiki\User\WatchlistNotificationManager::clearAllUserNotifications | ( | UserIdentity | $user | ) |
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.
- Note
- If the user doesn't have 'editmywatchlist', this will do nothing.
- Parameters
-
UserIdentity $user
Definition at line 123 of file WatchlistNotificationManager.php.
References MediaWiki\User\UserIdentity\getId().
◆ clearTitleUserNotifications()
| MediaWiki\User\WatchlistNotificationManager::clearTitleUserNotifications | ( | UserIdentity | $user, |
| LinkTarget | $title, | ||
| int | $oldid = 0 |
||
| ) |
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.
- Note
- If the user doesn't have 'editmywatchlist', this will do nothing.
- Parameters
-
UserIdentity $user LinkTarget $title int $oldid The revision id being viewed. If not given or 0, latest revision is assumed.
Definition at line 163 of file WatchlistNotificationManager.php.
References MediaWiki\User\WatchlistNotificationManager\$revisionLookup, MediaWiki\User\WatchlistNotificationManager\$talkPageNotificationManager, $title, DeferredUpdates\addCallableUpdate(), MediaWiki\User\UserIdentity\getName(), Revision\RevisionLookup\getNextRevision(), Revision\RevisionLookup\getRevisionById(), if, MediaWiki\User\UserIdentity\isRegistered(), NS_USER_TALK, MediaWiki\User\TalkPageNotificationManager\removeUserHasNewMessages(), MediaWiki\User\TalkPageNotificationManager\setUserHasNewMessages(), and MediaWiki\User\TalkPageNotificationManager\userHasNewMessages().
◆ getTitleNotificationTimestamp()
| MediaWiki\User\WatchlistNotificationManager::getTitleNotificationTimestamp | ( | UserIdentity | $user, |
| LinkTarget | $title | ||
| ) |
Get the timestamp when this page was updated since the user last saw it.
- Parameters
-
UserIdentity $user LinkTarget $title
- Returns
- string|bool|null String timestamp, false if not watched, null if nothing is unseen
Definition at line 254 of file WatchlistNotificationManager.php.
References $title, and MediaWiki\User\UserIdentity\getId().
Member Data Documentation
◆ $hookRunner
|
private |
Definition at line 51 of file WatchlistNotificationManager.php.
◆ $notificationTimestampCache
|
private |
Cache for getTitleNotificationTimestamp.
Keys need to reflect both the specific user and the title:
Since only users have watchlists, the user is represented with u⧼user id⧽
Since the method accepts LinkTarget objects, cannot rely on the object's toString, since it is different for TitleValue and Title. Implement a simplified string representation of the string that TitleValue uses: ⧼namespace number⧽:⧼db key⧽
Entries are in the form of u⧼user id⧽-⧼namespace number⧽:⧼db key⧽ => ⧼timestamp or false⧽
Definition at line 84 of file WatchlistNotificationManager.php.
◆ $options
|
private |
Definition at line 48 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct().
◆ $permissionManager
|
private |
Definition at line 54 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct().
◆ $readOnlyMode
|
private |
Definition at line 57 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct().
◆ $revisionLookup
|
private |
Definition at line 60 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct(), and MediaWiki\User\WatchlistNotificationManager\clearTitleUserNotifications().
◆ $talkPageNotificationManager
|
private |
Definition at line 63 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct(), and MediaWiki\User\WatchlistNotificationManager\clearTitleUserNotifications().
◆ $watchedItemStore
|
private |
Definition at line 66 of file WatchlistNotificationManager.php.
Referenced by MediaWiki\User\WatchlistNotificationManager\__construct().
◆ CONSTRUCTOR_OPTIONS
| const MediaWiki\User\WatchlistNotificationManager::CONSTRUCTOR_OPTIONS |
Definition at line 42 of file WatchlistNotificationManager.php.
The documentation for this class was generated from the following file:
- includes/user/WatchlistNotificationManager.php
