Zum Hauptinhalt springen

Theming

Alle Frontend-Widgets verwenden ein gemeinsames Stylesheet, Resources/Public/Css/widget.css. Jedes visuelle Element hat das CSS-Präfix .cb-. Farben, Abstände und Typografie sind als CSS Custom Properties im Bereich .cb-widget definiert. So können Hotels und Agenturen das Design anpassen, ohne die Extension zu forken.

Diese Seite ist ein Theming-Kochbuch: Design-Tokens, Konfigurationsebenen, Darstellungsmodi und praktische Beispiele.

Überblick über die Architektur​


Das Theming wird in Ebenen angewendet (von niedrigster zu höchster Priorität):

  1. Standard-CSS: widget.css wird mit der Extension ausgeliefert und definiert alle --cb-*-Tokens und Komponentenregeln.
  2. Site Settings / TypoScript: Die globalen Werte theme.accent, theme.accentContrast und theme.radius werden als Inline-Styles am Widget-Wrapper eingefügt (siehe Referenz).
  3. FlexForm-Darstellung: Pro Inhaltselement default, inherit oder compact (nur äußerer Rahmen, keine Farben).
  4. Site-CSS-Overrides im Backend: CSS pro Site unter Tools → CASABLANCA Booking → Configuration → Theming, gespeichert im Datenbankfeld theme_css und als Inline-<style> in jedem Widget eingefügt (siehe Ebene 4).
  5. Agentur-CSS: Überschreibe --cb-*-Tokens im Stylesheet des Sitepackages.
  6. Fluid-Overrides: Ersetze Templates, Partials oder Layouts über plugin.tx_casablancabooking.view.*RootPaths.

JavaScript (widget.js) wird immer geladen. Das CSS lässt sich deaktivieren, wenn das Sitepackage ein eigenes Styling mitbringt (siehe Mitgeliefertes CSS deaktivieren).

CSS-Design-Tokens​


Alle Tokens sind in .cb-widget deklariert. Überschreibe sie in deinem Sitepackage, indem du sie auf die Widget-Klasse oder einen Seiten-Wrapper begrenzt:

.cb-widget {
--cb-accent: #0a6e5e;
--cb-accent-contrast: #ffffff;
}

Typografie und Layout​

TokenStandardVerwendung
--cb-font-familyinheritBasisschrift für alle Widget-Texte
--cb-radius6pxButtons, Eingabefelder, Kalenderzellen
--cb-card-radius8pxZimmer-/Pauschalen-Karten, Detailbilder
--cb-gap0.75remAbstände im Raster und zwischen Formularfeldern
--cb-space1.25remÄußerer Innenabstand des Widgets (compact überschreibt ihn)
--cb-border-color#d9d9d9Widget-Rahmen, Eingabefelder, Zimmerblöcke

Basisfarben​

TokenStandardVerwendung
--cb-bg#ffffffWidget-Hintergrund
--cb-fg#1a1a1aHaupttext
--cb-muted#6b6b6bBeschriftungen, Hinweise, Sekundärtext
--cb-surface#f3f3f3Hintergrund der Kalender-Seitenleiste
--cb-input-bg#ffffffFormularfelder und Auswahllisten
--cb-focus-ringvar(--cb-accent)Fokusrahmen von Eingabefeldern
--cb-error#b42318Fehlermeldungen

Akzent und Buttons​

TokenStandardVerwendung
--cb-accent#8b1e1ePrimäre Markenfarbe (CASABLANCA-Rot)
--cb-accent-contrast#ffffffText auf Akzent-Buttons
--cb-button-bgvar(--cb-accent)Hintergrund des primären Buttons
--cb-button-fgvar(--cb-accent-contrast)Text des primären Buttons
--cb-button-radiusvar(--cb-radius)Eckenradius der Buttons
--cb-button-padding0.625rem 1.25remInnenabstand des primären Buttons

Karten und Preise​

TokenStandardVerwendung
--cb-card-bgvar(--cb-bg)Kartenhintergrund
--cb-card-bordervar(--cb-border-color)Kartenrahmen
--cb-card-shadow0 1px 3px rgba(0,0,0,0.06)Schatten der Karte
--cb-price-fgvar(--cb-accent)Hervorgehobene Preise
--cb-price-size1.375remSchriftgröße des Preises auf der Karte

Verfügbarkeitsstatus im Kalender​

TokenStandardVerwendung
--cb-state-available-bg#e9f5eaHintergrund verfügbarer Tage
--cb-state-available-fg#1f6a2aText verfügbarer Tage
--cb-state-restricted-bg#fff4d9Hintergrund eingeschränkter Tage
--cb-state-restricted-fg#8a5a00Text eingeschränkter Tage
--cb-state-no-arrival-bg#eceff3Hintergrund von Tagen ohne Anreise
--cb-state-no-arrival-fg#4a5568Text von Tagen ohne Anreise
--cb-state-unavailable-bg#f5e6e6Hintergrund nicht verfügbarer Tage
--cb-state-unavailable-fg#8a2a2aText nicht verfügbarer Tage

