Author SHA1 Message Date
LarsandClaude Sonnet 5.5 2a54347d50 Belege die gegliederte Darstellung mit Screenshots
Deploy Test / test (push) Successful in 1m51s
Deploy Test / deploy (push) Successful in 32s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:35:18 +01:00
Lars 992171bb7a Merge remote-tracking branch 'origin/develop' into feature/darstellung-gruppiert
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 24s
2026-11-22 10:28:14 +01:00
StommerandClaude Sonnet 5.5 8b59946bb1 Merge branch 'feature/stripe-abnahme-doku' into develop
Deploy Test / test (push) Successful in 1m41s
Deploy Test / deploy (push) Successful in 26s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:26 +01:00
LarsandClaude Sonnet 5.5 061181f30d Gliedere den Reiter Darstellung in Gruppen und erkläre jede Einstellung im (i)
CI Feature / test (push) Successful in 1m46s
Aufbau, Gruppen je Widget (Bild und Video, Texte auf der Karte, Seitenstruktur,
Aussehen), Erklärungen als Tooltip statt Hilfetext, Bezeichnungen vereinheitlicht.
Bei „Texte auf der Karte: Ausblenden“ verschwinden die Einzelschalter; ihre Werte bleiben.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:19 +01:00
StommerandClaude Sonnet 5.5 f54acd55e6 Dokumentiere die Stripe-Sandbox-Abnahme und die Stolpersteine der Einrichtung
CI Feature / test (push) Successful in 1m39s
Bestellung 7 wurde über die Stripe-Kasse im Testmodus bezahlt und per Webhook freigeschaltet.
Betriebsdoku um die erlebten Stolpersteine ergänzt (pk_ statt sk_, Managed Payments, inklusiver
Steuersatz, Neuausrollen, Fehlersuche im Protokoll).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:13 +01:00
LarsandClaude Sonnet 5.5 2ca7a8b268 Biete an Medien- und Programmkarten an, alle Texte auszublenden
CI Feature / test (push) Successful in 2m16s
Deploy Test / test (push) Successful in 1m59s
Deploy Test / deploy (push) Successful in 27s
Neue Einstellung „Texte neben dem Bild“ (Darstellung): Ausblenden zeigt nur Bild oder Video,
ohne Titel, Text, Art, Zusatzangaben, Aktion und Marke im Bild. Der Titel bleibt unsichtbar für
Hilfstechnik, ein Trailer läuft weiter. Die Themenkarte hat die Einstellung nicht. Keine Migration.
Außerdem steht in der Beschreibung der Trailer-Einstellung jetzt der Ton nach Bedienung.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:59:56 +01:00
StommerandClaude Sonnet 5.5 cc890d9fc7 Merge branch 'feature/stripe-idempotenz' into develop
Deploy Test / test (push) Successful in 1m57s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:55:29 +01:00
18 changed files with 407 additions and 33 deletions

No files matched your search

