Files
laraundfelix/app/Domain/Cms/Widgets/Support/ImageRefFields.php
T
LarsandClaude Opus 5.5 053a8d4648
CI Feature / test (push) Successful in 48s
Deploy Test / test (push) Successful in 44s
Deploy Test / deploy (push) Successful in 37s
Stelle alle CMS-Bilder auf die zentrale Medienverwaltung um.
- Einstieg, Bild und Text, redaktionelle Karten, Premium-Karten und Abschnittshintergrund speichern die
  Kennung des Mediums (Bildschlüssel image) und lesen über WebsiteMedia; öffentlich nur mit Website-Freigabe,
  in der Redaktionsvorschau sonst das Vorschaubild mit Hinweis.
- Gemeinsame Felder: Medienpicker mit Vorschaubild und Status, Upload direkt über WebsiteIntake, Anzeige des
  gewählten Mediums mit Verweis auf den Medienmanager. Die CMS-eigene Bildauswahl entfällt.
- Frühere CMS-Bilder übernimmt ein Warteschlangen-Job (dedupliziert, nichts gelöscht); website_media_aliases
  ordnet frühere Pfade zu, wirksam erst nach der ersten Website-Freigabe; /medien/cms/ folgt danach der Freigabe.
- Medienansicht nennt die Website-Seiten, die ein Bild verwenden.
- Bewusst geändert: Der Alternativtext gehört zum Medium und ist im Widget nur noch eine optionale Abweichung;
  die Tests zur Alt-Text-Pflicht prüfen jetzt Übernahme und andere Registry-Fehler.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 22:32:29 +01:00

137 lines
6.0 KiB
PHP

<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Cms\Widgets\WidgetErrors;
use Filament\Forms\Components\Field;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Placeholder;
use Filament\Forms\Components\Select;
use Filament\Notifications\Notification;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Components\Utilities\Set;
use Illuminate\Support\HtmlString;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
/**
* Gemeinsame Bildauswahl aller Widgets und des Abschnittshintergrunds: Bilder aus dem zentralen Medienmanager
* (siehe WebsiteImage, docs/architektur/medienzugriff-fuer-komponenten.md). Keine eigene CMS-Medienverwaltung.
*
* - Auswahl: durchsuchbare Liste mit Vorschaubild, Titel und Website-Status.
* - Neu hochladen: Das Bild wird sofort als Medium im Medienmanager angelegt (WebsiteIntake) und ausgewählt.
* - Anzeige des gewählten Mediums mit Status und Verweis auf die Freigabe im Medienmanager.
*
* Das Bedienmuster folgt der Bildauswahl im Modul- und Programmeditor (Suche, Vorschaubild, Auswählen); jene ist an
* die Livewire-Seite des Editors gebunden und lässt sich nicht als Formularfeld im Widget-Dialog einhängen.
*/
final class ImageRefFields
{
/**
* @param bool $live Änderungen sofort an die Vorschau im Bearbeitungsdialog geben.
* @param string|null $altField Name des Alternativtext-Felds im selben Formular (für neue Medien), falls vorhanden.
* @return list<Field|Placeholder>
*/
public static function fields(string $label = 'Bild', bool $live = false, string $key = 'image', ?string $altField = null): array
{
return [
Select::make($key)
->live()
->label($label.' aus dem Medienmanager')
->searchable()
->allowHtml()
->options(fn (): array => app(WebsiteImage::class)->options())
->getSearchResultsUsing(fn (?string $search): array => app(WebsiteImage::class)->options($search))
->getOptionLabelUsing(fn (mixed $value): ?string => app(WebsiteImage::class)->optionHtml($value))
->placeholder('Kein Bild')
->helperText('Alle Bilder des Medienmanagers. Öffentlich erscheint ein Bild nur mit Website-Freigabe.'),
FileUpload::make('_upload')
->live()
->label($label.': neues Bild hochladen')
->image()
->maxSize(8192)
->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp'])
->storeFiles(false)
->afterStateUpdated(function (mixed $state, Set $set, Get $get) use ($key, $altField): void {
$file = is_array($state) ? (array_values($state)[0] ?? null) : $state;
if (! $file instanceof TemporaryUploadedFile) {
return;
}
$element = app(WebsiteImage::class)->accept($file, $altField !== null ? $get($altField) : null);
$set('_upload', null);
if ($element === null) {
Notification::make()->danger()->title('Das Bild konnte nicht übernommen werden.')->send();
return;
}
$set($key, $element->id);
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.($element->display_title ?: $element->working_title).'“')
->body('Das Bild ist ausgewählt. Nach der Verarbeitung wird es automatisch für die Website freigegeben.')
->send();
})
->helperText('Das Bild wird im Medienmanager angelegt und hier ausgewählt. Nur Bilder mit geklärten Rechten hochladen.'),
Placeholder::make('_media_status')
->label('Gewähltes Bild')
->visible(fn (Get $get): bool => WebsiteImage::normalize($get($key)) !== null)
->content(fn (Get $get): HtmlString => self::statusHtml($get($key))),
];
}
/**
* @return array<string, mixed>
*/
public static function rules(): array
{
return [
'image' => ['nullable'],
'_upload' => ['nullable'],
];
}
/**
* Prüft das gewählte Bild. Ein früherer CMS-Pfad mit wirksamer Zuordnung wird zur Kennung des Mediums.
* Ein noch als Datei übergebener Upload (frühere Formulare) wird über den Medienmanager aufgenommen.
*
* @param array<string, mixed> $refs
* @return array<string, mixed>
*/
public static function clean(array $refs, WidgetErrors $errors, string $key = 'image', ?string $errorKey = null): array
{
$images = app(WebsiteImage::class);
$upload = $refs['_upload'] ?? null;
$upload = is_array($upload) ? (array_values($upload)[0] ?? null) : $upload;
if ($upload instanceof TemporaryUploadedFile) {
$element = $images->accept($upload);
$refs[$key] = $element?->id ?? $refs[$key] ?? null;
}
$refs[$key] = $images->clean($refs[$key] ?? null, $errors, $errorKey ?? "refs.$key");
unset($refs['_upload']);
return $refs;
}
public static function statusHtml(mixed $value): HtmlString
{
$status = app(WebsiteImage::class)->status($value);
if ($status === null) {
return new HtmlString('');
}
$thumb = $status['thumb'] !== null ? '<img src="'.e($status['thumb']).'" alt="">' : '';
$link = $status['manageUrl'] !== null
? '<a href="'.e($status['manageUrl']).'" target="_blank" rel="noopener">Im Medienmanager öffnen</a>'
: '';
return new HtmlString('<div class="luf-media-status luf-media-status-'.e($status['state']).'">'.$thumb
.'<div><strong>'.e($status['title']).'</strong><p>'.e($status['note']).'</p>'.$link.'</div></div>');
}
}