Interaktion im Kalender​

TokenStandardVerwendung
--cb-stepper-bg#e8e8e8Hintergrund der Zeile mit den Belegungs-Steppern
--cb-stepper-btn-bg#ddddddButtons +/- der Stepper
--cb-selection-bg#f5d547Hintergrund des gewählten Datumsbereichs
--cb-selection-fg#1a1a1aText des gewählten Datumsbereichs
--cb-enquiry-bgvar(--cb-selection-bg)Hintergrund des Anfrage-Buttons
--cb-enquiry-fgvar(--cb-selection-fg)Text des Anfrage-Buttons
--cb-past-bg#ecececHintergrund vergangener Tage
--cb-past-fg#aaaaaaText vergangener Tage
--cb-past-mark#bbbbbbDurchstreichung vergangener Tage

Seitenleiste mit Angebotsauswahl​

TokenStandardVerwendung
--cb-offer-bg#ffffffHintergrund der Angebotszeile
--cb-offer-border#e2e2e2Rahmen der Angebotszeile
--cb-offer-selected-bg#fffbeaHintergrund des gewählten Angebots
--cb-offer-selected-border#c9a900Rahmen des gewählten Angebots
--cb-clear-bg#ffffffHintergrund des Buttons zum Zurücksetzen des Datums
--cb-clear-fg#333333Symbol des Buttons zum Zurücksetzen des Datums
--cb-clear-hover-bg#f0f0f0Hover-Hintergrund des Buttons zum Zurücksetzen

Konfigurationsebenen im Detail​


Ebene 1: Standard-CSS​

Die Extension registriert widget.css automatisch, sofern es nicht deaktiviert ist. Die Datei definiert jedes --cb-*-Token und alle .cb-*-Komponentenklassen. Du musst sie nicht kopieren, überschreibe stattdessen die Tokens.

Ebene 2: Site Settings (TYPO3 v13+)​

Ist das Site Set casablanca/booking aktiv, konfigurierst du globale Theme-Werte unter Site Management → Settings → CASABLANCA Booking:

  • Accent color → --cb-accent
  • Accent contrast color → --cb-accent-contrast
  • Border radius → --cb-radius

Diese Werte werden als Inline-style-Attribute am <section>-Wrapper des Widgets ausgegeben. Die vollständige Tabelle der Einstellungen steht in der Referenz.

Ebene 3: FlexForm-Darstellung​

Jedes Inhaltselement hat einen Reiter Appearance mit Layout style:

WertWirkung
defaultKarte mit Rahmen, Innenabstand und weißem Hintergrund (Standard)
inheritTransparenter Hintergrund, kein Rahmen, kein Innenabstand – fügt sich in das Seitenlayout ein
compactReduziertes --cb-gap (0.5rem) und --cb-space (0.75rem)

Die Darstellung betrifft nur den äußeren Rahmen. Sie ändert keine Farben. Verwende inherit in Kopf- und Fußbereichen, in denen das Sitepackage schon einen gestalteten Container liefert. Verwende compact in Seitenleisten oder schmalen Spalten.

Ebene 4: Site-CSS-Overrides im Backend​

Seit Version 1.0.5 der Extension enthält Tools → CASABLANCA Booking → Configuration ein Fieldset Theming:

  • Eine einklappbare Referenztabelle aller --cb-*-Tokens mit ihren mitgelieferten Standardwerten aus widget.css.
  • Ein Textfeld Site CSS overrides, das pro Site-Konfiguration gespeichert wird (Datenbankfeld theme_css).

Praktisch für Agenturen ohne Deploy-Zugriff auf das Sitepackage. Ergänzt die TypoScript-Einstellungen theme.*. Bei einer Multi-Site-Installation kann jede TYPO3-Site eigene Overrides haben.

Das CSS wird als Inline-<style>-Block in jedem Widget-<section> ausgegeben (siehe Resources/Private/Layouts/Default.html). Begrenze die Regeln auf .cb-widget, damit sie nicht auf den Rest der Seite wirken. Gefährliche Fragmente (</style, <script) werden vor der Ausgabe entfernt.

Beispiel (entspricht dem Platzhalter im Backend):

.cb-widget {
--cb-accent: #006633;
--cb-radius: 4px;
}

Unter den Ebenen der Extension haben die Backend-Overrides die höchste Priorität: Sie werden nach widget.css und nach den Inline-Theme-Werten aus TypoScript / Site Settings (cbThemeStyle) angewendet. CSS aus dem Sitepackage kann trotzdem gewinnen, wenn es später auf der Seite geladen wird. Siehe auch Konfiguration.

Ebene 5: Agentur-CSS​

