10-04-2026

app/Models/DisplayMedia.php

@@ -0,0 +1,153 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\Storage;
+
+class DisplayMedia extends Model
+{
+    /** @use HasFactory<\Database\Factories\DisplayMediaFactory> */
+    use HasFactory;
+
+    protected $table = 'display_media';
+
+    protected $fillable = [
+        'filename',
+        'disk',
+        'path',
+        'external_url',
+        'source_type',
+        'type',
+        'mime_type',
+        'file_size',
+        'thumbnail_path',
+        'alt_text',
+        'title',
+        'collection',
+        'metadata',
+        'is_active',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'metadata' => 'array',
+            'file_size' => 'integer',
+            'is_active' => 'boolean',
+        ];
+    }
+
+    // ========================================
+    // ACCESSORS
+    // ========================================
+
+    public function getUrl(): string
+    {
+        if ($this->isExternal()) {
+            return $this->external_url;
+        }
+
+        return Storage::disk($this->disk)->url($this->path);
+    }
+
+    public function getThumbnailUrl(): ?string
+    {
+        if ($this->thumbnail_path) {
+            return Storage::disk($this->disk)->url($this->thumbnail_path);
+        }
+
+        if ($this->isUpload() && $this->isImage()) {
+            return $this->getUrl();
+        }
+
+        return null;
+    }
+
+    // ========================================
+    // TYPE CHECKS
+    // ========================================
+
+    public function isUpload(): bool
+    {
+        return $this->source_type === 'upload';
+    }
+
+    public function isExternal(): bool
+    {
+        return $this->source_type === 'external';
+    }
+
+    public function isImage(): bool
+    {
+        return $this->type === 'image';
+    }
+
+    public function isVideo(): bool
+    {
+        return $this->type === 'video';
+    }
+
+    // ========================================
+    // DISPLAY HELPERS
+    // ========================================
+
+    public function getHumanFileSize(): string
+    {
+        if ($this->file_size === 0) {
+            return $this->isExternal() ? 'Extern' : '0 B';
+        }
+
+        $units = ['B', 'KB', 'MB', 'GB'];
+        $size = $this->file_size;
+        $unitIndex = 0;
+
+        while ($size >= 1024 && $unitIndex < count($units) - 1) {
+            $size /= 1024;
+            $unitIndex++;
+        }
+
+        return round($size, 1).' '.$units[$unitIndex];
+    }
+
+    public function getDisplayName(): string
+    {
+        return $this->title ?: $this->filename;
+    }
+
+    // ========================================
+    // SCOPES
+    // ========================================
+
+    public function scopeImages(Builder $query): Builder
+    {
+        return $query->where('type', 'image');
+    }
+
+    public function scopeVideos(Builder $query): Builder
+    {
+        return $query->where('type', 'video');
+    }
+
+    public function scopeUploads(Builder $query): Builder
+    {
+        return $query->where('source_type', 'upload');
+    }
+
+    public function scopeExternals(Builder $query): Builder
+    {
+        return $query->where('source_type', 'external');
+    }
+
+    public function scopeActive(Builder $query): Builder
+    {
+        return $query->where('is_active', true);
+    }
+
+    public function scopeInCollection(Builder $query, string $collection): Builder
+    {
+        return $query->where('collection', $collection);
+    }
+}