Spiele den freigegebenen Trailer auf Medien-, Programm- und Modulkarten ab
CI Feature / test (push) Successful in 2m55s
Deploy Test / test (push) Successful in 1m56s
Deploy Test / deploy (push) Successful in 28s

Die Karte spielt den für die Website freigegebenen Trailer (Rolle Trailer, sonst
Vorschauclip, bei einem Film ersatzweise sein Teaser) stumm beim Überfahren mit
der Maus ab, am Handy mit Tippen, per Tastatur über die Schaltfläche. Reduzierte
Bewegung und Datensparmodus starten nichts von selbst; der Clip wird erst beim
ersten Start geladen. Ohne Freigabe bleibt das Kartenbild, die Redaktionsvorschau
nennt den Grund. Neue Einstellung "Trailer auf der Karte" je Karte (ADR-43).

Die Route website.media beantwortet Bereichsabrufe (206/416) für Filme und
Hörstücke, damit Safari und iOS abspielen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-21 22:12:51 +01:00
1 parent fc40aba26c
commit ea4244487f
15 files changed
+954 -9

No files matched your search

@@ -0,0 +1,98 @@
<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\PresentationAssignment;
use App\Domain\Media\WebsiteMedia;
use Illuminate\Database\Eloquent\Model;
/**
* Der kurze Clip, den eine Premium-Karte beim Überfahren oder Antippen abspielt.
*
* Gelesen wird nur, was die Redaktion ohnehin für die Website freigegeben hat (WebsiteMedia, Route website.media):
* 1. der Trailer des Fachobjekts (Präsentationsrolle „Trailer“), sonst der Vorschauclip,
* 2. bei einem Film ersatzweise dessen eigener freigegebener Teaser.
* Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie über die Karte. Die Karte gibt
* nichts frei; ohne freigegebenen Clip bleibt es beim Kartenbild.
*
* In der Redaktionsvorschau erklärt `notice`, warum kein Clip läuft (zugeordnet, aber nicht freigegeben).
*/
class CardClip
{
/** Rollen in der Reihenfolge, in der ein Clip gesucht wird. */
public const ROLES = ['trailer', 'vorschauclip'];
public function __construct(private readonly WebsiteMedia $media) {}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
public function for(Model $subject, bool $preview): array
{
$assigned = PresentationAssignment::query()
->with(['role', 'element'])
->where('subject_type', $subject->getMorphClass())
->where('subject_id', $subject->getKey())
->whereHas('role', fn ($query) => $query->whereIn('slug', self::ROLES))
->orderBy('position')
->orderBy('id')
->get()
->sortBy(fn (PresentationAssignment $row): int => (int) array_search($row->role?->slug, self::ROLES, true))
->values();
$unreleased = null;
foreach ($assigned as $assignment) {
$element = $assignment->element;
if (! $element instanceof ContentElement || $element->archived_at !== null || $element->output_class !== 'film') {
continue;
}
$present = $this->media->present($element);
if ($present !== null && $present->kind === 'film') {
return $this->found($present->url, $present->title, $assignment->role?->slug === 'trailer' ? 'trailer' : 'vorschauclip');
}
$unreleased ??= $element;
}
if ($subject instanceof ContentElement && $subject->output_class === 'film') {
$own = $this->media->present($subject);
if ($own !== null && $own->kind === 'film') {
return $this->found($own->url, $own->title, 'teaser');
}
}
if (! $preview) {
return $this->none();
}
if ($unreleased instanceof ContentElement) {
$title = (string) ($unreleased->display_title ?: $unreleased->working_title);
return $this->none('Der Trailer „'.$title.'“ ist nicht für die Website freigegeben; öffentlich bleibt es beim Kartenbild (Medium öffnen → Reiter „Website“ → freigeben).');
}
return $this->none(null, 'Kein Trailer zugeordnet; die Karte zeigt nur das Bild (Rolle „Trailer“ in der Präsentation des Mediums).');
}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
private function found(string $url, string $title, string $source): array
{
return ['url' => $url, 'title' => $title, 'source' => $source, 'notice' => null, 'hint' => null];
}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
private function none(?string $notice = null, ?string $hint = null): array
{
return ['url' => null, 'title' => '', 'source' => 'none', 'notice' => $notice, 'hint' => $hint];
}
}
@@ -11,12 +11,13 @@
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement mit Anzeigetitel, Kurzbeschreibung, Inhaltsart und
* Ausgabeart. Filme erscheinen als Medienkarte (grüne Aktion, Filmtafel ohne freigegebenes Bild), Dokumente und andere
* Materialien als Materialkarte (Materialsymbol). Öffentlich nur nach den Regeln von PublicMaterialReader; die Aktion
* führt auf die öffentliche Programmseite. Die Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
* führt auf die öffentliche Programmseite. Die Karte spielt höchstens den für die Website freigegebenen Trailer ab (CardClip), bietet keinen Download und gibt kein Medium frei.
*/
class MediaCardWidget extends PremiumCardWidget
{
@@ -32,7 +33,7 @@ public function label(): string
public function description(): string
{
return 'Karte zu einem Film oder Material aus der Bibliothek; Titel und Art kommen aus den Fachdaten, kein Abspielen, kein Download.';
return 'Karte zu einem Film oder Material aus der Bibliothek; Titel und Art kommen aus den Fachdaten, Trailer nur wenn freigegeben, kein Download.';
}
public function icon(): string
@@ -145,6 +146,18 @@ protected function textChoices(): array
];
}
protected function supportsClip(): bool
{
return true;
}
protected function clipSubject(mixed $id): ?Model
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
return $element instanceof ContentElement ? $element : null;
}
protected function centralCoverId(mixed $id): ?int
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
@@ -4,6 +4,7 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\CardClip;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
@@ -15,6 +16,7 @@
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;
/**
@@ -67,6 +69,15 @@ protected function imageSourceFields(): array
return [];
}
/**
* Fachobjekt, dessen Trailer die Karte beim Überfahren oder Antippen abspielt (Medium, Programm, Modul).
* Null: diese Karte hat keinen Clip (Thema). Der Clip kommt aus der Präsentation des Objekts (CardClip).
*/
protected function clipSubject(mixed $id): ?Model
{
return null;
}
/**
* Zentrale Texte des Fachobjekts, aus denen die Redaktion den Kartentext wählen kann: Wert => Bezeichnung.
* Leer: keine Wahl (die Karte nimmt den Text ihrer Vorgabe). Mit Wahl gilt „auto“ als Vorgabe.
@@ -154,7 +165,7 @@ public function settings(): array
{
$choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + [
return ($choices === [] ? [] : ['text_source' => $choices]) + ($this->supportsClip() ? ['clip' => ['yes' => 'Abspielen', 'no' => 'Nicht abspielen']] : []) + [
'format' => ['landscape' => 'Querformat 16:9', 'square' => 'Quadrat 1:1', 'portrait' => 'Hochformat 3:4'],
'fit' => ['cover' => 'Ausschnitt füllt die Fläche', 'contain' => 'Ganzes Bild zeigen (Dokument, Poster)'],
'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'],
@@ -169,6 +180,7 @@ public function settingLabels(): array
{
return [
'text_source' => ['Text der Karte', 'Welche Angabe aus der Redaktion die Karte zeigt. Vorgabe: Automatisch. Der gewählte Text erscheint öffentlich, wenn die Karte öffentlich ist; ist er nicht gepflegt, bleibt die Karte ohne Text.'],
'clip' => ['Trailer auf der Karte', 'Spielt den freigegebenen Trailer stumm ab, solange die Maus auf der Karte steht; am Handy mit Tippen auf das Bild, per Tastatur über die Schaltfläche am Bild. Gewählt wird der Trailer (sonst der Vorschauclip) in der Präsentation des Objekts, bei einem Film ersatzweise sein freigegebener Teaser. Ohne freigegebenen Clip bleibt das Kartenbild. Vorgabe: Abspielen.'],
'format' => ['Bildformat', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'],
'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'],
'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'],
@@ -309,8 +321,16 @@ public function resolve(array $widget, RenderContext $context): array
$storedImage = WebsiteImage::normalize($widget['refs']['image'] ?? null);
$imageRef = $storedImage ?? $this->centralCoverId($widget['refs'][$this->refKey()] ?? null);
$clip = null;
if ($this->supportsClip() && $option('clip', 'yes') === 'yes' && $subject instanceof CardSubject) {
$owner = $this->clipSubject($widget['refs'][$this->refKey()] ?? null);
$clip = $owner instanceof Model ? app(CardClip::class)->for($owner, $context->preview) : null;
}
return [
'subject' => $subject,
'clip' => $clip,
'cardStyle' => $subject?->style ?? $this->cardStyle(),
'imageUrl' => app(WebsiteImage::class)->url($imageRef, $context->preview),
'alt' => app(WebsiteImage::class)->alt($imageRef, $data['alt'] ?? null),
@@ -350,6 +370,11 @@ protected function centralCoverId(mixed $id): ?int
return null;
}
protected function supportsClip(): bool
{
return false;
}
/**
* Zentraler Anzeigename oder Teaser des gewählten Objekts (Redaktionsstand) für Platzhalter im Editor.
*/
@@ -11,6 +11,7 @@
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
/**
* Modul- und Programmkarte (Kit v1.7 „catalog“): ein Programm oder Modul über PublicCatalogReader, dieselbe
@@ -156,6 +157,18 @@ protected function cardStyle(): string
return 'catalog';
}
protected function supportsClip(): bool
{
return true;
}
protected function clipSubject(mixed $id): ?Model
{
$composition = is_numeric($id) ? Composition::query()->find((int) $id) : null;
return $composition instanceof Composition ? $composition : null;
}
protected function centralCoverId(mixed $id): ?int
{
$composition = is_numeric($id) ? Composition::query()->find((int) $id) : null;