3 namespace BookStack\Activity;
5 use BookStack\Activity\Models\Activity;
6 use BookStack\Entities\Models\Book;
7 use BookStack\Entities\Models\Chapter;
8 use BookStack\Entities\Models\Entity;
9 use BookStack\Entities\Models\Page;
10 use BookStack\Entities\Tools\MixedEntityListLoader;
11 use BookStack\Permissions\PermissionApplicator;
12 use BookStack\Users\Models\User;
13 use Illuminate\Database\Eloquent\Builder;
14 use Illuminate\Database\Eloquent\Relations\MorphTo;
15 use Illuminate\Database\Eloquent\Relations\Relation;
19 public function __construct(
20 protected PermissionApplicator $permissions,
21 protected MixedEntityListLoader $listLoader,
26 * Gets the latest activity.
28 public function latest(int $count = 20, int $page = 0): array
30 $activityList = $this->permissions
31 ->restrictEntityRelationQuery(Activity::query(), 'activities', 'loggable_id', 'loggable_type')
32 ->orderBy('created_at', 'desc')
34 ->skip($count * $page)
38 $this->listLoader->loadIntoRelations($activityList->all(), 'loggable', false);
40 return $this->filterSimilar($activityList);
44 * Gets the latest activity for an entity, Filtering out similar
45 * items to prevent a message activity list.
47 public function entityActivity(Entity $entity, int $count = 20, int $page = 1): array
49 /** @var array<string, int[]> $queryIds */
50 $queryIds = [$entity->getMorphClass() => [$entity->id]];
52 if ($entity instanceof Book) {
53 $queryIds[(new Chapter())->getMorphClass()] = $entity->chapters()->scopes('visible')->pluck('id');
55 if ($entity instanceof Book || $entity instanceof Chapter) {
56 $queryIds[(new Page())->getMorphClass()] = $entity->pages()->scopes('visible')->pluck('id');
59 $query = Activity::query();
60 $query->where(function (Builder $query) use ($queryIds) {
61 foreach ($queryIds as $morphClass => $idArr) {
62 $query->orWhere(function (Builder $innerQuery) use ($morphClass, $idArr) {
63 $innerQuery->where('loggable_type', '=', $morphClass)
64 ->whereIn('loggable_id', $idArr);
69 $activity = $query->orderBy('created_at', 'desc')
70 ->with(['loggable' => function (Relation $query) {
71 /** @var MorphTo<Entity, Activity> $query */
72 $query->withTrashed();
74 ->skip($count * ($page - 1))
78 return $this->filterSimilar($activity);
82 * Get the latest activity for a user, Filtering out similar items.
84 public function userActivity(User $user, int $count = 20, int $page = 0): array
86 $activityList = $this->permissions
87 ->restrictEntityRelationQuery(Activity::query(), 'activities', 'loggable_id', 'loggable_type')
88 ->orderBy('created_at', 'desc')
89 ->where('user_id', '=', $user->id)
90 ->skip($count * $page)
94 return $this->filterSimilar($activityList);
98 * Filters out similar activity.
100 * @param Activity[] $activities
102 protected function filterSimilar(iterable $activities): array
105 $previousItem = null;
107 foreach ($activities as $activityItem) {
108 if (!$previousItem || !$activityItem->isSimilarTo($previousItem)) {
109 $newActivity[] = $activityItem;
112 $previousItem = $activityItem;