diff --git a/app/Domain/Cms/Catalog/PublicMaterialReader.php b/app/Domain/Cms/Catalog/PublicMaterialReader.php index 46aa0d7..77d0592 100644 --- a/app/Domain/Cms/Catalog/PublicMaterialReader.php +++ b/app/Domain/Cms/Catalog/PublicMaterialReader.php @@ -26,7 +26,7 @@ * erscheint nur, wenn die Redaktion sie ausdrücklich wählt. Nie: Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte, * Ausgabeadressen. Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der * Redaktionsvorschau und kann in der Karte ausdrücklich als Website-Bild übernommen werden (FilmStill). - * Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei. + * Eine Karte spielt höchstens den für die Website freigegebenen Trailer ab (CardClip), bietet keinen Download und gibt kein Medium frei. */ class PublicMaterialReader { diff --git a/app/Domain/Cms/Widgets/Support/CardClip.php b/app/Domain/Cms/Widgets/Support/CardClip.php new file mode 100644 index 0000000..d2abeb2 --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/CardClip.php @@ -0,0 +1,98 @@ +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]; + } +} diff --git a/app/Domain/Cms/Widgets/Types/MediaCardWidget.php b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php index e925edc..525fa21 100644 --- a/app/Domain/Cms/Widgets/Types/MediaCardWidget.php +++ b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php @@ -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; diff --git a/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php index 561eb16..42ff2c4 100644 --- a/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php +++ b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php @@ -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. */ diff --git a/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php b/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php index a269bbc..1ae6faa 100644 --- a/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php +++ b/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php @@ -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; diff --git a/app/Http/Controllers/WebsiteMediaController.php b/app/Http/Controllers/WebsiteMediaController.php index 2cbb199..7d16a4a 100644 --- a/app/Http/Controllers/WebsiteMediaController.php +++ b/app/Http/Controllers/WebsiteMediaController.php @@ -4,12 +4,15 @@ use App\Domain\Catalog\ContentElement; use App\Domain\Media\WebsiteMedia; +use Illuminate\Http\Request; use Illuminate\Support\Facades\Storage; use Symfony\Component\HttpFoundation\StreamedResponse; class WebsiteMediaController extends Controller { - public function show(ContentElement $element, WebsiteMedia $media): StreamedResponse + private const CHUNK = 262144; + + public function show(Request $request, ContentElement $element, WebsiteMedia $media): StreamedResponse { $presentation = $media->present($element); abort_if($presentation === null, 404); @@ -17,9 +20,81 @@ public function show(ContentElement $element, WebsiteMedia $media): StreamedResp $path = $element->website_public_path; abort_if(! is_string($path), 404); - return Storage::disk('media_public')->response($path, null, [ + $headers = [ 'Content-Disposition' => 'inline', 'X-Content-Type-Options' => 'nosniff', + 'Accept-Ranges' => 'bytes', + ]; + + $range = $request->header('Range'); + + // Filme und Hörstücke brauchen Bereichsabrufe (Safari und iOS spielen sonst nicht ab, Springen ist sonst unmöglich). + if (! is_string($range) || $presentation->kind === 'bild') { + return Storage::disk('media_public')->response($path, null, $headers); + } + + $disk = Storage::disk('media_public'); + $size = (int) $disk->size($path); + $bounds = $this->bounds($range, $size); + + if ($bounds === null) { + return response()->stream(fn () => null, 416, $headers + ['Content-Range' => 'bytes */'.$size]); + } + + [$start, $end] = $bounds; + $length = $end - $start + 1; + $stream = $disk->readStream($path); + abort_if(! is_resource($stream), 404); + + return response()->stream(function () use ($stream, $start, $length): void { + fseek($stream, $start); + $left = $length; + + while ($left > 0 && ! feof($stream)) { + $chunk = fread($stream, min(self::CHUNK, $left)); + + if ($chunk === false || $chunk === '') { + break; + } + + echo $chunk; + $left -= strlen($chunk); + } + + fclose($stream); + }, 206, $headers + [ + 'Content-Type' => (string) ($disk->mimeType($path) ?: 'application/octet-stream'), + 'Content-Length' => (string) $length, + 'Content-Range' => 'bytes '.$start.'-'.$end.'/'.$size, ]); } + + /** + * Erster Bereich aus „bytes=a-b“, „bytes=a-“ oder „bytes=-n“; null, wenn er nicht erfüllbar ist. + * + * @return array{0: int, 1: int}|null + */ + private function bounds(string $header, int $size): ?array + { + if ($size < 1 || preg_match('/^bytes=(\d*)-(\d*)(?:,.*)?$/', trim($header), $match) !== 1) { + return null; + } + + [, $from, $to] = $match; + + if ($from === '' && $to === '') { + return null; + } + + if ($from === '') { + $suffix = min((int) $to, $size); + + return $suffix < 1 ? null : [$size - $suffix, $size - 1]; + } + + $start = (int) $from; + $end = $to === '' ? $size - 1 : min((int) $to, $size - 1); + + return $start > $end || $start >= $size ? null : [$start, $end]; + } } diff --git a/docs/architektur/12_Entscheidungsprotokoll_ADR.md b/docs/architektur/12_Entscheidungsprotokoll_ADR.md index dc1388b..8e287be 100644 --- a/docs/architektur/12_Entscheidungsprotokoll_ADR.md +++ b/docs/architektur/12_Entscheidungsprotokoll_ADR.md @@ -63,6 +63,7 @@ ## Übersicht der Architekturentscheidungen | ADR-40 | Zentrale Medienverwaltung im CMS | Umgesetzt auf Test (19.11.2026); Abnahme offen | CMS-Bilder sind Medien des Medienmanagers (Kennung statt Pfad), öffentlich nur mit Website-Freigabe; frühere CMS-Bilder übernommen | | ADR-41 | Gemeinsame Redaktionsbasis | Auf Test (19.11.2026, `develop` `f29ea58`); Betreiberabnahme offen. Technische Abbildung ist eine Arbeitsannahme, keine neue fachliche Freigabe | Klasse-A-Texte, Fachdimensionen und Präsentationsreferenzen an den bestehenden Fachobjekten; keine zweite Inhalts- oder Produktverwaltung | | ADR-42 | Angebot und Warenkorb | Fachlich beschlossen | Gemeinsame Angebotsseite mit Lizenzwahl, Mehrangebotswarenkorb und Geltung der Bestellfassung je Position | +| ADR-43 | Trailer auf Karten | Umgesetzt auf Test (21.11.2026); Abnahme offen | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer beim Überfahren oder Antippen; ohne Freigabe nur das Bild | --- @@ -562,3 +563,19 @@ ## ADR-42 – Öffentliche Angebotsdarstellung und Mehrangebotswarenkorb Die bestehende vorbelegte Angebotsmaske bleibt für Etappe 1 maßgeblich. Neue Fassungen werden ausdrücklich aktiviert. Abbrechen verwirft offene Eingaben. Im Warenkorb bleibt eine identisch bereits erworbene Lizenz gekennzeichnet und entfernbar. Sie geht weder in die Kaufsumme noch in die Bestellpositionen ein. Der ursprüngliche Erwerb bleibt der Nachweis. Pro Bestellung gilt höchstens ein Rabattcode. Allgemeine und produktspezifische Geltung sowie ein mehrfach nutzbarer Zertifizierungscode für geprüfte Konten gehören zum Verkaufsumfang. Verkaufskreis ist Deutschland einschließlich Privatkunden, Vereinen und Organisationen. Der Startumfang enthält keine freiwilligen Teilerstattungen und behandelt Bundles bei Rückgabe als Einheit. Zahlungs- und Rechnungsregeln stehen in ADR-14 und ADR-21. + +## ADR-43 – Trailer auf Karten + +**Status am 21.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/karten-trailer`); Abnahme durch den Betreiber offen. +**Kontext.** FACH-46 fordert öffentliche Teaservideos; die Rollen Trailer und Vorschauclip gibt es im Medienmanager, ein freigegebener Clip wird über `website.media` ausgeliefert. Auf einer Karte war bisher nur ein Bild vorgesehen („kein Abspielen“, ADR-39). Die Grenze galt dem vollständigen Film und dem Bibliotheksmaterial, nicht einem für die Website bestimmten Trailer. Ein Trailer ist kein Lizenzelement; er braucht keine Lizenzentscheidung, nur die Website-Freigabe nach ADR-40. +**Entscheidung.** +- **Welche Karten:** Medien- und Materialkarte, Programm- und Modulkarte. Die Themenkarte hat keinen Trailer. +- **Welcher Clip:** der Trailer des Fachobjekts (Präsentationsrolle „Trailer“), sonst der Vorschauclip. Bei einem Film ersatzweise sein eigener für die Website freigegebener Teaser. Gewählt wird einmal in der Präsentation des Mediums, Programms oder Moduls; alle Karten desselben Objekts zeigen denselben Clip. Je Karte lässt sich der Trailer ausschalten (Darstellung → „Trailer auf der Karte“, Vorgabe: Abspielen). +- **Wann er läuft:** Am Desktop spielt er stumm und in Schleife, solange die Maus auf der Karte steht, und endet beim Verlassen. Am Handy und auf Wunsch auch am Desktop startet und stoppt ihn ein Tipp auf das Bild oder die Schaltfläche „Trailer“ am Bild, die auch die Tastatur bedient (`aria-pressed`). Es spielt nie mehr als ein Clip zugleich; er hält an, wenn die Karte aus dem Bild scrollt oder die Seite verdeckt wird. +- **Rücksicht:** Bei „reduzierte Bewegung“ und im Datensparmodus startet nichts von selbst, nur auf ausdrückliche Bedienung und dann ohne Schleife. Der Clip wird erst beim ersten Start geladen (`preload="none"`, Quelle erst dann gesetzt). Ohne JavaScript bleibt es beim Kartenbild. +- **Rechte:** Es spielt nur ein für die Website freigegebener Clip. Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie über eine Karte, auch nicht in der Redaktionsvorschau; diese nennt stattdessen, dass der Trailer nicht freigegeben ist. Die Karte gibt nichts frei und bietet keinen Download. Die Karte einer Traineranleitung erscheint weiter öffentlich nie. +- **Auslieferung:** Die Route `website.media` beantwortet Bereichsabrufe (`Range`, Antwort 206/416) für Filme und Hörstücke. Safari und iOS spielen sonst nicht ab. +**Alternativen.** Clip je Karte frei wählen (verworfen: mehrere Wege, doppelte Pflege); Autoplay mit Ton oder ohne Bedienung (verworfen: Barrierefreiheit, Datenvolumen); Clip aus dem vollständigen Film erzeugen (verworfen: Rechte, kein freigegebener Clip). +**Folgen.** Neue Einstellung `clip` an der Medien-, Programm- und Modulkarte, Klasse `CardClip`, Skript `resources/js/card-clip.js`; keine Migration. Bereits gespeicherte Karten ohne Wahl spielen einen freigegebenen Trailer ab (Vorgabe Abspielen). Offen: Trailer im Hero-Widget als Hintergrund (nicht entschieden); Hinweis „Mit Ton starten“ nicht vorgesehen. +**Quelle.** `docs/ux/verwaltung/04-fachliche-anforderungen.md` FACH-46; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-39, ADR-40, ADR-41. + diff --git a/docs/architektur/cms-widget-registry.md b/docs/architektur/cms-widget-registry.md index 69d3cd0..291d671 100644 --- a/docs/architektur/cms-widget-registry.md +++ b/docs/architektur/cms-widget-registry.md @@ -312,6 +312,8 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) **Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px). +**Trailer auf der Karte (Medien-, Programm- und Modulkarte).** Einstellung `settings.clip` (`yes` Vorgabe, `no`). Der Clip ist der Trailer des Objekts (Präsentationsrolle „Trailer“, sonst „Vorschauclip“, bei einem Film ersatzweise sein freigegebener Teaser), nur wenn er für die Website freigegeben ist (`CardClip`). Er liegt stumm über dem Kartenbild und startet beim Überfahren mit der Maus, am Handy mit Tippen, per Tastatur über die Schaltfläche am Bild; `resources/js/card-clip.js`. Ohne Freigabe bleibt das Bild; die Redaktionsvorschau nennt den Grund. Entscheidung: ADR-43. + **Text der Karte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`; an der Programm- und Modulkarte zusätzlich `goal`, das Lernziel der Fassung). `auto` entspricht dem bisherigen Verhalten je Karte (Medien: Kurzbeschreibung, sonst Teaser; Programm und Modul: Teaser, sonst Kurzbeschreibung, sonst Lernziel); die Themenkarte hat nur einen Text und keine Wahl. Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang. **Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: eine Stelle mit Regler und Live-Bild wählen („Diese Stelle übernehmen“) oder „Vorschaubild des Films übernehmen“. An der Programm- und Modulkarte entsprechend „Vorschaubild übernehmen“ (`CompositionStill`). `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“. @@ -320,7 +322,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) **Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht. -**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`). +**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen außer eines für die Website freigegebenen Trailers (ADR-43), kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`). **Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):** 1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand. diff --git a/docs/architektur/medienzugriff-fuer-komponenten.md b/docs/architektur/medienzugriff-fuer-komponenten.md index 7ccebad..1d7f251 100644 --- a/docs/architektur/medienzugriff-fuer-komponenten.md +++ b/docs/architektur/medienzugriff-fuer-komponenten.md @@ -182,3 +182,7 @@ ### Vorschaubild eines Programms oder Moduls (Programm- und Modulkarte) Das Vorschaubild eines Programms oder Moduls (Redaktionsmanager) ist ebenfalls ein geschütztes Bibliotheksbild. Im Reiter „Medien“ der Programm- und Modulkarte übernimmt „Vorschaubild übernehmen“ es als Bild-Medium („Titelbild: {Titel}“); `CompositionStill` arbeitet wie `FilmStill`: einmal kopiert (bis zur Größe der Vorschaudatei, 640 px), über `WebsiteIntake` abgelegt, Herkunft in `composition_still_sources` (dasselbe Vorschaubild ergibt dasselbe Medium), ein gescheitertes oder archiviertes Bild wird nicht wiederverwendet, die Meldung nennt den tatsächlichen Stand (auch bei zurückgenommener Freigabe). Ein Programm ohne Vorschaubild zeigt den Hinweis, es im Redaktionsmanager zu setzen. Eine Stelle aus einem Film des Programms zu wählen gibt es hier nicht; das Vorschaubild des Programms selbst lässt sich im Redaktionsmanager aus einem Film setzen. +### Trailer auf Medien-, Programm- und Modulkarten + +Ein Trailer ist ein eigenes Medium (Film ohne Fassung, Ableitung unter `teaser/`), das im Medienmanager einem Medium, Programm oder Modul in der Präsentation mit der Rolle „Trailer“ oder „Vorschauclip“ zugeordnet wird. Die Karte spielt ihn ab, wenn er für die Website freigegeben ist (Reiter „Website“ am Trailer). Lesende Klasse: `CardClip` (Trailer, sonst Vorschauclip, bei einem Film ersatzweise sein eigener freigegebener Teaser). Ausgeliefert wird über `website.media`, die Bereichsabrufe (`Range`) beantwortet. Nicht freigegebene Clips, der vollständige Film und Originale kommen nie über die Karte. Die Redaktionsvorschau spielt ebenfalls nur freigegebene Clips und nennt sonst den Grund. Verhalten (Maus, Tipp, Tastatur, reduzierte Bewegung, Datensparmodus): ADR-43. + diff --git a/resources/css/components/lf-premium-card.css b/resources/css/components/lf-premium-card.css index 9a83ca9..6e88e2f 100644 --- a/resources/css/components/lf-premium-card.css +++ b/resources/css/components/lf-premium-card.css @@ -229,7 +229,7 @@ .lf-pc__panel-accent { color: var(--pc-accent); } -/* Film ohne freigegebenes Bild: Filmtafel (Navy, Filmstreifen-Symbol, kein Abspielsymbol – die Karte spielt nichts ab). */ +/* Film ohne freigegebenes Bild: Filmtafel (Navy, Filmstreifen-Symbol, der Clip, falls freigegeben, liegt über dem Bildbereich). */ .lf-pc__panel-icon { display: block; inline-size: 44px; @@ -340,3 +340,97 @@ @container slot (min-width: 520px) { @media (prefers-reduced-motion: reduce) { .lf-pc__cta { transition: none; } } + +/* + * Trailer (CardClip, resources/js/card-clip.js): Der Clip liegt über dem Bildbereich und blendet erst mit dem ersten + * Bild ein; bis dahin und danach bleibt das Kartenbild stehen. Ohne JavaScript erscheint die Schaltfläche nicht. + * Bei einem Film ohne Kartenbild liegt der Clip über der Filmtafel (lf-pc__visual--panel). + */ +.lf-pc__visual--panel { + display: flex; + align-self: start; +} + +.lf-pc .lf-pc__visual--panel > .lf-pc__panel { + flex: 1 1 auto; + min-inline-size: 0; + margin: 0; +} + +.lf-pc__clip { + position: absolute; + inset: 0; + inline-size: 100%; + block-size: 100%; + object-fit: cover; + object-position: var(--pc-focus-x, 66%) var(--pc-focus-y, 45%); + border-radius: var(--radius-card); + background: var(--lf-navy); + opacity: 0; + pointer-events: none; + transition: opacity 0.2s ease; +} + +.lf-pc--contain .lf-pc__clip { + object-fit: contain; +} + +.is-clip-playing > .lf-pc__clip { + opacity: 1; +} + +.lf-pc__clip-toggle { + position: absolute; + inset: auto auto 12px 12px; + display: none; + align-items: center; + gap: 6px; + min-block-size: 44px; + padding: 8px 14px 8px 10px; + border: 0; + border-radius: var(--radius-pill); + color: var(--lf-white); + background: rgb(3 37 81 / 86%); + font: 600 0.8125rem/1.2 var(--font-reading); + cursor: pointer; +} + +.is-clip-ready > .lf-pc__clip-toggle { + display: inline-flex; +} + +.lf-pc__clip-toggle:hover { + background: var(--lf-navy-deep, var(--lf-navy)); +} + +.lf-pc__clip-toggle:focus-visible { + outline: 3px solid var(--color-focus); + outline-offset: 3px; +} + +.lf-pc__clip-icon { + inline-size: 20px; + block-size: 20px; +} + +.lf-pc__clip-pause, +.lf-pc__clip-toggle[aria-pressed="true"] .lf-pc__clip-play { + display: none; +} + +.lf-pc__clip-toggle[aria-pressed="true"] .lf-pc__clip-pause { + display: inline; +} + +.is-clip-playing > .lf-pc__badge { + opacity: 0.85; +} + +@media (prefers-reduced-motion: reduce) { + .lf-pc__clip { transition: none; } +} + +/* Auf der Filmtafel steht der gelbe Akzent links unten; die Schaltfläche rückt nach rechts. */ +.lf-pc__visual--panel > .lf-pc__clip-toggle { + inset: auto 12px 12px auto; +} diff --git a/resources/js/app.js b/resources/js/app.js index 3bc512a..25a2608 100644 --- a/resources/js/app.js +++ b/resources/js/app.js @@ -1,5 +1,6 @@ import Hls from 'hls.js'; import './site-nav.js'; +import './card-clip.js'; function attachPlayback(video) { if (!(video instanceof HTMLVideoElement) || video.dataset.playbackReady === '1') { diff --git a/resources/js/card-clip.js b/resources/js/card-clip.js new file mode 100644 index 0000000..2303560 --- /dev/null +++ b/resources/js/card-clip.js @@ -0,0 +1,180 @@ +/* + * Trailer auf Premium-Karten (Medien-, Programm- und Modulkarte). + * + * Eine Karte mit [data-card-clip] trägt einen für die Website freigegebenen Clip (data-clip-src). Der Clip + * - startet beim Überfahren mit der Maus und endet beim Verlassen (nur Zeigergeräte mit Maus), + * - startet am Handy und auf Wunsch auch am Desktop mit der Schaltfläche oder einem Tipp auf das Bild und endet mit dem nächsten, + * - läuft stumm; solange er nicht spielt, bleibt das Kartenbild sichtbar (der Clip blendet erst mit dem ersten Bild ein), + * - spielt bei „reduzierte Bewegung“ und im Datensparmodus nie von selbst, sondern nur auf ausdrückliche Bedienung, dann ohne Schleife, + * - wird erst beim ersten Start geladen (preload="none", Quelle erst dann gesetzt), + * - hält an, sobald die Karte aus dem Bild scrollt, und es spielt immer nur ein Clip zugleich. + * Ohne JavaScript bleibt es beim Kartenbild; die Schaltfläche erscheint erst, wenn dieses Skript sie freigibt. + */ +const REDUCED = window.matchMedia ? window.matchMedia('(prefers-reduced-motion: reduce)') : { matches: false }; + +let active = null; + +function saveData() { + return Boolean(navigator.connection && navigator.connection.saveData); +} + +function setup(card) { + if (card.dataset.clipReady === '1') { + return; + } + + const video = card.querySelector('video.lf-pc__clip'); + const toggle = card.querySelector('[data-clip-toggle]'); + const source = card.dataset.clipSrc; + + if (!(video instanceof HTMLVideoElement) || !toggle || !source) { + return; + } + + card.dataset.clipReady = '1'; + + const title = card.dataset.clipTitle || ''; + const host = card.closest('.lf-pc') || card; + let mode = 'off'; // off | hover | manual + let failed = false; + + function label(playing) { + toggle.setAttribute('aria-pressed', playing ? 'true' : 'false'); + toggle.setAttribute('aria-label', (playing ? 'Trailer anhalten: ' : 'Trailer abspielen: ') + title); + } + + function stop() { + mode = 'off'; + card.classList.remove('is-clip-playing'); + video.pause(); + + try { + video.currentTime = 0; + } catch (error) { + // Noch keine Daten geladen: nichts zurückzusetzen. + } + + label(false); + + if (active === stop) { + active = null; + } + } + + function start(nextMode) { + if (failed) { + return; + } + + if (active && active !== stop) { + active(); + } + + if (!video.getAttribute('src')) { + video.src = source; + } + + video.muted = true; + video.loop = !REDUCED.matches; + mode = nextMode; + active = stop; + label(true); + + const attempt = video.play(); + + if (attempt && typeof attempt.catch === 'function') { + attempt.catch(() => { + if (mode === nextMode) { + stop(); + } + }); + } + } + + video.addEventListener('playing', () => { + if (mode !== 'off') { + card.classList.add('is-clip-playing'); + } + }); + + video.addEventListener('ended', stop); + + video.addEventListener('error', () => { + failed = true; + stop(); + card.classList.add('is-clip-failed'); + toggle.hidden = true; + }); + + toggle.addEventListener('click', (event) => { + event.stopPropagation(); + + if (mode === 'off') { + start('manual'); + } else { + stop(); + } + }); + + // Tipp auf das Bild (Handy): wie die Schaltfläche. + card.addEventListener('click', (event) => { + if (event.target.closest('a, button')) { + return; + } + + if (mode === 'off') { + start('manual'); + } else { + stop(); + } + }); + + host.addEventListener('pointerenter', (event) => { + if (event.pointerType !== 'mouse' || REDUCED.matches || saveData() || mode !== 'off') { + return; + } + + start('hover'); + }); + + host.addEventListener('pointerleave', (event) => { + if (event.pointerType === 'mouse' && mode === 'hover') { + stop(); + } + }); + + if ('IntersectionObserver' in window) { + new IntersectionObserver((entries) => { + entries.forEach((entry) => { + if (!entry.isIntersecting && mode !== 'off') { + stop(); + } + }); + }, { threshold: 0.2 }).observe(card); + } + + label(false); + card.classList.add('is-clip-ready'); +} + +function scan(root) { + if (root instanceof Element) { + if (root.matches('[data-card-clip]')) { + setup(root); + } + + root.querySelectorAll('[data-card-clip]').forEach(setup); + } +} + +scan(document.documentElement); + +new MutationObserver((records) => { + records.forEach((record) => record.addedNodes.forEach(scan)); +}).observe(document.documentElement, { childList: true, subtree: true }); + +document.addEventListener('visibilitychange', () => { + if (document.hidden && active) { + active(); + } +}); diff --git a/resources/views/widgets/partials/card-clip.blade.php b/resources/views/widgets/partials/card-clip.blade.php new file mode 100644 index 0000000..a49f175 --- /dev/null +++ b/resources/views/widgets/partials/card-clip.blade.php @@ -0,0 +1,12 @@ +{{-- + Trailer der Premium-Karte (CardClip): stummer Clip über dem Kartenbild plus Schaltfläche. Das