. // }}} namespace Component\Notification\Entity; use App\Core\DB\DB; use App\Core\Entity; use App\Entity\Activity; use App\Entity\Actor; use DateTimeInterface; /** * Entity for attentions * * @category DB * @package GNUsocial * * @author Zach Copley * @copyright 2010 StatusNet Inc. * @author Mikael Nordfeldth * @copyright 2009-2014 Free Software Foundation, Inc http://www.fsf.org * @author Hugo Sales * @copyright 2020-2021 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ class Notification extends Entity { // {{{ Autocode // @codeCoverageIgnoreStart private int $activity_id; private int $target_id; private ?string $reason = null; private DateTimeInterface $created; private DateTimeInterface $modified; public function setActivityId(int $activity_id): self { $this->activity_id = $activity_id; return $this; } public function getActivityId(): int { return $this->activity_id; } public function setTargetId(int $target_id): self { $this->target_id = $target_id; return $this; } public function getTargetId(): int { return $this->target_id; } public function setReason(?string $reason): self { $this->reason = \is_null($reason) ? null : mb_substr($reason, 0, 191); return $this; } public function getReason(): ?string { return $this->reason; } public function setCreated(DateTimeInterface $created): self { $this->created = $created; return $this; } public function getCreated(): DateTimeInterface { return $this->created; } public function setModified(DateTimeInterface $modified): self { $this->modified = $modified; return $this; } public function getModified(): DateTimeInterface { return $this->modified; } // @codeCoverageIgnoreEnd // }}} Autocode public function getTarget(): Actor { return Actor::getById($this->getTargetId()); } /** * Pull the complete list of known activity context notifications for this activity. * * @return array of integer actor ids (also group profiles) */ public static function getNotificationTargetIdsByActivity(int|Activity $activity_id): array { $notifications = DB::findBy('notification', ['activity_id' => \is_int($activity_id) ? $activity_id : $activity_id->getId()]); $targets = []; foreach ($notifications as $notification) { $targets[] = $notification->getTargetId(); } return $targets; } public function getNotificationTargetsByActivity(int|Activity $activity_id): array { return DB::findBy('actor', ['id' => $this->getNotificationTargetIdsByActivity($activity_id)]); } public static function schemaDef(): array { return [ 'name' => 'notification', 'description' => 'Activity notification for actors (that are not a mention and not result of a subscription)', 'fields' => [ 'activity_id' => ['type' => 'int', 'foreign key' => true, 'target' => 'Activity.id', 'multiplicity' => 'one to one', 'not null' => true, 'description' => 'activity_id to give attention'], 'target_id' => ['type' => 'int', 'foreign key' => true, 'target' => 'Actor.id', 'multiplicity' => 'one to one', 'not null' => true, 'description' => 'actor_id for feed receiver'], 'reason' => ['type' => 'varchar', 'length' => 191, 'description' => 'Optional reason why this was brought to the attention of actor_id'], 'created' => ['type' => 'datetime', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was created'], 'modified' => ['type' => 'timestamp', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was modified'], ], 'primary key' => ['activity_id', 'target_id'], 'indexes' => [ 'attention_activity_id_idx' => ['activity_id'], 'attention_target_id_idx' => ['target_id'], ], ]; } }