WatchedItemStoreInterface.php

Go to the documentation of this file.

<?php
use MediaWiki\Linker\LinkTarget;
use MediaWiki\User\UserIdentity;
use Wikimedia\Rdbms\DBUnexpectedError;

interface WatchedItemStoreInterface {

    const SORT_ASC = 'ASC';

    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 getNotificationTimestampsBatch( UserIdentity $user, array $targets );

    public function addWatch( UserIdentity $user, LinkTarget $target );

    public function addWatchBatchForUser( UserIdentity $user, array $targets );

    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 clearUserWatchedItemsUsingJobQueue( UserIdentity $user );

    public function removeWatchBatchForUser( UserIdentity $user, array $targets );

    public function getLatestNotificationTimestamp(
        $timestamp, UserIdentity $user, LinkTarget $target );
}