+9 -1
View File
@@ -115,10 +115,18 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Aussehen' => ['accent'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ return [
'heading_level' => ['Überschriftenebene', 'Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'], 'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'],
'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'], 'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'],
]; ];
} }
@@ -117,11 +117,19 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Aussehen' => ['surface'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ return [
'surface' => ['Hintergrund des Widgets', 'Unabhängig vom Abschnittshintergrund. „Ohne eigene Fläche“ übernimmt den Abschnitt.'], 'surface' => ['Hintergrund des Widgets', 'Unabhängig vom Abschnittshintergrund. „Ohne eigene Fläche“ übernimmt den Abschnitt.'],
'heading_level' => ['Überschriftenebene', 'Steht das Widget als erstes auf der Seite, ist die Überschrift immer H1.'], 'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Steht das Widget als erstes auf der Seite, ist die Überschrift immer H1.'],
]; ];
} }
@@ -165,7 +165,7 @@ public function settings(): array
{ {
$choices = $this->textChoices(); $choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + ($this->supportsClip() ? ['clip' => ['yes' => 'Abspielen', 'no' => 'Nicht abspielen']] : []) + [ return ($choices === [] ? [] : ['text_source' => $choices]) + ($this->supportsClip() ? ['clip' => ['yes' => 'Abspielen', 'no' => 'Nicht abspielen'], 'show_body' => self::SHOW] : []) + [
'format' => ['landscape' => 'Querformat 16:9', 'square' => 'Quadrat 1:1', 'portrait' => 'Hochformat 3:4'], '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)'], 'fit' => ['cover' => 'Ausschnitt füllt die Fläche', 'contain' => 'Ganzes Bild zeigen (Dokument, Poster)'],
'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'], 'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'],
@@ -176,18 +176,34 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Bild und Video' => ['format', 'fit', 'clip'],
'Texte auf der Karte' => ['show_body', 'text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingHiddenWhen(): array
{
// „Texte auf der Karte: Ausblenden“ macht die Einzelschalter wirkungslos; sie bleiben gespeichert, aber unsichtbar.
return array_fill_keys(['text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'], ['show_body', 'no']);
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ 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.'], 'format' => ['Bildformat', 'Seitenverhältnis des Bildes oder Videos. Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'],
'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.'], 'fit' => ['Bildausschnitt', 'Ausschnitt füllt die ganze Fläche; „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche. Vorgabe: Ausschnitt.'],
'format' => ['Bildformat', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'], 'clip' => ['Trailer auf der Karte', 'Spielt den freigegebenen Trailer als stumme Vorschau, solange die Maus auf der Karte steht; ein Klick oder Tipp auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton. 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.'],
'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'], 'show_body' => ['Texte auf der Karte', 'Hauptschalter für alle Texte neben dem Bild. „Ausblenden“ zeigt nur Bild und Video, ohne Titel, Beschreibung, Art, Zusatzangaben und Schaltfläche; die Einzelschalter darunter verschwinden dann. Für Hilfstechnik bleibt der Titel unsichtbar erhalten. Sinnvoll, wenn das Video allein erklärt. Vorgabe: Anzeigen.'],
'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'], 'text_source' => ['Quelle der Beschreibung', 'Welche Angabe aus der Redaktion als Beschreibung erscheint. Vorgabe: Automatisch. Der Text erscheint öffentlich, wenn die Karte öffentlich ist; ist er nicht gepflegt, bleibt die Karte ohne Beschreibung.'],
'show_summary' => ['Text anzeigen', 'Aus den Fachdaten. Vorgabe: anzeigen.'], 'show_summary' => ['Beschreibung', 'Der Beschreibungstext unter dem Titel, aus den Fachdaten. Vorgabe: Anzeigen.'],
'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'], 'show_kind' => ['Art-Label', 'Kleines Label über dem Titel, zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: Anzeigen.'],
'show_meta' => ['Zusatzangaben', 'Aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: anzeigen.'], 'show_meta' => ['Zusatzangaben', 'Angaben aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: Anzeigen.'],
'show_action' => ['Aktion', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: anzeigen.'], 'show_action' => ['Schaltfläche', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: Anzeigen.'],
'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'],
]; ];
} }
@@ -348,6 +364,7 @@ public function resolve(array $widget, RenderContext $context): array
'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(), 'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(),
'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null, 'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null,
'stacked' => $widget['variant'] === 'stacked', 'stacked' => $widget['variant'] === 'stacked',
'bare' => $this->supportsClip() && $option('show_body', 'yes') === 'no',
]; ];
} }
+23
View File
@@ -194,6 +194,29 @@ public function settingLabels(): array
return []; return [];
} }
/**
* Gliederung der Einstellungen im Reiter „Darstellung“: Gruppentitel => Schlüssel der Einstellungen in der
* Reihenfolge der Anzeige. Variante und Höhe stehen immer in der ersten Gruppe „Aufbau“. Einstellungen ohne
* Gruppe erscheinen unter „Weitere Einstellungen“, so geht keine verloren.
*
* @return array<string, list<string>>
*/
public function settingGroups(): array
{
return [];
}
/**
* Einstellungen, die im Editor ausgeblendet werden, solange eine andere Einstellung einen bestimmten Wert hat:
* Schlüssel => [steuernde Einstellung, Wert, bei dem ausgeblendet wird]. Die Werte bleiben dabei erhalten.
*
* @return array<string, array{0: string, 1: string}>
*/
public function settingHiddenWhen(): array
{
return [];
}
/** /**
* Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung * Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung
* verwenden ausschließlich diese Zusammenführung. * verwenden ausschließlich diese Zusammenführung.
+60 -12
View File
@@ -16,6 +16,7 @@
use Filament\Forms\Components\ToggleButtons; use Filament\Forms\Components\ToggleButtons;
use Filament\Notifications\Notification; use Filament\Notifications\Notification;
use Filament\Schemas\Components\Grid; use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Section; use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Tabs; use Filament\Schemas\Components\Tabs;
use Filament\Schemas\Components\Tabs\Tab; use Filament\Schemas\Components\Tabs\Tab;
@@ -120,45 +121,92 @@ public static function slotBuilder(string $name = 'widget'): Builder
->columnSpanFull(); ->columnSpanFull();
} }
/**
* Erklärung als kleines (i) neben der Bezeichnung: erscheint beim Überfahren und beim Fokussieren.
*/
private static function withInfo(ToggleButtons|Select $component, ?string $help): ToggleButtons|Select
{
return filled($help)
? $component->hintIcon('heroicon-m-information-circle', tooltip: $help)->hintColor('gray')
: $component;
}
public static function block(WidgetType $type): Block public static function block(WidgetType $type): Block
{ {
$icons = $type->optionIcons(); $icons = $type->optionIcons();
$display = []; $display = [];
// Aufbau: Anordnung (Variante) und gemeinsame Höhe. Erklärungen stehen im (i) neben der Bezeichnung.
$layout = [];
if (count($type->variants()) > 1) { if (count($type->variants()) > 1) {
$display[] = ToggleButtons::make('variant') $layout[] = self::withInfo(ToggleButtons::make('variant')
->label('Darstellung') ->label('Anordnung')
->options($type->variants()) ->options($type->variants())
->icons($icons['variant'] ?? []) ->icons($icons['variant'] ?? [])
->default($type->defaultVariant()) ->default($type->defaultVariant())
->inline() ->inline()
->required() ->required()
->live(); ->live(), 'Wie Bild und Text zueinander stehen. Bei wenig Platz stellt sich jede Anordnung selbständig um; die gespeicherte Seite bleibt erhalten.');
} }
$settings = []; $options = $type->settingOptions();
$labels = $type->settingLabels(); $labels = $type->settingLabels();
foreach ($type->settingOptions() as $key => $options) { $hiddenWhen = $type->settingHiddenWhen();
$field = function (string $key) use ($options, $labels, $type, $icons, $hiddenWhen): Select|ToggleButtons {
$help = $labels[$key][1] ?? null;
// Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe. // Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe.
$settings[] = $key === 'height' $component = $key === 'height'
? ToggleButtons::make('height') ? ToggleButtons::make('height')
->label('Höhe') ->label('Höhe')
->helperText('Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.') ->options($options['height'])
->options($options)
->icons($icons['height'] ?? []) ->icons($icons['height'] ?? [])
->default($type->defaultHeight()) ->default($type->defaultHeight())
->inline() ->inline()
->live() ->live()
: Select::make($key) : Select::make($key)
->label($labels[$key][0] ?? Str::headline($key)) ->label($labels[$key][0] ?? Str::headline($key))
->helperText($labels[$key][1] ?? null)
->placeholder('Vorgabe der Darstellung') ->placeholder('Vorgabe der Darstellung')
->options($options) ->options($options[$key])
->live(); ->live();
if ($key === 'height') {
$help = 'Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.';
} }
if ($settings !== []) { if (isset($hiddenWhen[$key])) {
$display[] = Grid::make(['default' => 1, 'md' => 2])->schema($settings)->statePath('settings'); [$controller, $value] = $hiddenWhen[$key];
// Ausgeblendete Werte bleiben gespeichert, damit ein späteres Einblenden nichts zurücksetzt.
$component->hidden(fn (Get $get): bool => ($get($controller) ?? null) === $value)->dehydratedWhenHidden();
}
return self::withInfo($component, $help);
};
if (isset($options['height'])) {
$layout[] = Group::make([$field('height')])->statePath('settings');
}
if ($layout !== []) {
$display[] = Section::make('Aufbau')->compact()->schema($layout);
}
$grouped = [];
foreach ($type->settingGroups() as $title => $keys) {
$keys = array_values(array_filter($keys, fn (string $key): bool => isset($options[$key]) && $key !== 'height'));
$grouped = [...$grouped, ...$keys];
if ($keys !== []) {
$display[] = Section::make($title)->compact()->schema([
Grid::make(['default' => 1, 'md' => 2])->schema(array_map($field, $keys))->statePath('settings'),
]);
}
}
$rest = array_values(array_filter(array_keys($options), fn (string $key): bool => $key !== 'height' && ! in_array($key, $grouped, true)));
if ($rest !== []) {
$display[] = Section::make($grouped === [] && $layout === [] ? 'Einstellungen' : 'Weitere Einstellungen')->compact()->schema([
Grid::make(['default' => 1, 'md' => 2])->schema(array_map($field, $rest))->statePath('settings'),
]);
} }
$variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())]; $variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())];
+4 -2
View File
@@ -110,7 +110,7 @@ ## 4. Registrierte Widget-Arten
## 5. Neues Widget hinzufügen ## 5. Neues Widget hinzufügen
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, Layoutvertrag `supportedUnits()`/`preferredUnits()`/`heights()`/`stages()`/`narrowBehavior()` (Abschnitt 12), `settings()`/`settingLabels()`/`optionIcons()`, `mediaSchema()` für den Reiter „Medien“, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`. 1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, Layoutvertrag `supportedUnits()`/`preferredUnits()`/`heights()`/`stages()`/`narrowBehavior()` (Abschnitt 12), `settings()`/`settingLabels()` (Bezeichnung und Erklärung für das (i))/`settingGroups()`/`settingHiddenWhen()`/`optionIcons()`, `mediaSchema()` für den Reiter „Medien“, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens. 2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens.
3. Klasse in `config/cms.php` unter `widgets` eintragen. 3. Klasse in `config/cms.php` unter `widgets` eintragen.
4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`). 4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`).
@@ -154,7 +154,7 @@ ## 8. Editor und Vorschau
- **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget. - **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget.
- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, **Abstand oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt. - **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, **Abstand oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt.
- **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene. - **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene.
- **Widget-Dialog**: Arten mit Darstellungsoptionen oder Medien gliedern den Dialog in die Reiter **Inhalt**, **Medien** und **Darstellung** (generisch aus der Registry: `editorSchema()`, `mediaSchema()`, Varianten und `settingOptions()`); andere Arten zeigen ihre Felder direkt. Varianten und Höhen sind sichtbare Auswahlknöpfe mit Symbol, Bildfokus zwei Schieberegler (0–100). „Darstellung“ nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz. - **Widget-Dialog**: Arten mit Darstellungsoptionen oder Medien gliedern den Dialog in die Reiter **Inhalt**, **Medien** und **Darstellung** (generisch aus der Registry: `editorSchema()`, `mediaSchema()`, Varianten und `settingOptions()`); andere Arten zeigen ihre Felder direkt. Varianten und Höhen sind sichtbare Auswahlknöpfe mit Symbol, Bildfokus zwei Schieberegler (0–100). „Darstellung“ nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz. Der Reiter „Darstellung“ ist gegliedert: **Aufbau** (Anordnung und Höhe), danach die Gruppen der Art aus `settingGroups()` (bei den Karten „Bild und Video“, „Texte auf der Karte“, „Seitenstruktur“; bei Hero und Bild-Text-Widget „Aussehen“ und „Seitenstruktur“). Einstellungen ohne Gruppe erscheinen unter „Weitere Einstellungen“. Die Erklärung zu jeder Einstellung steht im kleinen (i) neben der Bezeichnung (`settingLabels()`, zweiter Eintrag; Tooltip beim Überfahren). `settingHiddenWhen()` blendet abhängige Schalter aus, ohne ihre Werte zu verlieren: Bei „Texte auf der Karte: Ausblenden“ verschwinden Quelle der Beschreibung, Beschreibung, Art-Label, Zusatzangaben und Schaltfläche.
- **Live-Vorschau im Dialog**: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website (`WidgetEditor::renderPreview`) in einer wählbaren logischen Platzbreite (Smartphone 390 px und die zulässigen Einheiten: 310/640/960/1300 px, entsprechend dem Standardabschnitt bei 1440 px Fensterbreite) und verkleinert sie auf die Dialogbreite. Die Breitenwahl wird nicht gespeichert. - **Live-Vorschau im Dialog**: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website (`WidgetEditor::renderPreview`) in einer wählbaren logischen Platzbreite (Smartphone 390 px und die zulässigen Einheiten: 310/640/960/1300 px, entsprechend dem Standardabschnitt bei 1440 px Fensterbreite) und verkleinert sie auf die Dialogbreite. Die Breitenwahl wird nicht gespeichert.
- **Widget-Vorschau im Platz**: dieselbe Ansicht im isolierten `iframe` in der Breite des Platzes im Editor; über 28 rem gekürzt mit Hinweis „vollständig in der Seitenvorschau“. - **Widget-Vorschau im Platz**: dieselbe Ansicht im isolierten `iframe` in der Breite des Platzes im Editor; über 28 rem gekürzt mit Hinweis „vollständig in der Seitenvorschau“.
- „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen. - „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen.
@@ -314,6 +314,8 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Video im Einstieg (Hero, Variante `photo_split`).** Optional `refs.video`: ein Film aus dem Medienmanager (Auswahl über `HeroVideo`, geprüft: Film, nicht archiviert, nicht gesperrt, keine Traineranleitung). Gespielt wird der freigegebene Clip nach der Regel der Karte (`CardClip`: Trailer, Vorschauclip, sonst die freigegebene Website-Datei des Films). Das Video liegt stumm auf der Fläche des Fotos, startet nach dem Laden von selbst (nicht bei „reduzierte Bewegung“, Datensparmodus, 2G), hat eine Schaltfläche zum Anhalten und fällt bei Fehlern auf das Foto zurück; `resources/js/hero-video.js`. Die Markenfläche zeigt kein Video. Entscheidung: ADR-43 (Nachtrag). **Video im Einstieg (Hero, Variante `photo_split`).** Optional `refs.video`: ein Film aus dem Medienmanager (Auswahl über `HeroVideo`, geprüft: Film, nicht archiviert, nicht gesperrt, keine Traineranleitung). Gespielt wird der freigegebene Clip nach der Regel der Karte (`CardClip`: Trailer, Vorschauclip, sonst die freigegebene Website-Datei des Films). Das Video liegt stumm auf der Fläche des Fotos, startet nach dem Laden von selbst (nicht bei „reduzierte Bewegung“, Datensparmodus, 2G), hat eine Schaltfläche zum Anhalten und fällt bei Fehlern auf das Foto zurück; `resources/js/hero-video.js`. Die Markenfläche zeigt kein Video. Entscheidung: ADR-43 (Nachtrag).
**Karte ohne Texte (Medien-, Programm- und Modulkarte).** Einstellung `settings.show_body` (`yes` Vorgabe, `no`; Darstellung → „Texte auf der Karte“). Bei `no` zeigt die Karte nur Bild oder Video: ohne Titel, Text, Art, Zusatzangaben, Aktion und Marke im Bild, immer Bild über dem (leeren) Textbereich. Der Titel bleibt als `visually-hidden`-Überschrift für Hilfstechnik, ein Trailer läuft weiter, die Redaktionsvorschau zeigt ihre Hinweise weiter. Die Themenkarte hat die Einstellung nicht (sie bliebe leer).
**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 über dem Kartenbild: Beim Überfahren mit der Maus läuft eine stumme Vorschau in Schleife; ein Klick oder Tipp (Handy) auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton ab; `resources/js/card-clip.js`. Ohne Freigabe bleibt das Bild; die Redaktionsvorschau nennt den Grund. Entscheidung: ADR-43. **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 über dem Kartenbild: Beim Überfahren mit der Maus läuft eine stumme Vorschau in Schleife; ein Klick oder Tipp (Handy) auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton ab; `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. **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.
+8
View File
@@ -51,6 +51,14 @@ ## Stripe-Sandbox (nur Test, Etappe 1)
4. In Gitea den letzten Lauf von „Deploy Test“ erneut starten (siehe „Env-Datei ändern“). `docker exec luf-test-app-1 printenv PAYMENT_DRIVER` muss `stripe` zeigen. 4. In Gitea den letzten Lauf von „Deploy Test“ erneut starten (siehe „Env-Datei ändern“). `docker exec luf-test-app-1 printenv PAYMENT_DRIVER` muss `stripe` zeigen.
5. Testkauf mit der Stripe-Testkarte `4242 4242 4242 4242` (beliebiges künftiges Ablaufdatum, beliebige Prüfziffer). In Stripe unter Entwickler > Webhooks > Endpunkt > Ereignisse ist jede Zustellung samt Antwortcode zu sehen. 5. Testkauf mit der Stripe-Testkarte `4242 4242 4242 4242` (beliebiges künftiges Ablaufdatum, beliebige Prüfziffer). In Stripe unter Entwickler > Webhooks > Endpunkt > Ereignisse ist jede Zustellung samt Antwortcode zu sehen.
**Stolpersteine bei der ersten Einrichtung (21./22.11.2026 erlebt):**
- `STRIPE_SECRET` muss der **geheime** Schlüssel `sk_test_…` sein, nicht der veröffentlichbare `pk_test_…`. Die Anwendung weist alles andere vor dem Aufruf ab („Etappe 1 erlaubt nur den Stripe-Testmodus“).
- **Managed Payments** im Stripe-Konto verlangt für jedes Produkt einen Produkt-Steuercode (Fehler „Product tax code is required for Managed Payments“). Für die Sandbox wurde Managed Payments deaktiviert. Ein manueller Steuersatz (`txr_…`) ersetzt den Steuercode nicht.
- Der optionale Steuersatz `STRIPE_TAX_RATE_ID` muss im Preis **enthalten** (inklusiv) angelegt sein. In der Stripe-Kasse erscheint dann „Umsatzsteuer (19 % inklusive)“ und die Gesamtsumme bleibt gleich der Bestellsumme.
- Eine Änderung in `test.env` wirkt erst nach dem erneuten Lauf „Deploy Test“ (siehe oben). Die Variablennamen im Container zeigt `docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' luf-test-app-1 | sed 's/=.*//'`, ohne Werte.
- Warum Stripe eine Anfrage ablehnt, steht im App-Protokoll: `docker logs luf-test-app-1 --tail 300 2>&1 | grep 'Stripe-Anfrage'` (Status, Typ, Parameter und Begründung, keine Schlüssel).
**Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen. **Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen.
**Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox. **Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox.
@@ -12,6 +12,8 @@ ## 1. Inhalt (Stand 21.11.2026 abends: 22 Commits seit `main`)
| Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude | | Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude |
| Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) beim Überfahren mit der Maus als stumme Vorschau und per Klick oder Tipp mit Ton ab (kleine Symbolschaltfläche); je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude | | Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) beim Überfahren mit der Maus als stumme Vorschau und per Klick oder Tipp mit Ton ab (kleine Symbolschaltfläche); je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude |
| Medienkarte: Film nur mit Website-Datei | Ein Medium ohne Fassung (z. B. Teaser) ist auf der Medienkarte wählbar und erscheint öffentlich, sobald die Datei für die Website freigegeben ist (ohne Programmseite, ohne Aktion). Keine Migration | Claude | | Medienkarte: Film nur mit Website-Datei | Ein Medium ohne Fassung (z. B. Teaser) ist auf der Medienkarte wählbar und erscheint öffentlich, sobald die Datei für die Website freigegeben ist (ohne Programmseite, ohne Aktion). Keine Migration | Claude |
| Karte ohne Texte | Medien- und Programmkarte: Einstellung „Texte auf der Karte“ (Ausblenden) zeigt nur Bild oder Video; der Titel bleibt für Hilfstechnik. Keine Migration | Claude |
| Reiter „Darstellung“ gegliedert | Aufbau, Gruppen je Widget, Erklärungen im (i), Einzelschalter für Texte verschwinden bei „Texte auf der Karte: Ausblenden“; Bezeichnungen vereinheitlicht. Keine Migration, gespeicherte Werte unverändert | Claude |
| Hero mit Video | Der Einstieg (Variante Foto mit Textfläche) spielt auf Wunsch ein freigegebenes Video stumm auf der Fläche des Fotos ab, mit Schaltfläche zum Anhalten; Foto als Rückfall (ADR-43 Nachtrag). Keine Migration | Claude | | Hero mit Video | Der Einstieg (Variante Foto mit Textfläche) spielt auf Wunsch ein freigegebenes Video stumm auf der Fläche des Fotos ab, mit Schaltfläche zum Anhalten; Foto als Rückfall (ADR-43 Nachtrag). Keine Migration | Claude |
| Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) | | Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) |
| Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude | | Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude |
+11
View File
@@ -0,0 +1,11 @@
# Abnahme: Reiter „Darstellung“ gegliedert (luf-test, 2026-11-22)
Geprüft in der echten Anwendung (Medien- und Materialkarte, 1440 px, Playwright gegen luf-test, nichts gespeichert):
- Gruppen **Aufbau**, **Bild und Video**, **Texte auf der Karte**, **Seitenstruktur**; Erklärungen als kleines (i) neben der Bezeichnung, der Text erscheint beim Überfahren.
- „Texte auf der Karte: Ausblenden“ blendet Quelle der Beschreibung, Beschreibung, Art-Label, Zusatzangaben und Schaltfläche aus; „Anzeigen“ bringt sie mit den früheren Werten zurück.
- Offen: Der Hinweis erscheint beim Überfahren; für Tastatur und Touch ist das (i) nicht gesondert geprüft.
| | |
|---|---|
| ![Gruppiert, Hinweis beim Überfahren](darstellung/01-gruppiert-mit-hinweis.png) | ![Texte ausgeblendet](darstellung/02-texte-ausgeblendet.png) |
Binary file not shown.