Ergänze Overrides im Stylesheet des Sitepackages nach dem CSS der Extension (oder mit includeCss = 0 und einer eigenen Kopie der Regeln):

/* Booking-Widgets auf der ganzen Website im Branding des Hotels */
.cb-widget {
--cb-accent: #0a6e5e;
--cb-accent-contrast: #ffffff;
--cb-radius: 4px;
--cb-card-radius: 4px;
--cb-font-family: "Source Sans 3", sans-serif;
}
/* Sekundäre Buttons verwenden den Akzent bereits über .cb-button--secondary */
.cb-button--secondary {
--cb-button-bg: transparent;
}

Ebene 6: Fluid-Overrides​

Verweise mit TypoScript auf Pfade in deinem Sitepackage:

plugin.tx_casablancabooking.view {
templateRootPaths.20 = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Templates/
partialRootPaths.20 = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Partials/
layoutRootPaths.20 = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Layouts/
}

Das Standardlayout umschließt den Inhalt mit:

<section class="{cbWidgetClasses}" style="{cbThemeStyle}" ...>

Kopiere Resources/Private/Layouts/Default.html als Ausgangspunkt.

Mitgeliefertes CSS deaktivieren (includeCss = 0)​


Setze includeCss auf 0 (bzw. false in den Site Settings), wenn dein Sitepackage ein vollständiges Ersatz-Stylesheet mitbringt:

TypoScript (Constants-Modul in v12):

plugin.tx_casablancabooking.includeCss = 0

Site Settings (ab v13):

Deaktiviere im Site-Editor Include default widget CSS oder setze in der settings.yaml:

casablancaBooking:
includeCss: false

Ist includeCss deaktiviert:

  • Wird widget.js weiterhin geladen (Interaktivität des Kalenders, Belegungs-Stepper, Übergabe an die Booking Engine).
  • Muss dein Sitepackage alle benötigten .cb-*-Klassen definieren oder widget.css kopieren und die Tokens anpassen.
  • Gelten die Inline-Theme-Werte aus den Site Settings (theme.accent usw.) weiterhin über cbThemeStyle.

Overrides pro Site im Backend​

Das Fieldset Theming, die Speicherung in theme_css und die CSS-Priorität stehen unter Ebene 4. Agenturen können Tokens weiterhin im Sitepackage überschreiben oder das mitgelieferte CSS vollständig deaktivieren (includeCss = 0).

Beispiele​


Markenfarben des Hotels​

.cb-widget {
--cb-accent: #2c5282;
--cb-accent-contrast: #ffffff;
--cb-price-fg: #2c5282;
--cb-button-bg: var(--cb-accent);
}

Flaches Design (keine Schatten, eckige Ecken)​

.cb-widget {
--cb-radius: 0;
--cb-card-radius: 0;
--cb-card-shadow: none;
}

Dunkle Suchleiste im Seitenkopf (Darstellung inherit)​

Stelle im Inhaltselement Search bar den Layout style auf Inherit. Gestalte dann den übergeordneten Container im Sitepackage:

.site-header .cb-widget--inherit {
--cb-fg: #ffffff;
--cb-muted: rgba(255, 255, 255, 0.7);
--cb-input-bg: rgba(255, 255, 255, 0.1);
--cb-border-color: rgba(255, 255, 255, 0.3);
}

Nur Akzentfarbe über TypoScript (keine eigene CSS-Datei)​

plugin.tx_casablancabooking.theme {
accent = #0a6e5e
accentContrast = #ffffff
radius = 4px
}

Do's und Don'ts​


Do

  • Überschreibe die --cb-*-Tokens, statt widget.css direkt zu bearbeiten.
  • Verwende das Präfix .cb- für eigene Selektoren, die auf Widget-Interna zielen.
  • Stelle Layout style → Inherit ein, wenn du Widgets in einen bereits gestalteten Seitenkopf oder Hero-Bereich einbettest.
  • Deaktiviere includeCss nur, wenn dein Sitepackage gleichwertige .cb-*-Regeln bereitstellt.
  • Teste die Kalenderfarben (verfügbar, eingeschränkt, nicht verfügbar) nach dem Ändern der Akzentfarben. Sie verwenden eigene Status-Tokens.

Don't

  • Entferne die Klasse cb-widget nicht aus Fluid-Overrides. Die Tokens sind darauf begrenzt.
  • Forke widget.css nicht allein wegen einer Farbänderung. Overrides der Tokens genügen.
  • Verlasse dich nicht auf Klassennamen ohne Präfix (button, card). Sie werden nicht verwendet.
  • Deaktiviere JavaScript nicht. Kalender, Belegung mehrerer Zimmer und Links in neuen Tabs zur Booking Engine brauchen widget.js.
  • Erwarte nicht, dass der FlexForm-Layout style Farben ändert. Verwende dafür Site Settings oder Agentur-CSS.

→ Siehe Konfiguration
→ Siehe Referenz