ldc-agis/app/Models/Range.php

<?php

namespace App\Models;

use App\Enums\Products\CookingModeEnum;
use App\Lib\Helpers\FileStorageHelper;
use App\Lib\Helpers\ToolboxHelper;
use App\Traits\Models\ActivityLog;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;

/**
 * @phpcs:disable Generic.Files.LineLength.TooLong
 *
 * @property string              $seo_title                  Utilisé pour la balise title de la page.
 * @property string              $seo_description            Utilisé pour la balise meta description de la page.
 * @property string              $title                      Balise h1 de la page.
 * @property string              $slug                       Slug à partir de title.
 * @property string              $subtitle                   Sous-titre de la gamme.
 * @property string              $tagline                    Titre d'accroche de la gamme.
 * @property string              $description                WYSIWYG - Description de la gamme.
 * @property string              $picture                    Path de l'image de la gamme (466px * 440px).
 * @property string              $picture_alt                Attribut alt pour l'image picture.
 * @property string              $picture_title              Attribut title pour l'image picture.
 * @property string              $picture_productsheet       Path de l'image à afficher sur les fiches produits de cette gamme (332px * 442px).
 * @property string              $picture_productsheet_alt   Attribut alt de l'image à afficher sur les fiches produits.
 * @property string              $picture_productsheet_title Attribut title de l'image à afficher sur les fiches produits.
 * @property string              $picture_thumbnail          Path de la vignette de la gamme (246px * 337px).
 * @property string              $picture_thumbnail_alt      Attribut alt de la vignette de la gamme.
 * @property string              $picture_thumbnail_title    Attribut title de la vignette de la gamme.
 * @property boolean             $published                  Le produit est-il visible ?
 * @property integer             $order                      Numéro permettant d'ordonner les produits.
 * @property-read \Carbon\Carbon $created_at                 Created date.
 * @property-read \Carbon\Carbon $updated_at                 Updated date.
 *
 * @property-read \App\Models\Products $products Products Has Many relationship.
 * @phpcs:enable
 */
class Range extends Model
{
    use ActivityLog;
    use HasFactory;

    /**
     * The attributes that are mass assignable.
     *
     * @var array<int, string>
     */
    protected $fillable = [
        'seo_title',
        'seo_description',
        'title',
        'slug',
        'subtitle',
        'tagline',
        'description',
        'picture',
        'picture_alt',
        'picture_title',
        'picture_productsheet',
        'picture_productsheet_alt',
        'picture_productsheet_title',
        'picture_thumbnail',
        'picture_thumbnail_alt',
        'picture_thumbnail_title',
        'published',
        'order',
    ];

    /**
     * The attributes that should be cast.
     *
     * @var array<string, string>
     */
    protected $casts = [
        'cooking_mode' => CookingModeEnum::class,
        'published'    => 'bool',
    ];

    /**
     * Perform any actions required after the model boots.
     *
     * @return void
     */
    protected static function booted(): void
    {
        static::creating(function (self $model) {
            self::assertFieldIsUnique('title', $model->title);
            self::setOrder($model);
            self::manageFields($model);
        });
        static::updating(function (self $model) {
            self::manageFields($model);
        });
        static::updated(function (self $model) {
            FileStorageHelper::removeOldFile($model, 'picture');
            FileStorageHelper::removeOldFile($model, 'picture_productsheet');
            FileStorageHelper::removeOldFile($model, 'picture_thumbnail');
        });

        static::deleted(function (self $model) {
            FileStorageHelper::removeFile($model, 'picture');
            FileStorageHelper::removeFile($model, 'picture_productsheet');
            FileStorageHelper::removeFile($model, 'picture_thumbnail');
        });
    }

    // * METHODS

    /**
     * Manage model fields.
     *
     * @param self $model
     * @return void
     */
    private static function manageFields(self $model): void
    {
        self::setSlug($model, $model->title);
        $model->picture              = FileStorageHelper::storeFile($model, $model->picture, true);
        $model->picture_productsheet = FileStorageHelper::storeFile($model, $model->picture_productsheet, true);
        $model->picture_thumbnail    = FileStorageHelper::storeFile($model, $model->picture_thumbnail, true);
    }

    /**
     * Set the slug.
     *
     * @param self   $model
     * @param string $original
     *
     * @return void
     */
    private static function setSlug(self $model, string $original): void
    {
        $model->slug = Str::slug($original);
    }

    /**
     * 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;
    }

    /**
     * Asserts using validation that the field is unique.
     *
     * @param string       $nameField
     * @param string       $valueField
     * @param integer|null $id
     * @return void
     */
    private static function assertFieldIsUnique(string $nameField, string $valueField, ?int $id = null): void
    {
        $table = (new self())->getTable();
        ToolboxHelper::assertFieldIsUnique($table, $nameField, $valueField, $id);
    }

    // * RELATIONS

    /**
     * Get the products in the range.
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function products(): \Illuminate\Database\Eloquent\Relations\HasMany
    {
        return $this->hasMany(Product::class);
    }
}