After

Width:  |  Height:  |  Size: 253 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 238 KiB

+2
View File
@@ -44,6 +44,8 @@ ## Nachbesserung Shop-Verwaltung (Abnahmebefund von Lars, 21.11.2026)
**Schmale Ansicht und Tastatur.** Kein horizontaler Überlauf bei 760 und 390 px (gemessen an Artikel, Paket, Angebot, Shop und Produktseiten; die Angebotsmaske wurde nur als Bild aufgenommen, nicht gemessen): Bilder [20](etappe-1/nachbesserung/20-schmal-390-angebot.png), [21](etappe-1/nachbesserung/21-schmal-760-artikel.png), [22](etappe-1/nachbesserung/22-schmal-390-produktseite.png). Tab erreicht „Inhalt festlegen“, „Redaktion bearbeiten“ und „Angebote öffnen“ mit sichtbarem Fokusrahmen (3 px solid). Enter am Schritt öffnet den Dialog, Esc schließt ihn ([Bild 23](etappe-1/nachbesserung/23-tastatur-fokus-schritt.png)). **Schmale Ansicht und Tastatur.** Kein horizontaler Überlauf bei 760 und 390 px (gemessen an Artikel, Paket, Angebot, Shop und Produktseiten; die Angebotsmaske wurde nur als Bild aufgenommen, nicht gemessen): Bilder [20](etappe-1/nachbesserung/20-schmal-390-angebot.png), [21](etappe-1/nachbesserung/21-schmal-760-artikel.png), [22](etappe-1/nachbesserung/22-schmal-390-produktseite.png). Tab erreicht „Inhalt festlegen“, „Redaktion bearbeiten“ und „Angebote öffnen“ mit sichtbarem Fokusrahmen (3 px solid). Enter am Schritt öffnet den Dialog, Esc schließt ihn ([Bild 23](etappe-1/nachbesserung/23-tastatur-fokus-schritt.png)).
**Stripe-Sandbox (22.11.2026, auf `luf-test`).** Bestellung 7 des Mitgliederkontos (Angebot „Einzelartikel Film“, 12,00 €) wurde über die Stripe-Kasse im Testmodus bezahlt: Auf der Bestellseite statt der Testschaltflächen „Jetzt bezahlen (Stripe-Testmodus)“ ([Bild 24](etappe-1/nachbesserung/24-stripe-bestellung-offen.png)), Weiterleitung zur Stripe-Kasse („Umsatzsteuer (19 % inklusive) 1,92 €, Gesamtsumme 12,00 €“), Testkarte `4242 4242 4242 4242`, Rückkehr auf die Bestellseite mit Status „Bezahlt (Testzahlung)“ ([Bild 25](etappe-1/nachbesserung/25-stripe-bestellung-bezahlt.png)). Die Freischaltung kam durch die signierte Meldung von Stripe an den Webhook; die neue Lizenz steht in „Meine Lizenzen“ mit dem Datum des Kaufs, „Widerrufen“ ist im Stripe-Modus ausgeblendet. Nicht geprüft: Abbruch in der Stripe-Kasse, abgelaufene Kasse, Erstattung, Zahlung mit abgelehnter Karte, Vereinskauf über Stripe, Mehrpositionskauf über Stripe im Browser (per Test abgedeckt). Die Stripe-Kasse selbst ist nicht abgebildet, weil sie die E-Mail-Adresse des Kontos zeigt. Der Weg dahin und die Stolpersteine stehen in `docs/betrieb/DEPLOYMENT.md`.
**Tests.** `php artisan test`: **439 grün**, Pint bestanden. Neu: `ShopVerwaltungAbnahmeTest` (11 Tests). Ein Bestandstest geändert und im Commit begründet: `OrganizationPurchaseTest::test_membership_boundaries_decide_the_club_access` setzte die Uhrzeit erst nach der Bestellung auf 12:00 UTC und scheiterte dadurch nach 12:00 UTC. Die feste Uhrzeit gilt jetzt vorher, die Assertions bleiben. **Tests.** `php artisan test`: **439 grün**, Pint bestanden. Neu: `ShopVerwaltungAbnahmeTest` (11 Tests). Ein Bestandstest geändert und im Commit begründet: `OrganizationPurchaseTest::test_membership_boundaries_decide_the_club_access` setzte die Uhrzeit erst nach der Bestellung auf 12:00 UTC und scheiterte dadurch nach 12:00 UTC. Die feste Uhrzeit gilt jetzt vorher, die Assertions bleiben.
**Abweichung von den Verwaltungs-Tokens:** Das Stilblatt der Schritte (`.vw-schritt`) nutzt feste Größen und einen Umbruch bei `640px`. Das entspricht dem vorhandenen `40rem`, steht aber in einer anderen Einheit, und die Werte sind noch nicht in `tokens.md` dokumentiert. Das ist eine Nacharbeit ohne Wirkung auf die Funktion. **Abweichung von den Verwaltungs-Tokens:** Das Stilblatt der Schritte (`.vw-schritt`) nutzt feste Größen und einen Umbruch bei `640px`. Das entspricht dem vorhandenen `40rem`, steht aber in einer anderen Einheit, und die Werte sind noch nicht in `tokens.md` dokumentiert. Das ist eine Nacharbeit ohne Wirkung auf die Funktion.
Binary file not shown.

