downloads = $this->versions->sum('downloads'); $this->saveQuietly(); } /** * The relationship between a mod and its users. */ public function users(): BelongsToMany { return $this->belongsToMany(User::class); } /** * The relationship between a mod and its license. */ public function license(): BelongsTo { return $this->belongsTo(License::class); } /** * The relationship between a mod and its versions. */ public function versions(): HasMany { return $this->hasMany(ModVersion::class) ->whereHas('latestSptVersion') ->orderByDesc('version') ->chaperone(); } /** * The relationship between a mod and its last updated version. */ public function lastUpdatedVersion(): HasOne { return $this->hasOne(ModVersion::class) ->whereHas('latestSptVersion') ->orderByDesc('updated_at') ->chaperone(); } /** * The data that is searchable by Scout. */ public function toSearchableArray(): array { return [ 'id' => $this->id, 'name' => $this->name, 'slug' => $this->slug, 'description' => $this->description, 'thumbnail' => $this->thumbnail, 'featured' => $this->featured, 'created_at' => strtotime($this->created_at), 'updated_at' => strtotime($this->updated_at), 'published_at' => strtotime($this->published_at), 'latestVersion' => $this->latestVersion()?->first()?->latestSptVersion()?->first()?->version_formatted, 'latestVersionColorClass' => $this->latestVersion()?->first()?->latestSptVersion()?->first()?->color_class, ]; } /** * The relationship to the latest mod version, dictated by the mod version number. */ public function latestVersion(): HasOne { return $this->hasOne(ModVersion::class) ->whereHas('sptVersions') ->orderByDesc('version') ->orderByDesc('updated_at') ->take(1) ->chaperone(); } /** * Determine if the model instance should be searchable. */ public function shouldBeSearchable(): bool { // Ensure the mod is not disabled. if ($this->disabled) { return false; } // Ensure the mod has a publish date. if (is_null($this->published_at)) { return false; } // Fetch the latest version instance. $latestVersion = $this->latestVersion()?->first(); // Ensure the mod has a latest version. if (is_null($latestVersion)) { return false; } // Ensure the latest version has a latest SPT version. if ($latestVersion->latestSptVersion()->doesntExist()) { return false; } // Ensure the latest SPT version is within the last three minor versions. $activeSptVersions = Cache::remember('active-spt-versions', 60 * 60, function () { return SptVersion::getVersionsForLastThreeMinors(); }); if (! in_array($latestVersion->latestSptVersion()->first()->version, $activeSptVersions->pluck('version')->toArray())) { return false; } // All conditions are met; the mod should be searchable. return true; } /** * Build the URL to the mod's thumbnail. */ public function thumbnailUrl(): Attribute { return Attribute::get(function (): string { return $this->thumbnail ? Storage::disk($this->thumbnailDisk())->url($this->thumbnail) : ''; }); } /** * Get the disk where the thumbnail is stored based on the current environment. */ protected function thumbnailDisk(): string { return match (config('app.env')) { 'production' => 'r2', // Cloudflare R2 Storage default => 'public', // Local }; } /** * Scope a query by applying QueryFilter filters. */ public function scopeFilter(Builder $builder, QueryFilter $filters): Builder { return $filters->apply($builder); } /** * Build the URL to the mod's detail page. */ public function detailUrl(): string { return route('mod.show', [$this->id, $this->slug]); } /** * The attributes that should be cast to native types. */ protected function casts(): array { return [ 'featured' => 'boolean', 'contains_ai_content' => 'boolean', 'contains_ads' => 'boolean', 'disabled' => 'boolean', ]; } /** * Mutate the slug attribute to always be lower case on get and slugified on set. */ protected function slug(): Attribute { return Attribute::make( get: fn (string $value) => Str::lower($value), set: fn (string $value) => Str::slug($value), ); } }