# Theme-System – Architektur, Vorlagen-Vertrag, Übergabe Design Stand: 22.10.2026 · Basis-Theme: **„Ostsee-Licht“** (`resources/themes/ostsee-licht`) · Entscheidungen: `docs/KONZEPT.md` §4a > **Kurz:** Logik, Daten und Admin sind fertig und getestet. Ein Theme ist **nur Optik**: Blade-Vorlagen, CSS, ein wenig JS und Farb-Tokens. Für ein neues Design wird ausschließlich unter `resources/themes//` gearbeitet. > > **Neues Theme bauen:** verbindliche Schritt-für-Schritt-Anleitung in [THEME-ERSTELLUNG.md](THEME-ERSTELLUNG.md) (`themes:make`, `themes:check`, `themes:preview`). --- ## 1. Überblick ``` Anfrage ──► ResolveTheme (Middleware) │ Site per Domain (sonst Standard-Site) │ Erscheinungsbild per Datum (oder signierte Vorschau ?vorschau=) │ Theme-Kette: Theme → Eltern-Theme → Basis-Theme ⇒ View-Namespace "theme::" ▼ PageController ──► Seite (Admin › Webseite › Seiten) = Liste von Bausteinen │ └─ je Baustein: App\Themes\Sections\Section::data() → theme::sections. ▼ theme::page (@extends theme::layouts.app) ``` | Begriff | Wo | Was | |---|---|---| | **Site** | `sites`, Admin › System › Websites | Domain, Theme, Grundfarben, zugeordnete Wohnungen. Heute eine; weitere = weitere Vermieter mit eigener Domain. | | **Theme** | `resources/themes//` | Manifest `theme.json`, Vorlagen `views/`, `theme.css`, `theme.js` | | **Seite** | `pages`, Admin › Webseite › Seiten | Adresse, Menü (Haupt/Fuß/keins), SEO, **Bausteine** (Builder) | | **Baustein** (Section) | `app/Themes/Sections/*`, Katalog in `config/themes.php` | Admin-Formular + Datenaufbereitung; Darstellung: `theme::sections.` | | **Erscheinungsbild** (Appearance) | `appearances`, Admin › Webseite › Erscheinungsbilder | Jährlicher Zeitraum + Priorität; ersetzt Farben (Tokens), ausgewählte Texte, Banner; **Fotos gehören zu Erscheinungsbildern** (`photos.appearance_ids`, mehrere möglich, leer = ganzjährig) – **nicht** den Aufbau. Bausteine können auf Erscheinungsbilder beschränkt werden. Sonderangebote sind **unabhängig** davon (`OfferShowcase`) | Code: `app/Themes/` (Theme, ThemeFactory, ThemeRegistry, ThemeManifest, SectionRegistry, Sections/), `app/Http/Middleware/ResolveTheme.php`, `app/Http/Controllers/PageController.php`, `app/Providers/ThemeServiceProvider.php`. ## 2. Aufbau eines Themes ``` resources/themes/ostsee-licht/ ├── theme.json Manifest ├── theme.css Vite-Einstieg: @import 'tailwindcss' + theme-base.css + @source der Vorlagen ├── theme-base.css wiederverwendbar: Schriften, Token-Mapping, Basis-Klassen (Child-Themes importieren diese Datei) ├── theme.js kleine Verbesserungen (Lightbox, Suche) └── views/ ├── layouts/app.blade.php Grundgerüst: , Banner, Kopf, @yield('content'), Fuß, Lightbox ├── page.blade.php rendert die Bausteine einer Seite ├── partials/ header, footer, banner, image, mobile-booking-bar └── sections/.blade.php eine Vorlage je Baustein (siehe §5) ``` ### theme.json ```json { "key": "ostsee-licht", // eindeutig, = Ordnername empfohlen "name": "Ostsee-Licht", "version": "0.1.0", "parent": null, // Child-Theme: Key des Eltern-Themes "description": "…", "assets": { "css": "resources/themes/ostsee-licht/theme.css", "js": "resources/themes/ostsee-licht/theme.js" }, "tokens": { "accent": { "label": "Akzent", "default": "#2C5F7C" }, … } } ``` - **Vererbung:** Vorlagen, die ein Theme nicht hat, kommen vom Eltern-Theme, zuletzt vom Basis-Theme (`config('themes.base')`). Ein Child-Theme kann also mit einer einzigen Datei beginnen (z. B. nur `sections/hero.blade.php`). Hat ein Child-Theme keine eigenen `assets`, werden die des Eltern-Themes geladen – das reicht nur ohne eigene Vorlagen; sobald es Vorlagen gibt, braucht das Theme eigene `theme.css`/`theme.js` (sonst fehlen deren Tailwind-Klassen; `themes:check` meldet das). - **Neues Theme anlegen:** `php artisan themes:make ` (überschreibt nie etwas) → erscheint automatisch in Admin › System › Websites › Theme (mit „Vorschau“). `npm run build` baut alle Themes (`vite.config.js` liest die Ordner). Prüfen: `php artisan themes:check`; Vorschau-Links: `php artisan themes:preview ` (signiert, `?theme=` und optional `&vorschau=`). Details: [THEME-ERSTELLUNG.md](THEME-ERSTELLUNG.md). - **Plugins:** Ein Theme-Paket legt seinen Ordner unter einen Pfad aus `config('themes.paths')`. Themes werden **nie** über den Admin hochgeladen (Vorlagen sind ausführbarer Code). ## 3. Design-Tokens (Farben) - Definiert in `theme.json › tokens`; das Layout gibt sie als CSS-Variablen aus: `:root{--accent:#2C5F7C;…}`. - Reihenfolge: Theme-Standard → Site (Admin › Websites › Farben) → Erscheinungsbild (Admin › Erscheinungsbilder › Farben). Nur gültige Hex-Werte werden übernommen. - In `theme.css` sind die Tokens als Tailwind-Farben gemappt (`@theme inline`): `bg-ground`, `bg-surface`, `text-ink`, `text-muted`, `border-line`, `bg-accent`, `text-accent-ink`, `bg-band`, `text-band-ink`, `text-band-muted`, `bg-banner`, `text-banner-ink` – inkl. Deckkraft (`bg-accent/10`). - **Regel:** In Vorlagen keine festen Farben (`#…`, `text-blue-700`), immer Tokens – sonst funktionieren Saisons (z. B. dunkles Silvester) nicht. - Die Buchungs- und Bewertungsformulare (`resources/views/livewire/*.blade.php`) sind theme-neutral und nutzen nur diese Token-Klassen. - Neue Tokens: in `theme.json` ergänzen und in `theme.css › @theme inline` mappen; sie erscheinen automatisch als Farbfelder im Admin. ## 4. Was Layout und Vorlagen zur Verfügung haben `$theme` (`App\Themes\Theme`, im Layout via `app(\App\Themes\Theme::class)`, in Bausteinen als Variable): | Methode / Eigenschaft | Liefert | |---|---| | `$theme->site` | `Site` (Name, Locale, Einstellungen) | | `$theme->appearance` | aktuelles `Appearance` oder `null` | | `$theme->isPreview` | Vorschau-Modus (Layout setzt `noindex` und zeigt einen Hinweis) | | `$theme->appearanceKey()` | z. B. `weihnachten` – steht als `data-appearance` am ``; für saisonale CSS-Details nutzbar: `[data-appearance=silvester] .hero {…}` | | `$theme->text($key, $fallback)` | Text des Erscheinungsbilds oder Fallback (Schlüssel: `Appearance::OVERRIDABLE`) | | `$theme->banner()` | Das heute gezeigte Banner (`App\Themes\Banner`: `text`, `linkLabel`, `linkUrl`, `tone`) oder null | | `$theme->sharePhoto($sections)` | Vorschaubild beim Teilen und für Suchmaschinen: erstes zur Saison passendes Titelbild der Seite, sonst ein automatisches Foto der Wohnung | | `$theme->property()` | Hauptwohnung der Site | | `$theme->menu('main' \| 'footer')` | veröffentlichte Seiten des Menüs (`->url()`, `->label()`) | | `$theme->tokens()`, `cssVariables()`, `assets()` | für das Layout | Weitere Helfer: `@include('theme::partials.image', ['photo' => $photo, 'sizes' => '…', 'class' => '…', 'eager' => bool])` (responsives WebP mit `srcset` 640/1280/2048 px, Platzhalter wenn kein Bild), `\App\Support\Money::format($cents)`, `\App\Support\Content::get()/html()/photo()` (zentrale Texte, Admin › Texte), `route('booking.create')`, `route('home')`, `route('page', ['slug' => …])`. Layout-Variablen von `PageController`: `$title`, `$description`, `$ogImage`, `$structuredData` (JSON-LD), `$page`, `$sections`. Weitere Daten für `` per `@push('head')`. ## 5. Bausteinkatalog – Vertrag der Vorlagen Jede Vorlage `views/sections/.blade.php` bekommt **immer** `$theme` und `$sectionId` (eindeutige ID für `aria-labelledby`) und zusätzlich: | Key | Admin-Name | Variablen | |---|---|---| | `hero` | Titelbereich mit Suche | `$eyebrow`, `$title` (Text, `*Wort*` = Hervorhebung), `$text`, `$photo`, `$video` (`App\Models\Video`\|null: stumme Schleife statt des Fotos – `@include('theme::partials.video-loop', ['video' => $video, 'class' => …])`), `$freeStays` (Liste `arrival`, `departure` (CarbonImmutable), `nights`, `total` (Cent), `url` – `@include('theme::partials.free-stays')`), `$showSearch`, `$property`, `$featuredOffer` (`AdvertisedOffer`\|null: wichtigstes hervorgehobenes Angebot) – Suche als GET-Formular an `route('booking.create')` mit `anreise`, `abreise` (Y-m-d), `personen` | | `facts` | Eckdaten | `$heading`, `$property`, `$highlights` (Collection), `$fromPrice` (Cent\|null) | | `text_image` | Text mit Bildern | `$eyebrow`, `$heading`, `$text` (HtmlString\|null), `$photos` (≤3), `$imagePosition` (`left`\|`right`), `$linkLabel`, `$linkUrl` | | `gallery` | Bildergalerie | `$heading`, `$photos` – Lightbox: `` mit Vorschau-``. Das Foto wächst aus der Vorschau und schrumpft beim Schließen zurück; die Links eines Abschnitts bilden eine Reihe (Pfeile, Pfeiltasten, Wischen, „3 von 12“). Dialog: `partials/lightbox` | | `amenities` | Ausstattung | `$heading`, `$groups` (Bereich ⇒ Collection) | | `floor_plan` | Grundriss (interaktiv) | `$heading`, `$text`, `$photo` (Grundriss-Bild, `Photo`), `$rooms` (Collection von Arrays: `key` – Anker-ID, `name`, `description`, `hint` – Barrierefreiheit, `points` – „x,y x,y …“ in **Prozent** des Bildes → SVG `viewBox="0 0 100 100" preserveAspectRatio="none"` über dem Bild, `photos` – Collection, `amenities` – Collection). `videoChapter` – Kapitel eines Rundgang-Videos mit diesem Raum: `seconds`, `time`, `label` oder null → Link `