Integriere die Premium-Karten v1.7 als Themen-, Medien- und Programmkarte.
CI Feature / test (push) Successful in 46s
Deploy Test / test (push) Successful in 39s
Deploy Test / deploy (push) Successful in 29s

- Drei Widget-Arten (topic_card, media_card, program_card) auf gemeinsamer Basis, eine Karte je Platz im
  bestehenden Abschnittsraster; kein zweites Kartenraster.
- Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel kommen zur Laufzeit aus Thema, Inhaltselement
  bzw. Programm/Modul; im CMS stehen nur Kennungen, Bild, Bildausschnitt, Beschriftung und Hinweis.
- Medienkarten sind öffentlich nur als Bestandteil eines öffentlichen Programms (PublicMaterialReader),
  Module nur in der Redaktionsvorschau; keine Bibliotheksbilder, kein Preis, keine Kaufaktion.
- Gleiche Höhe je Zeile über die gemeinsame Höhe „fill“; Raster 1 + 1 + 2 und 2 + 1 + 1 ergänzt.
- Tests zu Raster- und Widgetliste bewusst um die neuen Raster und Arten erweitert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-18 13:25:06 +01:00
1 parent cca069be48
commit 127ea86817
16 files changed
+1579 -3

No files matched your search

+28
View File
@@ -0,0 +1,28 @@
<?php
namespace App\Domain\Cms\Catalog;
/**
* Anzeigedaten des Fachobjekts hinter einer Premium-Karte (Thema, Medium/Material, Programm/Modul).
* Wird zur Laufzeit aus den maßgeblichen Fachdaten gelesen und nie im CMS gespeichert.
*
* - url: nur ein öffentlich freigegebenes Ziel aus dem Fachobjekt (Themenseite, Programmseite), sonst null.
* - public: false heißt „nur in der Redaktionsvorschau“; öffentlich entfällt die Karte dann.
* - notice: redaktioneller Hinweis für die Vorschau, warum die Karte öffentlich nicht erscheint.
*/
final readonly class CardSubject
{
/**
* @param list<string> $meta reine Anzeigetexte aus Fachdaten
*/
public function __construct(
public string $title,
public ?string $summary,
public string $kind,
public ?string $badge,
public array $meta,
public ?string $url,
public bool $public,
public ?string $notice = null,
) {}
}
@@ -171,6 +171,44 @@ public function entries(array $refs, bool $includeNonPublic): array
return $entries;
}
/**
* Anzeigedaten für eine Programm- oder Modulkarte (Premium-Karte). Dieselbe Regel wie entries():
* Programme mit Anzeigefreigabe öffentlich mit Programmseite, Module nur in der Redaktionsvorschau.
* Die Art („Programm“ oder „Modul“) ist immer benannt. Kein Preis, kein Angebot, keine Kaufaktion.
*/
public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
{
$entry = $this->entries([['type' => 'composition', 'id' => $id]], $includeNonPublic)[0] ?? null;
if ($entry === null) {
return null;
}
$meta = [];
$composition = Composition::query()->find($entry->id);
$version = $composition !== null ? $this->shownVersion($composition) : null;
if ($version !== null) {
$nested = $version->members()->whereNotNull('nested_composition_version_id')->with('nestedCompositionVersion.composition.editorialContentKind')->get();
$modules = $nested->filter(fn ($member): bool => $member->nestedCompositionVersion?->composition?->editorialContentKind?->slug === 'modul')->count();
if ($modules > 0) {
$meta[] = $modules === 1 ? '1 Modul' : $modules.' Module';
}
}
return new CardSubject(
title: $entry->title,
summary: $entry->summary,
kind: $entry->kindLabel,
badge: null,
meta: $meta,
url: $entry->url,
public: $entry->public,
notice: $entry->public ? null : 'Nur in der Redaktionsvorschau sichtbar: Für Module gibt es noch keine öffentliche Seitenart (öffentliches Profil, ADR-29).',
);
}
private function title(Composition $composition): string
{
return (string) ($composition->display_title ?: $composition->designation);
@@ -0,0 +1,196 @@
<?php
namespace App\Domain\Cms\Catalog;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\StructureNode;
/**
* Lesesicht „Medien und Materialien“ für Premium-Karten (Website-CMS-Zielarchitektur 6.2).
*
* Übergangsregel, solange öffentliche Fachobjektprofile (ADR-29) fehlen:
* Ein Medium oder Material hat keine eigene öffentliche Seite. Öffentlich genannt wird es heute nur als Bestandteil
* 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,
* Vorschaubilder der Bibliothek oder Ausgabeadressen. Eine Karte gibt kein Medium frei.
*/
class PublicMaterialReader
{
/** @var array<int, array{id: int, title: string}>|null Element-ID => erstes öffentliches Programm */
private ?array $publicIndex = null;
public function __construct(
private readonly PublicCatalogReader $catalog,
private readonly CompositionStructureReader $structure,
) {}
/**
* Wählbar ist ein nicht archiviertes Element mit mindestens einer bereitgestellten (nicht gesperrten) Fassung.
*/
public function isSelectable(ContentElement $element): bool
{
return $element->archived_at === null
&& $element->versions()->where('status', ContentVersionStatus::Bereit->value)->exists();
}
/**
* Öffentliches Programm, in dessen gezeigter Fassung das Element vorkommt, sonst null.
*
* @return array{id: int, title: string}|null
*/
public function publicProgramFor(ContentElement $element): ?array
{
return $this->publicIndex()[$element->id] ?? null;
}
/**
* @return array<int, string>
*/
public function search(?string $term, int $limit = 25): array
{
$term = trim((string) $term);
$candidates = ContentElement::query()
->with('editorialContentKind')
->whereNull('archived_at')
->whereHas('versions', fn ($query) => $query->where('status', ContentVersionStatus::Bereit->value))
->when($term !== '', function ($query) use ($term): void {
$like = '%'.mb_strtolower($term).'%';
$query->where(fn ($inner) => $inner
->whereRaw('LOWER(working_title) LIKE ?', [$like])
->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]));
})
->orderBy('working_title')
->limit($limit)
->get();
$options = [];
foreach ($candidates as $element) {
$options[$element->id] = $this->optionLabel($element);
}
return $options;
}
public function labelFor(mixed $id): ?string
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
return $element === null ? null : $this->optionLabel($element);
}
/**
* Anzeigedaten für eine Karte. Öffentlich null, wenn das Element nicht öffentlich genannt wird.
*/
public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
if ($element === null || ! $this->isSelectable($element)) {
return null;
}
$program = $this->publicProgramFor($element);
if ($program === null && ! $includeNonPublic) {
return null;
}
$output = self::outputLabel((string) $element->output_class);
$editorialKind = $element->editorialContentKind?->label;
return new CardSubject(
title: $this->title($element),
summary: filled($element->summary) ? (string) $element->summary : null,
kind: filled($editorialKind) ? (string) $editorialKind : $output,
badge: $output,
meta: array_values(array_filter([
$output,
$program !== null ? 'Im Programm „'.$program['title'].'“' : null,
])),
url: $program !== null ? route('public.program', $program['id']) : null,
public: $program !== null,
notice: $program === null
? 'Nur in der Redaktionsvorschau sichtbar: Dieses Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29).'
: null,
);
}
/** Bezeichnung der Ausgabeart, wie in der Redaktionsstruktur (CompositionRelease::outputLabel). */
public static function outputLabel(string $outputClass): string
{
return match ($outputClass) {
'film' => 'Film',
'audio' => 'Hörstück',
'bild' => 'Bild',
'document', 'pdf' => 'Dokument',
default => 'Text',
};
}
private function title(ContentElement $element): string
{
return (string) ($element->display_title ?: $element->working_title);
}
private function optionLabel(ContentElement $element): string
{
$visibility = $this->publicProgramFor($element) !== null ? 'öffentlich über Programmseite' : 'nur Redaktionsvorschau';
$kind = $element->editorialContentKind?->label ?: self::outputLabel((string) $element->output_class);
return $this->title($element).' · '.$kind.' · '.$visibility;
}
/**
* Index aller Elemente, die in der gezeigten Fassung eines öffentlichen Programms vorkommen (auch verschachtelt).
*
* @return array<int, array{id: int, title: string}>
*/
private function publicIndex(): array
{
if ($this->publicIndex !== null) {
return $this->publicIndex;
}
$index = [];
foreach ($this->catalog->publicPrograms() as $program) {
$version = $this->catalog->shownVersion($program);
if ($version === null) {
continue;
}
$entry = ['id' => (int) $program->id, 'title' => (string) ($program->display_title ?: $program->designation)];
foreach ($this->elementIds($this->structure->tree($version)) as $elementId) {
$index[$elementId] ??= $entry;
}
}
return $this->publicIndex = $index;
}
/**
* @param list<StructureNode> $nodes
* @return list<int>
*/
private function elementIds(array $nodes): array
{
$ids = [];
foreach ($nodes as $node) {
if ($node->contentElementId !== null) {
$ids[] = (int) $node->contentElementId;
}
array_push($ids, ...$this->elementIds($node->children));
}
return $ids;
}
}
@@ -22,6 +22,8 @@ final class SectionLayouts
'u3_1' => [3, 1],
'u1_2_1' => [1, 2, 1],
'u1_1_1_1' => [1, 1, 1, 1],
'u1_1_2' => [1, 1, 2],
'u2_1_1' => [2, 1, 1],
];
/** @var array<string, string> */
@@ -32,6 +34,8 @@ final class SectionLayouts
'u3_1' => 'Breit und schmal',
'u1_2_1' => 'Mitte betont',
'u1_1_1_1' => 'Vier gleich breit',
'u1_1_2' => 'Zwei schmal, eins breit',
'u2_1_1' => 'Eins breit, zwei schmal',
];
public static function has(mixed $key): bool
@@ -0,0 +1,91 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\ContentElement;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement (Film, Dokument, Hörstück …) mit Anzeigetitel,
* Kurzbeschreibung, Inhaltsart und Ausgabeart. Öffentlich nur, wenn das Element zur gezeigten Fassung eines
* öffentlichen Programms gehört (PublicMaterialReader); die Aktion führt dann auf diese Programmseite.
* Die Karte spielt nichts ab, bietet keinen Download und gibt kein geschütztes Medium frei.
*/
class MediaCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'media_card';
}
public function label(): string
{
return 'Medien- und Materialkarte';
}
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.';
}
public function icon(): string
{
return 'heroicon-o-film';
}
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']];
}
protected function refKey(): string
{
return 'element';
}
protected function refLabel(): string
{
return 'Medium oder Material';
}
protected function refHelp(): string
{
return 'Wählbar sind bereitgestellte, nicht archivierte Inhalte. Öffentlich erscheint die Karte nur, wenn der Inhalt zu einem öffentlich gezeigten Programm gehört; sonst nur in der Redaktionsvorschau.';
}
protected function searchSubjects(?string $term): array
{
return app(PublicMaterialReader::class)->search($term);
}
protected function subjectLabel(mixed $id): ?string
{
return app(PublicMaterialReader::class)->labelFor($id);
}
protected function rejectSubject(int $id): ?string
{
$element = ContentElement::query()->find($id);
return $element !== null && app(PublicMaterialReader::class)->isSelectable($element)
? null
: 'Dieser Inhalt ist nicht bereitgestellt oder archiviert.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
return app(PublicMaterialReader::class)->subject($id, includeNonPublic: $context->preview);
}
protected function defaultActionLabel(): string
{
return 'Im Programm ansehen';
}
protected function cardStyle(): string
{
return 'media';
}
}
@@ -0,0 +1,276 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
/**
* Gemeinsame Basis der Premium-Karten (Brand-UI-Kit v1.7, Entwurf zur visuellen Freigabe):
* Redaktionelle Themenkarte, Medien- und Materialkarte, Modul- und Programmkarte.
*
* - Eine Karte je Widget, ein Widget je Platz. Das Raster ist das bestehende Abschnittsraster (1 bis 4 Einheiten);
* es gibt kein zweites Kartenraster.
* - refs: genau ein Fachobjekt (Kennung) und optional ein Bild aus dem öffentlichen Website-Bereich.
* Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel kommen zur Laufzeit aus den Fachdaten.
* - data: nur Redaktionelles, das es im Fachobjekt nicht gibt: Beschriftung der Aktion, Hinweis, Alternativtext,
* Bildausschnitt. Ein freies Linkziel gibt es nicht; das Ziel ist immer die öffentliche Seite des Fachobjekts.
* - Bilder der Bibliothek (Vorschaubilder, Filmstandbilder) werden nie gezeigt.
*/
abstract class PremiumCardWidget extends WidgetType
{
public const SHOW = ['yes' => 'Anzeigen', 'no' => 'Ausblenden'];
/** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */
abstract protected function refKey(): string;
abstract protected function refLabel(): string;
abstract protected function refHelp(): string;
/**
* @return array<int, string>
*/
abstract protected function searchSubjects(?string $term): array;
abstract protected function subjectLabel(mixed $id): ?string;
/** Prüft beim Speichern, ob das Objekt gewählt werden darf; liefert sonst die Fehlermeldung. */
abstract protected function rejectSubject(int $id): ?string;
abstract protected function subject(mixed $id, RenderContext $context): ?CardSubject;
abstract protected function defaultActionLabel(): string;
/** Gestaltungsvariante des Kits: editorial, media oder catalog. */
abstract protected function cardStyle(): string;
public function view(): string
{
return 'widgets.premium_card';
}
public function supportedUnits(): array
{
return [1, 2, 3, 4];
}
public function preferredUnits(): int
{
return 1;
}
public function stages(): array
{
return [
'stacked' => 'unter 520 px Kartenbreite: Bild oder Tafel über dem Text',
'side' => 'ab 520 px: Bild links (42 %), Text rechts (58 %); das gewählte Bildformat bleibt erhalten',
];
}
public function narrowBehavior(): string
{
return 'Unter 520 px Kartenbreite steht das Bild über dem Text. Ab etwa 240 px nutzbar, empfohlen ab 280 px (eine Einheit ab Tablet). Texte werden nie gekürzt.';
}
public function heights(): array
{
return [
'auto' => 'Natürliche Höhe',
'fill' => 'An die Zeile angleichen',
];
}
public function variants(): array
{
return [
'adaptive' => 'Anpassend (ab 520 px Bild neben Text)',
'stacked' => 'Bild immer über dem Text',
];
}
public function optionIcons(): array
{
return [
'variant' => ['adaptive' => 'heroicon-o-view-columns', 'stacked' => 'heroicon-o-bars-3-bottom-left'],
'height' => ['auto' => 'heroicon-o-arrows-pointing-in', 'fill' => 'heroicon-o-arrows-up-down'],
];
}
public function settings(): array
{
return [
'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'],
'show_summary' => self::SHOW,
'show_kind' => self::SHOW,
'show_meta' => self::SHOW,
'show_action' => self::SHOW,
];
}
public function settingLabels(): array
{
return [
'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).'],
'show_summary' => ['Kurzbeschreibung', 'Aus den Fachdaten. Vorgabe: anzeigen.'],
'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'],
'show_meta' => ['Zusatzangaben', '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.'],
];
}
public function dataRules(): array
{
return [
'action_label' => ['nullable', 'string', 'max:60'],
'note' => ['nullable', 'string', 'max:200'],
'alt' => ['nullable', 'string', 'max:300'],
'focus_x' => ['nullable', 'numeric', 'between:0,100'],
'focus_y' => ['nullable', 'numeric', 'between:0,100'],
];
}
public function refRules(): array
{
return [$this->refKey() => ['required', 'integer']] + ImageRefFields::rules();
}
public function dataFields(): array
{
return [
TextInput::make('action_label')
->label('Beschriftung der Aktion (optional)')
->maxLength(60)
->placeholder($this->defaultActionLabel())
->live(onBlur: true)
->helperText('Das Linkziel ist immer die öffentliche Seite des gewählten Objekts und kann nicht frei gesetzt werden.'),
TextInput::make('note')
->label('Hinweis (optional)')
->maxLength(200)
->live(onBlur: true)
->helperText('Kurzer redaktioneller Satz über der Aktion, zum Beispiel „Für die nächste Kursstunde“. Begründet keine Berechtigung.'),
PremiumFields::altField(),
...PremiumFields::focusFields(66, 45),
];
}
public function refFields(): array
{
return [$this->subjectField(), ...ImageRefFields::fields(live: true)];
}
public function editorSchema(): array
{
[$action, $note] = $this->dataFields();
return [
Group::make([$this->subjectField()])->statePath('refs'),
Group::make([$action, $note])->statePath('data'),
];
}
public function mediaSchema(): array
{
[, , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make(ImageRefFields::fields('Kartenbild', live: true))->statePath('refs'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
public function clean(array $data, array $refs, WidgetErrors $errors): array
{
$key = $this->refKey();
$id = (int) $refs[$key];
$rejection = $this->rejectSubject($id);
if ($rejection !== null) {
$errors->add("refs.$key", $rejection);
}
$refs[$key] = $id;
$refs = ImageRefFields::clean($refs, $errors);
foreach (['action_label', 'note', 'alt'] as $field) {
$data[$field] = filled($data[$field] ?? null) ? trim((string) $data[$field]) : null;
}
foreach (['focus_x', 'focus_y'] as $field) {
$value = $data[$field] ?? null;
$data[$field] = is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : null;
}
if ($refs['image'] !== null && $data['alt'] === null) {
$errors->add('data.alt', 'Bitte einen Alternativtext für das Bild angeben.');
}
return [$data, $refs];
}
public function resolve(array $widget, RenderContext $context): array
{
$settings = $widget['settings'];
$option = fn (string $key, string $default): string => is_string($settings[$key] ?? null) && isset($this->settingOptions()[$key][$settings[$key]]) ? $settings[$key] : $default;
$data = $widget['data'];
return [
'subject' => $this->subject($widget['refs'][$this->refKey()] ?? null, $context),
'cardStyle' => $this->cardStyle(),
'imageUrl' => PublicMedia::imageUrl($widget['refs']),
'alt' => is_string($data['alt'] ?? null) ? $data['alt'] : '',
'focus' => PremiumFields::focus($data, 66, 45),
'format' => $option('format', 'landscape'),
'fit' => $option('fit', 'cover'),
'headingTag' => $option('heading_level', 'h3'),
'show' => [
'summary' => $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',
],
'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(),
'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null,
'stacked' => $widget['variant'] === 'stacked',
];
}
public function mediaPaths(array $widget): array
{
$image = $widget['refs']['image'] ?? null;
return PublicMedia::isPublicPath($image) ? [$image] : [];
}
public function summary(array $widget): string
{
$label = $this->subjectLabel($widget['refs'][$this->refKey()] ?? null);
return $label ?? 'Kein Objekt gewählt';
}
private function subjectField(): Select
{
return Select::make($this->refKey())
->label($this->refLabel())
->helperText($this->refHelp())
->required()
->live()
->searchable()
->getSearchResultsUsing(fn (?string $search): array => $this->searchSubjects($search))
->getOptionLabelUsing(fn (mixed $value): ?string => $this->subjectLabel($value))
->options(fn (): array => $this->searchSubjects(null));
}
}
@@ -0,0 +1,100 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\Composition;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Modul- und Programmkarte (Kit v1.7 „catalog“): ein Programm oder Modul über PublicCatalogReader, dieselbe
* Freigaberegel wie die Programm- und Modulkarten (Programme öffentlich mit Programmseite, Module nur in der
* Redaktionsvorschau). Die Art ist immer sichtbar benannt. Ohne Bild trägt eine Navy-Tafel die Art.
* Kein Preis, kein Angebot, keine Kaufaktion; eine Karte ist kein Lizenzartikel.
*/
class ProgramCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'program_card';
}
public function label(): string
{
return 'Programm- oder Modulkarte';
}
public function description(): string
{
return 'Karte zu einem Programm oder Modul; Titel, Beschreibung und Art kommen aus den Fachdaten, ohne Preis und ohne Kaufaktion.';
}
public function icon(): string
{
return 'heroicon-o-academic-cap';
}
public function schematic(): array
{
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'ink'], [8, 24, 10, 2, 'accent'], [31, 8, 10, 2, 'line'], [31, 13, 22, 4, 'ink'], [31, 25, 14, 5, 'ink']];
}
public function settings(): array
{
// Die Art (Programm oder Modul) bleibt immer sichtbar; sie lässt sich nicht ausblenden.
$settings = parent::settings();
unset($settings['show_kind']);
return $settings;
}
protected function refKey(): string
{
return 'composition';
}
protected function refLabel(): string
{
return 'Programm oder Modul';
}
protected function refHelp(): string
{
return 'Nur zur Anzeige freigegebene Programme und Module sind wählbar. Öffentlich erscheinen Programme mit Programmseite; Module nur in der Redaktionsvorschau.';
}
protected function searchSubjects(?string $term): array
{
return app(PublicCatalogReader::class)->search($term);
}
protected function subjectLabel(mixed $id): ?string
{
return app(PublicCatalogReader::class)->labelFor($id);
}
protected function rejectSubject(int $id): ?string
{
$composition = Composition::query()->with('editorialContentKind')->find($id);
return $composition !== null && app(PublicCatalogReader::class)->isSelectable($composition)
? null
: 'Dieses Objekt ist kein zur Anzeige freigegebenes Programm oder Modul.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
return app(PublicCatalogReader::class)->subject($id, includeNonPublic: $context->preview);
}
protected function defaultActionLabel(): string
{
return 'Programm ansehen';
}
protected function cardStyle(): string
{
return 'catalog';
}
}
@@ -0,0 +1,115 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\Pillar;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Redaktionelle Themenkarte (Kit v1.7 „editorial“): ein veröffentlichtes Thema (Säule) mit Name,
* öffentlicher Kurzbeschreibung und Verweis auf die Themenseite /themen/{slug}. Ruhige Textaktion mit gelber
* Unterstreichung. Ein nicht (mehr) veröffentlichtes Thema erscheint öffentlich nicht.
*/
class TopicCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'topic_card';
}
public function label(): string
{
return 'Themenkarte';
}
public function description(): string
{
return 'Redaktionelle Karte zu einem veröffentlichten Thema; Name, Kurzbeschreibung und Ziel kommen aus dem Thema.';
}
public function icon(): string
{
return 'heroicon-o-bookmark-square';
}
public function schematic(): array
{
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'image'], [31, 8, 10, 2, 'accent'], [31, 13, 22, 4, 'ink'], [31, 20, 20, 3, 'line'], [31, 27, 12, 2, 'accent']];
}
protected function refKey(): string
{
return 'pillar';
}
protected function refLabel(): string
{
return 'Thema';
}
protected function refHelp(): string
{
return 'Nur veröffentlichte Themen sind wählbar. Name und Kurzbeschreibung pflegen Sie im Thema, nicht hier.';
}
protected function searchSubjects(?string $term): array
{
$term = trim((string) $term);
return Pillar::query()
->published()
->when($term !== '', fn ($query) => $query->whereRaw('LOWER(name) LIKE ?', ['%'.mb_strtolower($term).'%']))
->limit(25)
->get()
->mapWithKeys(fn (Pillar $pillar): array => [$pillar->id => $pillar->name.' · Thema'])
->all();
}
protected function subjectLabel(mixed $id): ?string
{
$pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null;
if ($pillar === null) {
return null;
}
return $pillar->name.' · Thema'.($pillar->published_at === null ? ' · nicht veröffentlicht' : '');
}
protected function rejectSubject(int $id): ?string
{
return Pillar::query()->whereKey($id)->whereNotNull('published_at')->exists()
? null
: 'Dieses Thema ist nicht veröffentlicht.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
$pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null;
if ($pillar === null || $pillar->published_at === null) {
return null;
}
return new CardSubject(
title: (string) $pillar->name,
summary: filled($pillar->public_summary) ? (string) $pillar->public_summary : null,
kind: 'Thema',
badge: null,
meta: [],
url: $pillar->publicUrl(),
public: true,
);
}
protected function defaultActionLabel(): string
{
return 'Thema entdecken';
}
protected function cardStyle(): string
{
return 'editorial';
}
}