. */ namespace Poniverse\Ponyfm\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\SoftDeletes; /** * Poniverse\Ponyfm\Models\Activity * * @property integer $id * @property \Carbon\Carbon $created_at * @property integer $user_id * @property boolean $activity_type * @property boolean $resource_type * @property integer $resource_id * @property-read \Illuminate\Database\Eloquent\Collection|\Poniverse\Ponyfm\Models\Notification[] $notifications * @property-read \Poniverse\Ponyfm\Models\User $initiatingUser * @property-read \Poniverse\Ponyfm\Models\Activity $resource * @property-read mixed $url * @property-read mixed $thumbnail_url * @property-read mixed $text * @property string $deleted_at * @property-read \Illuminate\Database\Eloquent\Collection|\Poniverse\Ponyfm\Models\User[] $notificationRecipients * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereId($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereCreatedAt($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereUserId($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereActivityType($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereResourceType($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereResourceId($value) * @method static \Illuminate\Database\Query\Builder|\Poniverse\Ponyfm\Models\Activity whereDeletedAt($value) * @mixin \Eloquent */ class Activity extends Model { use SoftDeletes; public $timestamps = false; protected $dates = ['created_at']; protected $fillable = ['created_at', 'user_id', 'activity_type', 'resource_type', 'resource_id']; protected $appends = ['url', 'thumbnail_url', 'human_friendly_resource_type']; protected $casts = [ 'id' => 'integer', 'created_at' => 'datetime', 'user_id' => 'integer', 'activity_type' => 'integer', // resource_type has its own accessor and mutator 'resource_id' => 'integer', ]; /** * These constants are stored in the "activity_types" table for the purpose * of referential data integrity. Any additions or changes to them MUST * include a database migration to apply the changes to that table as well. */ const TYPE_NEWS = 1; const TYPE_PUBLISHED_TRACK = 2; const TYPE_PUBLISHED_ALBUM = 3; const TYPE_PUBLISHED_PLAYLIST = 4; const TYPE_NEW_FOLLOWER = 5; const TYPE_NEW_COMMENT = 6; const TYPE_CONTENT_FAVOURITED = 7; /** * Activity types to subscribe new users to email notifications for. */ const DEFAULT_EMAIL_TYPES = [ Activity::TYPE_PUBLISHED_TRACK, Activity::TYPE_PUBLISHED_ALBUM, Activity::TYPE_PUBLISHED_PLAYLIST, Activity::TYPE_NEW_FOLLOWER, Activity::TYPE_NEW_COMMENT, Activity::TYPE_CONTENT_FAVOURITED, ]; /** * These "target" constants are an implementation detail of this model and * should not be used directly in other classes. They're used to efficiently * store the type of resource this notification is about in the database. * * The "resource_type" attribute is transformed into a class name at runtime * so that the use of an integer in the database to represent this info * remains an implementation detail of this model. Outside of this class, * the resource_type attribute should be treated as a fully-qualified class * name. */ const TARGET_USER = 1; const TARGET_TRACK = 2; const TARGET_ALBUM = 3; const TARGET_PLAYLIST = 4; const TARGET_COMMENT = 5; public function initiatingUser() { return $this->belongsTo(User::class, 'user_id', 'id'); } public function notifications() { return $this->hasMany(Notification::class, 'activity_id', 'id'); } public function notificationRecipients() { return $this->hasManyThrough(User::class, Notification::class, 'activity_id', 'user_id', 'id'); } public function resource() { return $this->morphTo('resource', 'resource_type', 'resource_id'); } public function getUrlAttribute() { if (static::TYPE_NEW_FOLLOWER === $this->activity_type) { return $this->initiatingUser->url; } else { return $this->resource->url; } } public function getResourceTypeAttribute($value) { switch ($value) { case static::TARGET_USER: return User::class; case static::TARGET_TRACK: return Track::class; case static::TARGET_ALBUM: return Album::class; case static::TARGET_PLAYLIST: return Playlist::class; case static::TARGET_COMMENT: return Comment::class; default: // Null must be returned here for Eloquent's eager-loading // of the polymorphic relation to work. return null; } } public function setResourceTypeAttribute($value) { switch ($value) { case User::class: $this->attributes['resource_type'] = static::TARGET_USER; break; case Track::class: $this->attributes['resource_type'] = static::TARGET_TRACK; break; case Album::class: $this->attributes['resource_type'] = static::TARGET_ALBUM; break; case Playlist::class: $this->attributes['resource_type'] = static::TARGET_PLAYLIST; break; case Comment::class: $this->attributes['resource_type'] = static::TARGET_COMMENT; break; } } public function getThumbnailUrlAttribute() { if ( in_array($this->activity_type, [static::TYPE_CONTENT_FAVOURITED, static::TYPE_NEW_FOLLOWER]) ) { return $this->initiatingUser->getAvatarUrl(Image::SMALL); } else { switch ($this->resource_type) { case User::class: return $this->resource->getAvatarUrl(Image::SMALL); case Track::class: case Album::class: case Playlist::class: return $this->resource->getCoverUrl(Image::SMALL); case Comment::class: return $this->resource->user->getAvatarUrl(Image::SMALL); default: throw new \Exception('This activity\'s resource is of an unknown type!'); } } } public function getTitleFromActivityType() { switch ($this->activity_type) { case static::TYPE_PUBLISHED_TRACK: return "Pony.fm - New track"; case static::TYPE_PUBLISHED_PLAYLIST: return "Pony.fm - New playlist"; case static::TYPE_NEW_FOLLOWER: return "Pony.fm - New follower"; case static::TYPE_NEW_COMMENT: return "Pony.fm - New comment"; case static::TYPE_CONTENT_FAVOURITED: return "Pony.fm - Favourited"; default: return "Pony.fm - Unknown"; } } /** * Returns a string representing the type of resource this activity is about * for use in human-facing notification text. * * @return string * @throws \Exception */ public function getResourceTypeString():string { switch($this->activity_type) { case static::TYPE_NEW_COMMENT: return $this->resource->resource->getResourceType(); case static::TYPE_CONTENT_FAVOURITED: return $this->resource->getResourceType(); } throw new \Exception("Unknown activity type {$this->activity_type} - cannot determine resource type."); } /** * @return bool */ public function isProfileComment():bool { return static::TYPE_NEW_COMMENT === $this->activity_type && User::class === $this->resource->getResourceClass(); } /** * The string this method generates is used for email subject lines as well * as on-site notifications. * * @return string human-readable Markdown string describing this notification * @throws \Exception */ public function getTextAttribute() { switch ($this->activity_type) { case static::TYPE_NEWS: // not implemented yet throw new \InvalidArgumentException('This type of activity has not been implemented yet!'); case static::TYPE_PUBLISHED_TRACK: return "{$this->resource->user->display_name} published a new track, {$this->resource->title}!"; case static::TYPE_PUBLISHED_PLAYLIST: return "{$this->resource->user->display_name} published a new playlist, {$this->resource->title}!"; case static::TYPE_NEW_FOLLOWER: return "{$this->initiatingUser->display_name} is now following you!"; case static::TYPE_NEW_COMMENT: if ($this->isProfileComment()) { return "{$this->initiatingUser->display_name} left a comment on your profile!"; // If it's not a profile comment, it must be a content comment. } else { return "{$this->initiatingUser->display_name} left a comment on your {$this->getResourceTypeString()}, \"{$this->resource->resource->title}\"!"; } case static::TYPE_CONTENT_FAVOURITED: return "{$this->initiatingUser->display_name} favourited your {$this->getResourceTypeString()}, \"{$this->resource->title}\"!"; default: throw new \Exception('This activity\'s activity type is unknown!'); } } }