Files
laraundfelix/app/Domain/Cms/Widgets/WidgetRenderer.php
LarsandClaude Opus 5.5 9d936bfa4a
CI Feature / test (push) Successful in 31s
Führe eine zentrale Widget-Registry mit visuellem Seiteneditor ein.
- Codebasiertes Widget-Register (config/cms.php) mit Vertrag
  {id, type, v, variant, settings, data, refs}: Typkennung, Schemaversion,
  Prüfregeln, freigegebene Varianten, Editorfelder, Blade-Ansicht,
  Verweisauflösung und Medienliste je Widget-Art.
- Die sechs Bestandsbausteine bleiben als Version 1 lesbar; gespeicherte
  Revisionen werden nicht umgeschrieben, sondern beim Lesen angehoben
  (Bild und Text: Version 2 mit Titel, formatiertem Text, Bild links/rechts).
  Wiederherstellen kopiert eine Revision unverändert.
- Neue Widgets: Einstieg (Hero) und Programm-/Modulkarten. Letztere speichern
  nur Verweise; Titel und Kurzbeschreibung kommen aus den Fachdaten. Öffentlich
  erscheinen nur Programme mit Anzeigefreigabe (gleiche Regel wie /programme,
  jetzt in PublicCatalogReader); Module nur in der Redaktionsvorschau, bis
  öffentliche Profile (ADR-29) bestehen.
- Ein Renderer für öffentliche Seite, Vorschau und Blockvorschau im Editor.
- Seiteneditor als Filament-Builder: Auswahl mit Beschreibung und Schema,
  kompakte Abschnitte mit Vorschau, Bearbeitung im Dialog, Sortieren,
  Duplizieren. Speichern erzeugt nur einen Entwurf.
- Vorschau einer Revision in 390/768/1440 px; Vorschauroute nutzt den
  Personal-Guard (vorher war sie für Redakteure ohne Mitgliedersitzung
  nicht erreichbar).
- Basislayout in Komponenten (Marke, Kopf, Fuß, Seitenvorlage).
- Navigation: bearbeiten, ausblenden, löschen, per Ziehen sortieren;
  unsichere Adressen (javascript:) werden abgewiesen und nicht ausgegeben.
  Ergänzende Migration is_visible (Vorgabe sichtbar).
- Pfadfehler und doppelte Pfade erscheinen am Pfadfeld statt still zu scheitern.

Tests: BlockRegistryTest geht in WidgetRegistryTest auf (gleiche Prüfungen
plus Registrierung, Versionierung, Bereinigung). Bestandsseiten werden gegen
Textfixtures aus dem Stand vor der Umstellung geprüft.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 17:49:30 +01:00

79 lines
2.4 KiB
PHP

<?php
namespace App\Domain\Cms\Widgets;
use Illuminate\Support\HtmlString;
/**
* Einziger Darstellungsweg für Widgets: öffentliche Seite, ganzseitige Vorschau und Blockvorschau im Editor
* verwenden dieselbe Blade-Ansicht je Widget-Art.
*/
class WidgetRenderer
{
public function __construct(private readonly WidgetRegistry $registry) {}
/**
* @param array<int|string, mixed>|null $blocks gespeicherte Bausteine (Altformat oder Hülle)
*/
public function renderAll(?array $blocks, RenderContext $context): HtmlString
{
$html = '';
$position = 0;
foreach (array_values($blocks ?? []) as $block) {
if (! is_array($block)) {
continue;
}
$widget = $this->registry->upcast($block);
if ($widget === null) {
if ($context->preview) {
$html .= '<section class="block widget-unknown"><p class="preview-note">Unbekannter Baustein „'.e((string) ($block['type'] ?? '')).'“ wird öffentlich nicht angezeigt.</p></section>';
}
continue;
}
$rendered = $this->renderWidget($widget, $context, $position === 0);
if ($rendered !== '') {
$html .= $rendered;
$position++;
}
}
return new HtmlString($html);
}
/**
* Rendert eine Instanz samt Abschnittshülle. Liefert '' wenn das Widget nichts darzustellen hat.
*
* @param array<string, mixed> $widget aktuelle Hülle
*/
public function renderWidget(array $widget, RenderContext $context, bool $first = false): string
{
$type = $this->registry->get($widget['type']);
$inner = trim(view($type->view(), [
'widget' => $widget,
'data' => $widget['data'],
'refs' => $widget['refs'],
'variant' => $widget['variant'],
'settings' => $widget['settings'],
'first' => $first,
'context' => $context,
] + $type->resolve($widget, $context))->render());
if ($inner === '') {
return '';
}
$id = is_string($widget['id'] ?? null) ? ' id="abschnitt-'.e($widget['id']).'"' : '';
return '<section class="block widget widget-'.e(str_replace('_', '-', $widget['type'])).' widget-variant-'.e(str_replace('_', '-', $widget['variant'])).'"'.$id.'>'
.$inner
.'</section>';
}
}