mediawiki-extensions-Discus.../includes/SubscriptionItem.php
Bartosz Dziewoński bcd92a5d33 Minor cleanups in topic subscription code
For automatic topic subscriptions, I plan to introduce a third
subscription state to indicate them. This patch includes minor tweaks
I wanted to add while working on that:

* Introduce constants instead of numbers
* Remove a TODO that doesn't seem like a good idea any more
* Remove a `"length": 1` on sub_state that did not do anything
  (but it might have been meant to indicate that it was supposed
  to be a boolean, which would be wrong)

Bug: T284836
Change-Id: I6e6096968ad38510102287bccd349090b6ca4280
2021-08-17 22:22:15 +02:00

92 lines
1.9 KiB
PHP

<?php
namespace MediaWiki\Extension\DiscussionTools;
use MediaWiki\Linker\LinkTarget;
use MediaWiki\User\UserIdentity;
/**
* Representation of a subscription to a given topic.
*/
class SubscriptionItem {
private $itemName;
private $linkTarget;
private $user;
private $state;
private $createdTimestamp;
private $notifiedTimestamp;
/**
* @param UserIdentity $user
* @param string $itemName
* @param LinkTarget $linkTarget
* @param int $state One of SubscriptionStore::STATE_* constants
* @param string|null $createdTimestamp When the subscription was created
* @param string|null $notifiedTimestamp When the item subscribed to last tried to trigger
* a notification (even if muted).
*/
public function __construct(
UserIdentity $user,
string $itemName,
linkTarget $linkTarget,
int $state,
?string $createdTimestamp,
?string $notifiedTimestamp
) {
$this->user = $user;
$this->itemName = $itemName;
$this->linkTarget = $linkTarget;
$this->state = $state;
$this->createdTimestamp = $createdTimestamp;
$this->notifiedTimestamp = $notifiedTimestamp;
}
/**
* @return UserIdentity
*/
public function getUserIdentity(): UserIdentity {
return $this->user;
}
/**
* @return string
*/
public function getItemName(): string {
return $this->itemName;
}
/**
* @return LinkTarget
*/
public function getLinkTarget(): LinkTarget {
return $this->linkTarget;
}
/**
* Get the creation timestamp of this entry.
*
* @return string|null
*/
public function getCreatedTimestamp() {
return $this->createdTimestamp;
}
/**
* Get the notification timestamp of this entry.
*
* @return string|null
*/
public function getNotificationTimestamp() {
return $this->notifiedTimestamp;
}
/**
* Check if the notification is muted
*
* @return bool
*/
public function isMuted(): bool {
return $this->state === SubscriptionStore::STATE_UNSUBSCRIBED;
}
}