WatchedItemStoreInterface.php

Go to the documentation of this file.

<?php
use MediaWiki\Linker\LinkTarget;
use MediaWiki\User\UserIdentity;
use Wikimedia\Rdbms\DBUnexpectedError;
 
interface WatchedItemStoreInterface {
 
    public const SORT_ASC = 'ASC';
 
    public const SORT_DESC = 'DESC';
 
    public function countWatchedItems( UserIdentity $user );
 
    public function countWatchers( LinkTarget $target );
 
    public function countVisitingWatchers( LinkTarget $target, $threshold );
 
    public function countWatchersMultiple( array $targets, array $options = [] );
 
    public function countVisitingWatchersMultiple(
        array $targetsWithVisitThresholds,
        $minimumWatchers = null
    );
 
    public function getWatchedItem( UserIdentity $user, LinkTarget $target );
 
    public function loadWatchedItem( UserIdentity $user, LinkTarget $target );
 
    public function getWatchedItemsForUser( UserIdentity $user, array $options = [] );
 
    public function isWatched( UserIdentity $user, LinkTarget $target );
 
    public function isTempWatched( UserIdentity $user, LinkTarget $target ): bool;
 
    public function getNotificationTimestampsBatch( UserIdentity $user, array $targets );
 
    public function addWatch( UserIdentity $user, LinkTarget $target, ?string $expiry = null );
 
    public function addWatchBatchForUser( UserIdentity $user, array $targets, ?string $expiry = null );
 
    public function removeWatch( UserIdentity $user, LinkTarget $target );
 
    public function setNotificationTimestampsForUser(
        UserIdentity $user,
        $timestamp,
        array $targets = []
    );
 
    public function resetAllNotificationTimestampsForUser( UserIdentity $user, $timestamp = null );
 
    public function updateNotificationTimestamp(
        UserIdentity $editor, LinkTarget $target, $timestamp );
 
    public function resetNotificationTimestamp(
        UserIdentity $user, LinkTarget $title, $force = '', $oldid = 0 );
 
    public function countUnreadNotifications( UserIdentity $user, $unreadLimit = null );
 
    public function duplicateAllAssociatedEntries( LinkTarget $oldTarget, LinkTarget $newTarget );
 
    public function duplicateEntry( LinkTarget $oldTarget, LinkTarget $newTarget );
 
    public function clearUserWatchedItems( UserIdentity $user );
 
    public function mustClearWatchedItemsUsingJobQueue( UserIdentity $user ): bool;
 
    public function clearUserWatchedItemsUsingJobQueue( UserIdentity $user );
 
    public function enqueueWatchlistExpiryJob( float $watchlistPurgeRate ): void;
 
    public function removeWatchBatchForUser( UserIdentity $user, array $targets );
 
    public function getLatestNotificationTimestamp(
        $timestamp, UserIdentity $user, LinkTarget $target );
 
    public function countExpired(): int;
 
    public function removeExpired( int $limit, bool $deleteOrphans = false ): void;
}