After

Width:  |  Height:  |  Size: 63 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

@@ -80,6 +80,12 @@ .lf-pc--contain .lf-pc__image {
padding: 8px; padding: 8px;
} }
/* Nur Bild oder Video (Einstellung „Texte neben dem Bild“ ausgeblendet): ringsum gleicher Rand, kein Textbereich. */
.lf-pc--bare .lf-pc__visual,
.lf-pc--bare .lf-pc__panel { margin-block-end: 10px; }
.lf-pc--bare .lf-pc__body { padding: 0; gap: 0; }
.lf-pc__badge { .lf-pc__badge {
position: absolute; position: absolute;
inset: 12px auto auto 12px; inset: 12px auto auto 12px;
+10 -7
View File
@@ -9,6 +9,8 @@
öffentlich markiert. Es hat keine Freigabe für die Website und wird öffentlich nie ausgegeben. öffentlich markiert. Es hat keine Freigabe für die Website und wird öffentlich nie ausgegeben.
3. Tafel nach Fachobjekt: Programm/Modul (Navy), Film (Filmtafel), Material (Materialsymbol); Thema ohne Bildbereich. 3. Tafel nach Fachobjekt: Programm/Modul (Navy), Film (Filmtafel), Material (Materialsymbol); Thema ohne Bildbereich.
Hinweise auf fehlende Inhalte stehen nur in der Redaktionsvorschau, öffentlich nie. Hinweise auf fehlende Inhalte stehen nur in der Redaktionsvorschau, öffentlich nie.
Texte ausgeblendet ($bare, Einstellung „Texte neben dem Bild“): nur Bildbereich; der Titel bleibt unsichtbar für
Hilfstechnik, Hinweise für die Redaktion weiter in der Vorschau.
Trailer: Ist für das Objekt ein für die Website freigegebener Clip da ($clip['url'], CardClip), liegt er stumm und Trailer: Ist für das Objekt ein für die Website freigegebener Clip da ($clip['url'], CardClip), liegt er stumm und
unsichtbar über dem Bildbereich und startet beim Überfahren mit der Maus, am Handy mit Tippen auf das Bild, per unsichtbar über dem Bildbereich und startet beim Überfahren mit der Maus, am Handy mit Tippen auf das Bild, per
@@ -43,7 +45,8 @@
'lf-pc--'.$cardStyle, 'lf-pc--'.$cardStyle,
'lf-pc--'.$format, 'lf-pc--'.$format,
'lf-pc--'.$fit, 'lf-pc--'.$fit,
'lf-pc--stacked' => $stacked, 'lf-pc--stacked' => $stacked || ! empty($bare),
'lf-pc--bare' => ! empty($bare),
'lf-pc--without-visual' => $imageUrl === null && $libraryImage === null && $panel === null, 'lf-pc--without-visual' => $imageUrl === null && $libraryImage === null && $panel === null,
'lf-pc--internal' => ! $subject->public, 'lf-pc--internal' => ! $subject->public,
]) style="--pc-focus-x: {{ $focus['x'] }}%; --pc-focus-y: {{ $focus['y'] }}%"> ]) style="--pc-focus-x: {{ $focus['x'] }}%; --pc-focus-y: {{ $focus['y'] }}%">
@@ -51,7 +54,7 @@
<div class="lf-pc__visual" @if ($clipUrl !== null) data-card-clip data-clip-src="{{ $clipUrl }}" data-clip-title="{{ $clipTitle }}" @endif> <div class="lf-pc__visual" @if ($clipUrl !== null) data-card-clip data-clip-src="{{ $clipUrl }}" data-clip-title="{{ $clipTitle }}" @endif>
<img class="lf-pc__image" src="{{ $imageUrl ?? $libraryImage }}" alt="{{ $imageUrl !== null ? $alt : '' }}" loading="lazy" decoding="async"> <img class="lf-pc__image" src="{{ $imageUrl ?? $libraryImage }}" alt="{{ $imageUrl !== null ? $alt : '' }}" loading="lazy" decoding="async">
@include('widgets.partials.card-clip') @include('widgets.partials.card-clip')
@if ($show['kind'] && $subject->badge !== null) @if ($show['kind'] && $subject->badge !== null && empty($bare))
<span class="lf-pc__badge">{{ $subject->badge }}</span> <span class="lf-pc__badge">{{ $subject->badge }}</span>
@endif @endif
@if ($libraryImage !== null) @if ($libraryImage !== null)
@@ -78,21 +81,21 @@
</div> </div>
@endif @endif
<div class="lf-pc__body"> <div class="lf-pc__body">
@if ($show['kind'] && $subject->kind !== '') @if (empty($bare) && $show['kind'] && $subject->kind !== '')
<p class="lf-pc__kind">{{ $subject->kind }}</p> <p class="lf-pc__kind">{{ $subject->kind }}</p>
@endif @endif
<{{ $headingTag }} class="lf-pc__title">{{ $subject->title }}</{{ $headingTag }}> <{{ $headingTag }} @class(['lf-pc__title', 'visually-hidden' => ! empty($bare)])>{{ $subject->title }}</{{ $headingTag }}>
@if ($show['summary'] && filled($subject->summary)) @if (empty($bare) && $show['summary'] && filled($subject->summary))
<p class="lf-pc__summary">{{ $subject->summary }}</p> <p class="lf-pc__summary">{{ $subject->summary }}</p>
@endif @endif
@if ($meta !== []) @if (empty($bare) && $meta !== [])
<ul class="lf-pc__meta" aria-label="Weitere Angaben"> <ul class="lf-pc__meta" aria-label="Weitere Angaben">
@foreach ($meta as $item) @foreach ($meta as $item)
<li>{{ $item }}</li> <li>{{ $item }}</li>
@endforeach @endforeach
</ul> </ul>
@endif @endif
@if ($action !== null || $note !== null) @if (empty($bare) && ($action !== null || $note !== null))
<div class="lf-pc__footer"> <div class="lf-pc__footer">
@if ($note !== null) @if ($note !== null)
<p class="lf-pc__note">{{ $note }}</p> <p class="lf-pc__note">{{ $note }}</p>
+187
View File
@@ -0,0 +1,187 @@
<?php
namespace Tests\Feature;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Catalog\PresentationAssignment;
use App\Domain\Catalog\PresentationRole;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageRevision;
use App\Domain\Cms\PageService;
use App\Domain\Cms\Widgets\Support\CardClip;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetRegistry;
use App\Domain\Media\PresentationFile;
use App\Domain\Media\WebsiteMedia;
use App\Domain\Media\WebsiteRelease;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Storage;
use Illuminate\Validation\ValidationException;
use Tests\TestCase;
/**
* Medien- und Programmkarte ohne Texte: Die Einstellung „Texte neben dem Bild“ (show_body = no) zeigt nur Bild oder
* Video, ohne Titel, Text, Art, Zusatzangaben und Aktion. Der Titel bleibt für Hilfstechnik unsichtbar erhalten, ein
* Trailer läuft weiter.
*/
class CmsCardWithoutTextTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
Storage::fake('cms_incoming');
Storage::fake('media_derived');
Storage::fake('media_public');
Storage::fake('media_originals');
}
public function test_the_default_still_shows_all_texts(): void
{
$film = $this->publicFilm();
$this->publish('/mit-text', $this->card($film, []));
$html = $this->card_html($this->get('/mit-text')->assertOk()->getContent());
$this->assertStringContainsString('Eine Pause, die stark macht', $html);
$this->assertStringContainsString('KURZ-TEXT', $html);
$this->assertStringContainsString('lf-pc__cta', $html);
$this->assertStringContainsString('lf-pc__meta', $html);
$this->assertStringNotContainsString('lf-pc--bare', $html);
}
public function test_without_texts_only_the_picture_remains_and_the_title_stays_for_assistive_technology(): void
{
$film = $this->publicFilm();
$this->publish('/ohne-text', $this->card($film, ['show_body' => 'no']));
$html = $this->card_html($this->get('/ohne-text')->assertOk()->getContent());
$this->assertStringContainsString('lf-pc--bare', $html);
$this->assertStringNotContainsString('KURZ-TEXT', $html);
$this->assertStringNotContainsString('lf-pc__cta', $html, 'Keine Aktion.');
$this->assertStringNotContainsString('lf-pc__meta', $html, 'Keine Zusatzangaben.');
$this->assertStringNotContainsString('lf-pc__kind', $html, 'Keine Art.');
$this->assertStringNotContainsString('lf-pc__badge', $html, 'Keine Marke im Bild.');
$this->assertStringContainsString('class="lf-pc__title visually-hidden"', $html);
$this->assertStringContainsString('Eine Pause, die stark macht', $html, 'Der Titel bleibt für Hilfstechnik erhalten.');
}
public function test_the_trailer_still_plays_on_a_card_without_texts(): void
{
$film = $this->publicFilm();
$trailer = $this->clip('Trailer Denkpause');
PresentationAssignment::query()->create([
'subject_type' => $film->getMorphClass(),
'subject_id' => $film->getKey(),
'content_element_id' => $trailer->id,
'presentation_role_id' => PresentationRole::query()->where('slug', 'trailer')->value('id'),
'position' => 1,
]);
app(WebsiteRelease::class)->release($trailer->fresh());
foreach ([WebsiteImage::class, CardClip::class, WebsiteMedia::class] as $class) {
$this->app->forgetInstance($class);
}
$this->publish('/ohne-text-trailer', $this->card($film, ['show_body' => 'no']));
$html = $this->card_html($this->get('/ohne-text-trailer')->assertOk()->getContent());
$this->assertStringContainsString('data-clip-src="'.route('website.media', $trailer).'"', $html);
$this->assertStringContainsString('aria-label="Trailer abspielen: Trailer Denkpause"', $html);
$this->assertStringNotContainsString('KURZ-TEXT', $html);
}
public function test_only_cards_with_a_picture_offer_the_choice_and_it_is_validated(): void
{
$registry = app(WidgetRegistry::class);
$this->assertSame(['yes', 'no'], array_keys($registry->get('media_card')->settingOptions()['show_body']));
$this->assertSame(['yes', 'no'], array_keys($registry->get('program_card')->settingOptions()['show_body']));
$this->assertArrayNotHasKey('show_body', $registry->get('topic_card')->settingOptions(), 'Eine Themenkarte ohne Bild bliebe leer.');
$film = $this->publicFilm();
try {
$registry->normalize($this->card($film, ['show_body' => 'vielleicht'])[0]['slots']);
$this->fail('Eine unbekannte Wahl wurde angenommen.');
} catch (ValidationException $exception) {
$this->assertArrayHasKey('blocks.0.settings.show_body', $exception->errors());
}
}
public function test_the_preview_keeps_the_editorial_notes_on_a_card_without_texts(): void
{
$film = $this->publicFilm();
$revision = $this->publish('/ohne-text-vorschau', $this->card($film, ['show_body' => 'no']));
$preview = $this->actingAs(User::factory()->redakteur()->create(), 'staff')->get(route('pages.preview', $revision))->assertOk()->getContent();
$this->assertStringContainsString('lf-pc--bare', $preview);
$this->assertStringNotContainsString('lf-pc__cta', $preview);
}
/**
* @param array<string, string> $settings
* @return list<array<string, mixed>>
*/
private function card(ContentElement $film, array $settings): array
{
return [['layout' => 'u4', 'style' => [], 'slots' => [
['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => $settings, 'data' => [], 'refs' => ['element' => $film->id]],
]]];
}
private function card_html(string $html): string
{
preg_match('#<article class="lf-pc .*?</article>#s', $html, $match);
return $match[0] ?? '';
}
/**
* @param list<array<string, mixed>> $sections
*/
private function publish(string $path, array $sections): PageRevision
{
$page = Page::query()->create(['path' => $path]);
$service = app(PageService::class);
$revision = $service->saveRevision($page, $sections, null, null, null);
$service->publish($page, $revision);
return $revision;
}
private function publicFilm(): ContentElement
{
$content = app(ContentService::class);
$film = $content->createElement('film', 'film', 'Denkpause Rohschnitt');
$film->update(['display_title' => 'Eine Pause, die stark macht', 'summary' => 'KURZ-TEXT']);
$film->forceFill(['editorial_content_kind_id' => EditorialContentKind::query()->where('slug', 'unterrichtsfilm')->value('id')])->save();
$version = $content->publishElementVersion($film, 'Film');
$composition = $content->createComposition('Programm Denkpause');
$composition->editorial_content_kind_id = EditorialContentKind::query()->where('slug', 'programm')->value('id');
$composition->save();
$shown = $content->publishComposition($composition, [['role' => 'Film', 'target' => $version]]);
app(CompositionDisplayRelease::class)->release($shown, User::factory()->create());
return $film->refresh();
}
private function clip(string $title): ContentElement
{
$path = 'inhalte/'.md5($title).'.mp4';
Storage::disk('cms_incoming')->put($path, '0123456789abcdefghij');
$element = app(ContentService::class)->createElement('film', 'film', $title);
$element->display_title = $title;
$element->save();
app(PresentationFile::class)->store($element, $path);
return $element->fresh();
}
}
+49
View File
@@ -70,6 +70,55 @@ public function test_registration_rejects_keys_that_are_not_stable_identifiers()
} }
/** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */ /** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */
public function test_settings_are_grouped_explained_and_consistent_for_every_widget(): void
{
foreach ($this->registry()->all() as $key => $type) {
$options = $type->settingOptions();
$labels = $type->settingLabels();
$grouped = [];
foreach ($type->settingGroups() as $title => $keys) {
$this->assertNotSame('', $title, $key);
foreach ($keys as $setting) {
// Gemeinsame Gruppen dürfen Einstellungen nennen, die eine Art nicht anbietet (zum Beispiel Trailer
// oder Art-Label); der Editor übergeht sie.
$this->assertNotContains($setting, $grouped, "$key: $setting steht in zwei Gruppen");
$grouped[] = $setting;
}
}
// Jede Einstellung außer der Höhe (hat eigenen Hinweis) ist gruppiert, benannt und erklärt.
foreach (array_keys($options) as $setting) {
if ($setting === 'height') {
continue;
}
$this->assertContains($setting, $grouped, "$key: $setting gehört in eine Gruppe");
$this->assertNotEmpty($labels[$setting][0] ?? null, "$key: $setting braucht eine Bezeichnung");
$this->assertNotEmpty($labels[$setting][1] ?? null, "$key: $setting braucht eine Erklärung für das (i)");
}
foreach ($type->settingHiddenWhen() as $setting => [$controller, $value]) {
// Gemeinsame Regeln dürfen Einstellungen nennen, die eine Art nicht anbietet; wirksam sind sie nur,
// wenn beide da sind, und der Wert muss dann zur steuernden Einstellung passen.
if (isset($options[$setting], $options[$controller])) {
$this->assertArrayHasKey($value, $options[$controller], "$key: $controller kennt den Wert $value nicht");
}
}
$this->assertNotNull(WidgetEditor::block($type), $key);
}
}
public function test_text_switches_are_hidden_when_all_texts_are_switched_off(): void
{
$hidden = $this->registry()->get('media_card')->settingHiddenWhen();
foreach (['text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'] as $setting) {
$this->assertSame(['show_body', 'no'], $hidden[$setting]);
}
$this->assertArrayNotHasKey('heading_level', $hidden);
}
public function test_every_widget_declares_the_shared_layout_contract(): void public function test_every_widget_declares_the_shared_layout_contract(): void
{ {
foreach ($this->registry()->all() as $key => $type) { foreach ($this->registry()->all() as $key => $type) {