WatchedItem.php

Go to the documentation of this file.

<?php
use MediaWiki\Linker\LinkTarget;
use MediaWiki\User\UserIdentity;
 
class WatchedItem {
    private $linkTarget;
 
    private $user;
 
    private $notificationTimestamp;
 
    private $expiry;
 
    private const SECONDS_IN_A_DAY = 86400;
 
    public function __construct(
        UserIdentity $user,
        LinkTarget $linkTarget,
        $notificationTimestamp,
        ?string $expiry = null
    ) {
        $this->user = $user;
        $this->linkTarget = $linkTarget;
        $this->notificationTimestamp = $notificationTimestamp;
        $this->expiry = $expiry;
    }
 
    public static function newFromRecentChange( RecentChange $recentChange, UserIdentity $user ) {
        return new self(
            $user,
            $recentChange->getTitle(),
            $recentChange->notificationtimestamp,
            $recentChange->watchlistExpiry
        );
    }
 
    public function getUser() {
        return User::newFromIdentity( $this->user );
    }
 
    public function getUserIdentity() {
        return $this->user;
    }
 
    public function getLinkTarget() {
        return $this->linkTarget;
    }
 
    public function getNotificationTimestamp() {
        return $this->notificationTimestamp;
    }
 
    public function getExpiry(): ?string {
        return $this->expiry;
    }
 
    public function isExpired(): bool {
        if ( $this->getExpiry() === null ) {
            return false;
        }
 
        $unix = MWTimestamp::convert( TS_UNIX, $this->getExpiry() );
        return $unix < wfTimestamp();
    }
 
    public function getExpiryInDays(): ?int {
        if ( $this->getExpiry() === null ) {
            return null;
        }
 
        $unixTimeExpiry = MWTimestamp::convert( TS_UNIX, $this->getExpiry() );
        $diffInSeconds = $unixTimeExpiry - wfTimestamp();
        $diffInDays = $diffInSeconds / self::SECONDS_IN_A_DAY;
 
        if ( $diffInDays < 1 ) {
            return 0;
        }
 
        return (int)ceil( $diffInDays );
    }
}