*/ protected $fillable = [ 'label', 'subtitle', 'slug', 'description', 'picture', 'picture_alt', 'picture_title', 'range_id', 'published', 'order', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'published' => 'boolean', ]; /** * Perform any actions required after the model boots. * * @return void */ protected static function booted(): void { static::creating(function (self $model) { self::assertLabelIsUnique($model->label); self::setOrder($model); self::manageFields($model); }); static::created(function () { self::resetCache(); }); static::updating(function (self $model) { self::assertLabelIsUnique($model->label, $model->getKey()); self::manageFields($model); }); static::updated(function (self $model) { FileStorageHelper::removeOldFile($model, 'picture'); self::resetCache(); }); static::deleted(function (self $model) { FileStorageHelper::removeFile($model, 'picture'); self::resetCache(); }); } // * METHODS /** * Manage model fields. * * @param self $model * @return void */ private static function manageFields(self $model): void { $model->slug = Str::slug($model->label); $model->picture = FileStorageHelper::storeFile($model, $model->picture, true); } /** * Asserts using validation that the label is unique * * @param string|null $label * @param integer|null $id * @return void * @throws \Illuminate\Validation\ValidationException If a tange label already exists. */ private static function assertLabelIsUnique(string|null $label, ?int $id = null): void { $table = (new self())->getTable(); ToolboxHelper::assertFieldIsUnique($table, 'label', $label, $id); ToolboxHelper::assertFieldIsUnique($table, 'slug', Str::slug($label), $id); } /** * Set order after the last element of the list. * * @param self $model * @return void */ private static function setOrder(self $model): void { $model->order = \intval(self::query()->max('order')) + 1; } /** * Reset all cache elements related to this model. * * @return void */ private static function resetCache(): void { Cache::forget('publishedSubrangesOrderedByOrder'); self::getPublishedOrdered(); } /** * Get all published Subranges ordered by order. * * @return \Illuminate\Database\Eloquent\Collection */ public static function getPublishedOrdered(): \Illuminate\Database\Eloquent\Collection { return Cache::remember('publishedSubrangesOrderedByOrder', 86400, function () { return self::query()->where('published', true)->orderBy('order')->get(); }); } /** * Create a SchemaOrg. * * @return \Spatie\SchemaOrg\DefinedTerm */ public function toSchemaOrg(): \Spatie\SchemaOrg\DefinedTerm { return Schema::definedTerm() ->name($this->label) ->description(strip_tags($this->description)) ->image( Schema::imageObject() ->url(asset($this->picture)) ->headline($this->picture_title) ) ->inDefinedTermSet($this->range->toSchemaOrg()); } // * RELATIONSHIPS /** * Get all of the products for the subrange. * * @return \Illuminate\Database\Eloquent\Relations\HasMany */ public function products(): \Illuminate\Database\Eloquent\Relations\HasMany { return $this->hasMany(Product::class, 'productable'); } /** * Get the range that owns the subrange. * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo */ public function range(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Range::class); } }