diff --git a/app/Domain/Cms/Catalog/PublicMaterialReader.php b/app/Domain/Cms/Catalog/PublicMaterialReader.php index 1734fca..5d3c9c1 100644 --- a/app/Domain/Cms/Catalog/PublicMaterialReader.php +++ b/app/Domain/Cms/Catalog/PublicMaterialReader.php @@ -15,8 +15,11 @@ * der gezeigten Fassung eines öffentlichen Programms (Programmseite /programme/{id}). Genau dann erscheint auch die * Karte öffentlich, mit Verweis auf diese Programmseite. Sonst ist die Karte nur in der Redaktionsvorschau sichtbar. * - * Gelesen werden nur Anzeigetitel, Kurzbeschreibung, Inhaltsart und Ausgabeart, nie Dateien, Lehrtexte, + * Gelesen werden nur Anzeigetitel, Inhaltsart und Ausgabeart, nie Kurzbeschreibung, Dateien, Lehrtexte, * Vorschaubilder der Bibliothek oder Ausgabeadressen. Eine Karte gibt kein Medium frei. + * + * Die Kurzbeschreibung eines Elements ist heute nirgends öffentlich (die Programmseite nennt nur den Titel). Sie bleibt + * deshalb auch auf der Karte aus, bis über öffentliche Profile (ADR-29) entschieden ist (offene Entscheidung, ADR-39). */ class PublicMaterialReader { @@ -105,7 +108,7 @@ public function subject(mixed $id, bool $includeNonPublic): ?CardSubject return new CardSubject( title: $this->title($element), - summary: filled($element->summary) ? (string) $element->summary : null, + summary: null, kind: filled($editorialKind) ? (string) $editorialKind : $output, badge: $output, meta: array_values(array_filter([ diff --git a/app/Domain/Cms/Widgets/Types/MediaCardWidget.php b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php index 43f7dc5..a555a13 100644 --- a/app/Domain/Cms/Widgets/Types/MediaCardWidget.php +++ b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php @@ -40,6 +40,15 @@ public function schematic(): array return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'image'], [7, 7, 8, 3, 'accent'], [31, 8, 22, 4, 'ink'], [31, 15, 22, 5, 'line'], [31, 25, 14, 5, 'accent']]; } + public function settings(): array + { + // Ohne Kurzbeschreibung (nicht öffentlich, siehe PublicMaterialReader) gibt es nichts ein- oder auszublenden. + $settings = parent::settings(); + unset($settings['show_summary']); + + return $settings; + } + protected function refKey(): string { return 'element'; diff --git a/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php index 05fa130..bcf6b5f 100644 --- a/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php +++ b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php @@ -236,7 +236,7 @@ public function resolve(array $widget, RenderContext $context): array 'fit' => $option('fit', 'cover'), 'headingTag' => $option('heading_level', 'h3'), 'show' => [ - 'summary' => $option('show_summary', 'yes') === 'yes', + 'summary' => ! array_key_exists('show_summary', $this->settings()) || $option('show_summary', 'yes') === 'yes', 'kind' => ! array_key_exists('show_kind', $this->settings()) || $option('show_kind', 'yes') === 'yes', 'meta' => $option('show_meta', 'yes') === 'yes', 'action' => $option('show_action', 'yes') === 'yes', diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php index 1d2887d..d2cb6b3 100644 --- a/app/Providers/AppServiceProvider.php +++ b/app/Providers/AppServiceProvider.php @@ -2,6 +2,7 @@ namespace App\Providers; +use App\Domain\Cms\Catalog\PublicMaterialReader; use App\Domain\Cms\NavigationItem; use App\Domain\Cms\NavigationItemPolicy; use App\Domain\Cms\Page; @@ -23,6 +24,8 @@ class AppServiceProvider extends ServiceProvider public function register(): void { $this->app->bind(FilmTranscoder::class, FfmpegFilmTranscoder::class); + // Je Anfrage einmal den Index der öffentlich genannten Medien bilden, nicht je Karte. + $this->app->scoped(PublicMaterialReader::class); $this->app->singleton(WidgetRegistry::class, fn ($app): WidgetRegistry => new WidgetRegistry( array_map(fn (string $class) => $app->make($class), config('cms.widgets', [])), )); diff --git a/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md b/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md new file mode 100644 index 0000000..d94cb0c --- /dev/null +++ b/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md @@ -0,0 +1,85 @@ +# Premium-Karten v1.7 im CMS – Bericht (18.11.2026) + +Branch `feature/premium-karten`, gearbeitet in einem separaten Worktree. Deploy ausschließlich über `develop` (Testinstanz, Port 3011). **Kein Merge nach `main`.** Entscheidung: ADR-39; Technik: `docs/architektur/cms-widget-registry.md` §13. + +Grundlage: `docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`. Das Kit ist ein **Entwurf zur visuellen Freigabe**. `FREIGABE.md` führt alle drei Varianten als „zur visuellen Freigabe“. Aus der Integration folgt keine Freigabe. + +## 1. Ergebnis + +Redakteure können die drei Kartenarten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Code zu ändern: + +| Widget | Fachobjekt | Öffentlich sichtbar | Aktion | +|---|---|---|---| +| Themenkarte | veröffentlichtes Thema (Säule) | ja | „Thema entdecken“ → `/themen/{slug}` | +| Medien- und Materialkarte | Inhaltselement mit bereitgestellter Fassung | nur als Bestandteil eines öffentlichen Programms, sonst nur in der Redaktionsvorschau | „Im Programm ansehen“ → Programmseite | +| Programm- oder Modulkarte | Programm oder Modul mit Anzeigefreigabe | Programme ja, Module nur in der Redaktionsvorschau | „Programm ansehen“ → `/programme/{id}`; Module ohne Aktion | + +- **Gespeichert** werden nur Kennungen, Bild, Alternativtext, Bildausschnitt, die Beschriftung der Aktion und ein kurzer Hinweis. Titel, Beschreibung, Art und Linkziel liest die Karte bei jeder Darstellung aus den Fachdaten. Eine Änderung am Thema oder Programm erscheint deshalb ohne Seitenbearbeitung. +- **Gestaltung:** + - Variante: Anpassend (ab 520 px Bild neben Text) oder Bild immer oben. + - Höhe: Natürlich oder An die Zeile angleichen. + - Bildformat: 16:9, 1:1 oder 3:4. + - Bilddarstellung: Ausschnitt oder ganzes Bild. + - Bildausschnitt in Prozent. + - Überschriftenebene: H2, H3 oder H4. + - Ein- und Ausblenden von Kurzbeschreibung, Art, Zusatzangaben und Aktion. +- **Raster:** + - Eine Karte je Platz im bestehenden Abschnittsraster; es gibt kein zweites Kartenraster. + - Neu sind die Raster 1 + 1 + 2 und 2 + 1 + 1. Bestehende Raster und Kennungen sind unverändert. +- **Keine Freigabe geschützter Inhalte:** + - keine Vorschaubilder der Bibliothek + - keine Adressen unter `/bereich/` oder `/redaktion/` + - kein Abspielen, kein Download + - kein Preis, keine Kaufaktion + +## 2. Prüfungen + +| Prüfung | Ergebnis | +|---|---| +| Testsuite (`php artisan test`) | 212 grün, davon 8 neu in `CmsPremiumCardsTest` | +| CI Feature-Branch / Deploy Testinstanz | 4846 / 4847 erfolgreich (Code); Folgecommits siehe Git-Verlauf | +| Bestehende Seiten vor und nach dem Deploy | unverändert: 16 Messungen (8 Seiten × 1440/390 px), Lage und Maße aller Abschnitte und Plätze; 12 Textschnappschüsse des Hauptbereichs | +| Lokale Probe des Redaktionsablaufs (Wegwerfdatenbank) | 114 von 114 Prüfungen. Abläufe: Thema veröffentlichen; Entwurfsseite anlegen mit 1 + 1 + 2, 2 + 2, 4/4, 1 + 1 + 1 + 1 und 1 + 3; Karte wieder öffnen und bearbeiten; speichern; Redaktionsvorschau; veröffentlichen. Messung bei 1440, 1024, 768 und 390 px: gleiche Höhe je Zeile, Bild neben Text genau ab 520 px Kartenbreite, keine Karte schmaler als 240 px, kein Überlauf, keine geschützten Adressen. **Gilt nicht als Abnahme auf der Testinstanz.** | +| Redaktionsablauf auf der Testinstanz | **offen.** Das Skript ist fertig, in dieser Sitzung fehlten die Zugangsdaten des Prüfkontos. | + +**Feature-Tests** (`tests/Feature/CmsPremiumCardsTest.php`): +- Fachbezug ohne Kopie: Die Revision enthält nur Kennungen; Namensänderungen erscheinen sofort. +- Rückzug: Wird ein Thema zurückgezogen oder ein Element archiviert, verschwindet die Karte. +- Programmkarten benennen ihre Art, ohne Bild über die Navy-Tafel. Module erscheinen nur in der Vorschau, mit Hinweis. Kein Preis, keine Kaufbegriffe. +- Medienkarten: + - erscheinen öffentlich nur über ein öffentliches Programm, mit Link auf die Programmseite; + - geben keine Bibliotheksvorschau, keine geschützte Adresse, kein Video und keinen Inhalt aus; + - zeigen keine Kurzbeschreibung. +- Abweisung: + - nicht veröffentlichter oder nicht freigegebener Objekte; + - eines Bildes ohne Alternativtext; + - freier Einstellungswerte. +- Gemischte Raster (1 + 1 + 2, 2 + 2): gleiche Höhe, Bildformat, Bildausschnitt, Variante, Optionen, lange Texte ungekürzt. +- Redaktionsablauf über den Editor (Livewire): + - alle drei Karten anlegen; als Entwurf gespeichert; + - wieder öffnen; Dialog mit den Reitern Inhalt, Medien und Darstellung; + - Live-Vorschau; erneut speichern; veröffentlichen. + +## 3. Grenzen und offene Punkte + +1. **Öffentliche Felder der Medienkarte (Entscheidung von Lars).** Heute nennt nur die Programmseite Bestandteile, und zwar nur mit Titel. + - Die Karte zeigt öffentlich den Titel (Anzeigetitel, sonst Arbeitstitel), die Inhalts- und Ausgabeart und die Programmzugehörigkeit. + - Die Kurzbeschreibung bleibt aus. + - Zu prüfen: ob bei Traineranleitungen schon der Titel öffentlich sein darf. +2. **ADR-29 (öffentliche Profile).** Bis dahin sind Module und Medien ohne öffentliches Programm nur in der Redaktionsvorschau sichtbar. Profile ersetzen später die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; gespeicherte Karten bleiben gültig. +3. **Gestalterische Freigabe v1.7** und freigegebene Motive. Auf der Testinstanz stehen nur gekennzeichnete Platzhalterbilder. +4. **Zusatzangaben** gibt es nur, soweit die Fachdaten sie hergeben: Ausgabeart, Programmzugehörigkeit, Modulanzahl. Laufzeit, Altersangabe oder Seitenzahl fehlen in den Fachdaten. +5. **Gleiche Höhe** wird je Karte eingestellt, nicht je Abschnitt. Alle Karten einer Zeile müssen „An die Zeile angleichen“ tragen. +6. **Entfallende Plätze.** Eine öffentlich nicht sichtbare Karte (Modul) lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Hinweis für die Redaktion in §13 der Registry-Dokumentation. +7. **Kaufbare Angebotskarte: offener Bedarf.** Die Karten tragen bewusst keinen Preis und keine Kaufaktion. Eine Angebotskarte braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck, Lizenzbedingungen und Preisquelle aus dem kommerziellen System. Sie ist gesondert zu konzipieren (Zielkonzept: „Angebotskarte … Neu konzipieren“, Lizenzvergleich). +8. **Validierungsmeldungen** sind teils englisch, weil `lang/de` fehlt. Das ist bekannt und unverändert. + +## 4. Abweichungen vom Kit + +- Kein Beispielraster (`.lf-pc-grid`) und keine Spannweitenklassen; das Abschnittsraster ist das einzige Raster. +- Umschaltung bei 520 px über den Platz-Container. +- Keine H1. +- Gelber Akzent als SVG-Komponente. +- Schriftgewicht 600 statt 750, weil nur vorhandene Schnitte verwendet werden. +- Bildhöhe höchstens min(70vh, 640 px). +- Karten, die nur in der Vorschau erscheinen, mit gestricheltem Rand. diff --git a/docs/architektur/12_Entscheidungsprotokoll_ADR.md b/docs/architektur/12_Entscheidungsprotokoll_ADR.md index 88f2845..167ce21 100644 --- a/docs/architektur/12_Entscheidungsprotokoll_ADR.md +++ b/docs/architektur/12_Entscheidungsprotokoll_ADR.md @@ -509,8 +509,9 @@ ## ADR-39 – Premium-Karten mit Fachbezug - Drei Widget-Arten in der bestehenden Registry (`topic_card`, `media_card`, `program_card`) auf einer gemeinsamen Basis (`PremiumCardWidget`) mit einer Ansicht (`widgets/premium_card.blade.php`). Eine Karte je Widget, ein Widget je Platz; Spalten und Abstände bestimmt das Abschnittsraster. Das Beispielraster des Kits wird nicht übernommen. - `refs` speichert genau eine Kennung (Thema `pillar`, Inhaltselement `element`, Komposition `composition`) und optional ein Bild aus dem öffentlichen Website-Bereich. Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel werden bei jeder Darstellung aus den Fachdaten gelesen. Redaktionell sind nur Bild, Alternativtext, Bildausschnitt, Beschriftung der Aktion und ein kurzer Hinweis. - Linkziel nur aus dem Fachobjekt: Themenseite eines veröffentlichten Themas, Programmseite eines öffentlichen Programms. Kein freies Linkziel, kein Download, kein Abspielen, kein Preis, keine Kaufaktion. -- Sichtbarkeit (Übergangsregel bis ADR-29): Themen nur veröffentlicht; Programme nach `PublicCatalogReader`; Module nur in der Redaktionsvorschau; Medien und Materialien öffentlich nur, wenn sie zur gezeigten Fassung eines öffentlichen Programms gehören (dort sind sie heute schon öffentlich genannt), sonst nur in der Redaktionsvorschau (`PublicMaterialReader`). +- Sichtbarkeit (Übergangsregel bis ADR-29): Themen nur veröffentlicht; Programme nach `PublicCatalogReader`; Module nur in der Redaktionsvorschau; Medien und Materialien öffentlich nur, wenn sie zur gezeigten Fassung eines öffentlichen Programms gehören (dort sind sie heute schon öffentlich genannt), sonst nur in der Redaktionsvorschau (`PublicMaterialReader`). Von Medien wird keine Kurzbeschreibung gezeigt. - Gleiche Höhe je Zeile über die gemeinsame Höhe `fill` (ADR-38). Für gemischte Raster sind die Abschnittsraster 1 + 1 + 2 und 2 + 1 + 1 ergänzt (additiv, bestehende Kennungen unverändert). **Alternativen.** Ein Widget mit mehreren Karten und eigenem Spannweitenraster (verworfen: zweites Kartenraster neben dem Abschnittsraster); eine Widget-Art mit Variante je Fachobjekt (verworfen: Verweisschema hinge von der Variante ab); redaktionell gepflegte Kartentexte (verworfen: Kopien von Fachdaten); Vorschaubilder der Bibliothek als Kartenbild (verworfen: geschützt, Paket 6). +**Offene Entscheidung (zuerst).** Welche Felder eines Inhaltselements öffentlich auf einer Karte erscheinen dürfen. Heute nennt nur die Programmseite Bestandteile, und zwar mit Titel. Die Medienkarte zeigt deshalb öffentlich Titel (Anzeigetitel, sonst Arbeitstitel), Inhaltsart, Ausgabeart und Programmzugehörigkeit, aber keine Kurzbeschreibung. Zu prüfen ist besonders bei Traineranleitungen, ob schon der Titel öffentlich sein darf. **Folgen und offene Prüfung.** Keine Migration; bestehende Seiten und Widgets unverändert (gemessen). Mit ADR-29 ersetzen öffentliche Profile die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; die gespeicherten Karten ändern sich dadurch nicht. Offen: gestalterische Freigabe v1.7, freigegebene Motive statt Platzhaltern, eine kaufbare Angebotskarte (eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen, nicht Teil dieser Karten). **Quelle.** Brand-UI-Kit v1.7 (`docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`, README, `docs/design-config.json`); `docs/architektur/cms-widget-registry.md` §§4, 6, 11, 13; ADR-29, ADR-30, ADR-38. diff --git a/docs/architektur/cms-widget-registry.md b/docs/architektur/cms-widget-registry.md index 1f3955c..42eceae 100644 --- a/docs/architektur/cms-widget-registry.md +++ b/docs/architektur/cms-widget-registry.md @@ -292,12 +292,14 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) | Art | Fachobjekt | Gelesen aus | Art/Label | Zusatzangaben | Aktion (Vorgabe) | |---|---|---|---|---|---| | Themenkarte `topic_card` | Thema (`Pillar`) | Name, öffentlicher Text | „Thema“ | – | „Thema entdecken“ → `/themen/{slug}` | -| Medien- und Materialkarte `media_card` | Inhaltselement (`ContentElement`) über `PublicMaterialReader` | Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung | Inhaltsart (zum Beispiel „Merkblatt“), sonst Ausgabeart; Ausgabeart als Marke auf dem Bild | Ausgabeart, „Im Programm …“ | „Im Programm ansehen“ → Programmseite | +| Medien- und Materialkarte `media_card` | Inhaltselement (`ContentElement`) über `PublicMaterialReader` | Anzeigetitel (sonst Arbeitstitel); **keine Kurzbeschreibung** (heute nirgends öffentlich, offene Entscheidung) | Inhaltsart (zum Beispiel „Merkblatt“), sonst Ausgabeart; Ausgabeart als Marke auf dem Bild | Ausgabeart, „Im Programm …“ | „Im Programm ansehen“ → Programmseite | | Programm- oder Modulkarte `program_card` | Komposition über `PublicCatalogReader` | Anzeigetitel, Kurzbeschreibung | „Programm“ oder „Modul“, immer sichtbar; ohne Bild als Navy-Tafel | Anzahl Module der gezeigten Fassung | „Programm ansehen“ → `/programme/{id}`; Module ohne Aktion | **Gespeichert** (Hülle wie jedes Widget): `refs.{pillar|element|composition}` (Kennung), `refs.image` (öffentlicher Bereich `cms/`), `data.action_label`, `data.note`, `data.alt` (Pflicht bei Bild), `data.focus_x/focus_y` (0–100, Vorgabe 66/45). Kein Titel, kein Text, kein Linkziel. -**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. +**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 (nicht bei Medien), Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px), damit breite gestapelte Karten nicht übermäßig hoch werden. + +**Hinweis für die Redaktion.** Eine Karte, die öffentlich nicht erscheint (Modul, Medium ohne öffentliches Programm), lässt ihren Platz entfallen; die übrigen Plätze des Abschnitts teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht. **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. Die Einstellung gilt je Karte, nicht je Abschnitt. diff --git a/resources/css/components/lf-premium-card.css b/resources/css/components/lf-premium-card.css index b39991b..3cc9474 100644 --- a/resources/css/components/lf-premium-card.css +++ b/resources/css/components/lf-premium-card.css @@ -66,6 +66,9 @@ .lf-pc__image { inline-size: 100%; block-size: auto; aspect-ratio: var(--pc-ratio); + /* Breite gestapelte Karten (zum Beispiel 4 Einheiten, Hochformat) würden sonst über 1000 px hoch: Das Bild wird + begrenzt, „Ganzes Bild“ bleibt vollständig (Rand), „Ausschnitt“ folgt dem Bildfokus. Text wird nie begrenzt. */ + max-block-size: min(70vh, 640px); object-fit: cover; object-position: var(--pc-focus-x, 66%) var(--pc-focus-y, 45%); border-radius: var(--radius-card); diff --git a/tests/Feature/CmsPremiumCardsTest.php b/tests/Feature/CmsPremiumCardsTest.php index e0aa2f4..8aee266 100644 --- a/tests/Feature/CmsPremiumCardsTest.php +++ b/tests/Feature/CmsPremiumCardsTest.php @@ -61,6 +61,7 @@ public function test_the_three_card_types_are_registered_with_the_layout_contrac } $this->assertArrayNotHasKey('show_kind', $registry->get('program_card')->settingOptions(), 'Programm oder Modul bleibt immer benannt.'); + $this->assertArrayNotHasKey('show_summary', $registry->get('media_card')->settingOptions(), 'Medienkarten zeigen keine Kurzbeschreibung.'); } public function test_topic_card_shows_a_published_theme_from_the_master_data_only(): void @@ -165,6 +166,7 @@ public function test_media_card_is_public_only_as_part_of_a_public_program_and_n $this->assertStringContainsString('