Mediathek: zentrale Bildverwaltung mit Verwendungsnachweis und Bildauswahl
- Tabellen media und media_usages, Modelle Media/MediaUsage - App\Media\MediaLibrary (store/register/replace/delete/rebuild) und Registry App\Media\MediaUsages (Quellen: Seiten, Neuigkeiten inkl. künftiger content-Spalte, Termine, Startseiten-Kacheln), ImagePaths-Extraktor - Alle Uploads landen in der Mediathek (Seiten-Editor direkt, übrige über Beobachter beim Speichern); Daten-Migration und media:rebuild übernehmen bestehende Bilder - Recht media.manage, Zugang media.use für alle Redaktionsbereiche - /redaktion/mediathek (Suche, Filter, Upload mit Fortschritt, Details, Eingebunden in, Ersetzen, Löschen mit Warnung, Mehrfachauswahl), Abschnitt in der Redaktion und Menüpunkt im Admin-Bereich - MediaPicker (Hochladen/Mediathek) im Pagebuilder: Bildfelder und Galerie (Mehrfachauswahl), editor.pickMedia im provide-API - Bild-URLs mit ?v=Änderungszeit, null bei fehlender Datei; Modelle löschen geteilte Bilder nicht mehr selbst Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
3b72b5327e
commit
694ccf6ae0
46 changed files with 3101 additions and 89 deletions
232
app/Http/Controllers/MediaController.php
Normal file
232
app/Http/Controllers/MediaController.php
Normal file
|
|
@ -0,0 +1,232 @@
|
|||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Media\MediaLibrary;
|
||||
use App\Media\MediaUsages;
|
||||
use App\Models\Media;
|
||||
use App\Models\MediaUsage;
|
||||
use App\Models\User;
|
||||
use App\Support\Audit;
|
||||
use Illuminate\Database\Eloquent\Builder;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\Gate;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Illuminate\Validation\Rule;
|
||||
use Illuminate\Validation\Rules\File;
|
||||
use Inertia\Inertia;
|
||||
use Inertia\Response;
|
||||
use Symfony\Component\HttpFoundation\StreamedResponse;
|
||||
|
||||
/**
|
||||
* Mediathek im Portal (Redaktion) und JSON-Schnittstelle der Bildauswahl.
|
||||
* Benutzen und Hochladen: „media.use“, Ersetzen und Löschen: „media.manage“.
|
||||
*/
|
||||
class MediaController extends Controller
|
||||
{
|
||||
public const PER_PAGE = 48;
|
||||
|
||||
public function __construct(private readonly MediaLibrary $library, private readonly MediaUsages $usages) {}
|
||||
|
||||
public function index(Request $request): Response
|
||||
{
|
||||
return Inertia::render('Media/Index', [
|
||||
'filters' => (object) $request->only(['q', 'von', 'zeitraum', 'status', 'in']),
|
||||
'uploaders' => User::query()->whereIn('id', Media::query()->whereNotNull('uploaded_by')->distinct()->select('uploaded_by'))
|
||||
->orderBy('last_name')->orderBy('first_name')->get()->map(fn (User $user) => ['value' => (string) $user->id, 'label' => $user->name])->values(),
|
||||
'sources' => collect($this->usages->labels())->map(fn (string $label, string $type) => ['value' => $type, 'label' => $label])->values(),
|
||||
'canManage' => $request->user()->can('media.manage'),
|
||||
]);
|
||||
}
|
||||
|
||||
public function list(Request $request): JsonResponse
|
||||
{
|
||||
$filters = $request->validate([
|
||||
'q' => ['nullable', 'string', 'max:100'],
|
||||
'von' => ['nullable', 'integer'],
|
||||
'zeitraum' => ['nullable', Rule::in(['7', '30', '365'])],
|
||||
'status' => ['nullable', Rule::in(['unbenutzt', 'verwendet'])],
|
||||
'in' => ['nullable', 'string', 'max:60'],
|
||||
'sortierung' => ['nullable', Rule::in(['neu', 'verwendet', 'name'])],
|
||||
'pfade' => ['nullable', 'array', 'max:500'],
|
||||
'pfade.*' => ['string', 'max:255'],
|
||||
'page' => ['nullable', 'integer', 'min:1'],
|
||||
]);
|
||||
|
||||
$query = Media::query()->with('uploader:id,name')->withCount('usages');
|
||||
$this->applyFilters($query, $filters);
|
||||
|
||||
$page = $query->simplePaginate(self::PER_PAGE);
|
||||
|
||||
return response()->json([
|
||||
'items' => $page->getCollection()->map(fn (Media $media) => $media->toLibraryArray())->values(),
|
||||
'next_page' => $page->hasMorePages() ? $page->currentPage() + 1 : null,
|
||||
'total' => $page->currentPage() === 1 ? $this->countFor($filters) : null,
|
||||
]);
|
||||
}
|
||||
|
||||
public function store(Request $request): JsonResponse
|
||||
{
|
||||
$request->validate(['image' => ['required', File::image()->types(['jpg', 'jpeg', 'png', 'webp', 'gif'])->max(15 * 1024)]]);
|
||||
|
||||
$media = $this->library->store($request->file('image'), MediaLibrary::DIRECTORY, $request->user());
|
||||
$media->load('uploader:id,name')->loadCount('usages');
|
||||
|
||||
return response()->json(['media' => $media->toLibraryArray()], 201);
|
||||
}
|
||||
|
||||
public function show(Media $media): JsonResponse
|
||||
{
|
||||
$media->load('uploader:id,name')->loadCount('usages');
|
||||
$labels = $this->usages->labels();
|
||||
|
||||
return response()->json([
|
||||
'media' => $media->toLibraryArray(),
|
||||
'usages' => $media->usages()->orderBy('draft')->orderBy('source_type')->orderBy('label')->get()->map(fn (MediaUsage $usage) => [
|
||||
'id' => $usage->id,
|
||||
'type' => $usage->source_type,
|
||||
'type_label' => $labels[$usage->source_type] ?? $usage->source_type,
|
||||
'context' => $usage->context,
|
||||
'label' => $usage->label,
|
||||
'url' => $usage->url,
|
||||
'draft' => $usage->draft,
|
||||
])->values(),
|
||||
]);
|
||||
}
|
||||
|
||||
public function update(Request $request, Media $media): JsonResponse
|
||||
{
|
||||
$data = $request->validate([
|
||||
'alt' => ['nullable', 'string', 'max:300'],
|
||||
'caption' => ['nullable', 'string', 'max:500'],
|
||||
'tags' => ['nullable', 'array', 'max:20'],
|
||||
'tags.*' => ['string', 'max:40'],
|
||||
]);
|
||||
|
||||
$tags = isset($data['tags']) ? array_values(array_unique(array_filter(array_map(fn ($tag) => trim((string) $tag), $data['tags'])))) : ($media->tags ?? []);
|
||||
|
||||
$media->forceFill([
|
||||
'alt' => array_key_exists('alt', $data) ? (trim((string) $data['alt']) ?: null) : $media->alt,
|
||||
'caption' => array_key_exists('caption', $data) ? (trim((string) $data['caption']) ?: null) : $media->caption,
|
||||
'tags' => $tags ?: null,
|
||||
]);
|
||||
|
||||
// Nur Metadaten: updated_at nicht anfassen, sonst ändern sich alle Bildadressen („?v=“).
|
||||
Media::withoutTimestamps(fn () => $media->save());
|
||||
|
||||
return response()->json(['media' => $media->loadCount('usages')->load('uploader:id,name')->toLibraryArray()]);
|
||||
}
|
||||
|
||||
public function replace(Request $request, Media $media): JsonResponse
|
||||
{
|
||||
Gate::authorize('media.manage');
|
||||
$request->validate(['image' => ['required', File::image()->types(['jpg', 'jpeg', 'png', 'webp', 'gif'])->max(15 * 1024)]]);
|
||||
|
||||
$this->library->replace($media, $request->file('image'));
|
||||
Audit::log('media.replaced', ['media' => $media->id, 'path' => $media->path]);
|
||||
|
||||
return response()->json(['media' => $media->loadCount('usages')->load('uploader:id,name')->toLibraryArray()]);
|
||||
}
|
||||
|
||||
public function destroy(Media $media): JsonResponse
|
||||
{
|
||||
Gate::authorize('media.manage');
|
||||
|
||||
$usages = $media->usages()->count();
|
||||
$this->library->delete($media);
|
||||
Audit::log('media.deleted', ['media' => $media->id, 'path' => $media->path, 'usages' => $usages]);
|
||||
|
||||
return response()->json(['deleted' => 1]);
|
||||
}
|
||||
|
||||
public function bulkDestroy(Request $request): JsonResponse
|
||||
{
|
||||
Gate::authorize('media.manage');
|
||||
$data = $request->validate([
|
||||
'ids' => ['required', 'array', 'max:500'],
|
||||
'ids.*' => ['integer'],
|
||||
'only_unused' => ['boolean'],
|
||||
]);
|
||||
|
||||
$deleted = 0;
|
||||
|
||||
Media::query()->whereIn('id', $data['ids'])
|
||||
->when($data['only_unused'] ?? false, fn (Builder $q) => $q->doesntHave('usages'))
|
||||
->get()->each(function (Media $media) use (&$deleted) {
|
||||
$this->library->delete($media);
|
||||
$deleted++;
|
||||
});
|
||||
|
||||
Audit::log('media.bulk_deleted', ['count' => $deleted]);
|
||||
|
||||
return response()->json(['deleted' => $deleted]);
|
||||
}
|
||||
|
||||
public function download(Media $media): StreamedResponse
|
||||
{
|
||||
$disk = Storage::disk($media->disk ?: MediaLibrary::DISK);
|
||||
abort_unless($disk->exists($media->path), 404);
|
||||
|
||||
$extension = pathinfo($media->path, PATHINFO_EXTENSION);
|
||||
$name = pathinfo($media->displayName(), PATHINFO_FILENAME) ?: 'bild';
|
||||
|
||||
return $disk->download($media->path, $name.'.'.$extension);
|
||||
}
|
||||
|
||||
public function rebuild(): JsonResponse
|
||||
{
|
||||
Gate::authorize('media.manage');
|
||||
|
||||
$result = $this->library->rebuild();
|
||||
Audit::log('media.rebuilt', $result);
|
||||
|
||||
return response()->json($result);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param Builder<Media> $query
|
||||
* @param array<string, mixed> $filters
|
||||
*/
|
||||
private function applyFilters(Builder $query, array $filters, bool $sort = true): void
|
||||
{
|
||||
if ($term = trim((string) ($filters['q'] ?? ''))) {
|
||||
$like = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], $term).'%';
|
||||
$query->where(fn (Builder $q) => $q
|
||||
->where('original_name', 'like', $like)
|
||||
->orWhere('alt', 'like', $like)
|
||||
->orWhere('caption', 'like', $like)
|
||||
->orWhere('tags', 'like', $like)
|
||||
->orWhere('path', 'like', $like));
|
||||
}
|
||||
|
||||
$query->when($filters['von'] ?? null, fn (Builder $q, $id) => $q->where('uploaded_by', $id))
|
||||
->when($filters['zeitraum'] ?? null, fn (Builder $q, $days) => $q->where('created_at', '>=', now()->subDays((int) $days)))
|
||||
->when(($filters['status'] ?? null) === 'unbenutzt', fn (Builder $q) => $q->doesntHave('usages'))
|
||||
->when(($filters['status'] ?? null) === 'verwendet', fn (Builder $q) => $q->has('usages'))
|
||||
->when($filters['in'] ?? null, fn (Builder $q, $type) => $q->whereHas('usages', fn (Builder $u) => $u->where('source_type', $type)))
|
||||
->when(array_key_exists('pfade', $filters), fn (Builder $q) => $q->whereIn('path', $filters['pfade'] ?: ['']));
|
||||
|
||||
if (! $sort) {
|
||||
return;
|
||||
}
|
||||
|
||||
match ($filters['sortierung'] ?? 'neu') {
|
||||
// Zuletzt verwendet: jüngste Einbindung zuerst (wird bei jedem Speichern der Quelle neu erfasst)
|
||||
'verwendet' => $query->orderByDesc(MediaUsage::query()->selectRaw('MAX(created_at)')->whereColumn('media_usages.media_id', 'media.id'))->orderByDesc('id'),
|
||||
'name' => $query->orderBy('original_name')->orderBy('id'),
|
||||
default => $query->orderByDesc('id'),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $filters
|
||||
*/
|
||||
private function countFor(array $filters): int
|
||||
{
|
||||
$query = Media::query();
|
||||
$this->applyFilters($query, $filters, false);
|
||||
|
||||
return $query->count();
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue