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):
- Standard-CSS:
widget.csswird mit der Extension ausgeliefert und definiert alle--cb-*-Tokens und Komponentenregeln. - Site Settings / TypoScript: Die globalen Werte
theme.accent,theme.accentContrastundtheme.radiuswerden als Inline-Styles am Widget-Wrapper eingefügt (siehe Referenz). - FlexForm-Darstellung: Pro Inhaltselement
default,inheritodercompact(nur äußerer Rahmen, keine Farben). - Site-CSS-Overrides im Backend: CSS pro Site unter Tools → CASABLANCA Booking → Configuration → Theming, gespeichert im Datenbankfeld
theme_cssund als Inline-<style>in jedem Widget eingefügt (siehe Ebene 4). - Agentur-CSS: Überschreibe
--cb-*-Tokens im Stylesheet des Sitepackages. - 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
| Token | Standard | Verwendung |
|---|---|---|
--cb-font-family | inherit | Basisschrift für alle Widget-Texte |
--cb-radius | 6px | Buttons, Eingabefelder, Kalenderzellen |
--cb-card-radius | 8px | Zimmer-/Pauschalen-Karten, Detailbilder |
--cb-gap | 0.75rem | Abstände im Raster und zwischen Formularfeldern |
--cb-space | 1.25rem | Äußerer Innenabstand des Widgets (compact überschreibt ihn) |
--cb-border-color | #d9d9d9 | Widget-Rahmen, Eingabefelder, Zimmerblöcke |
Basisfarben
| Token | Standard | Verwendung |
|---|---|---|
--cb-bg | #ffffff | Widget-Hintergrund |
--cb-fg | #1a1a1a | Haupttext |
--cb-muted | #6b6b6b | Beschriftungen, Hinweise, Sekundärtext |
--cb-surface | #f3f3f3 | Hintergrund der Kalender-Seitenleiste |
--cb-input-bg | #ffffff | Formularfelder und Auswahllisten |
--cb-focus-ring | var(--cb-accent) | Fokusrahmen von Eingabefeldern |
--cb-error | #b42318 | Fehlermeldungen |
Akzent und Buttons
| Token | Standard | Verwendung |
|---|---|---|
--cb-accent | #8b1e1e | Primäre Markenfarbe (CASABLANCA-Rot) |
--cb-accent-contrast | #ffffff | Text auf Akzent-Buttons |
--cb-button-bg | var(--cb-accent) | Hintergrund des primären Buttons |
--cb-button-fg | var(--cb-accent-contrast) | Text des primären Buttons |
--cb-button-radius | var(--cb-radius) | Eckenradius der Buttons |
--cb-button-padding | 0.625rem 1.25rem | Innenabstand des primären Buttons |
Karten und Preise
| Token | Standard | Verwendung |
|---|---|---|
--cb-card-bg | var(--cb-bg) | Kartenhintergrund |
--cb-card-border | var(--cb-border-color) | Kartenrahmen |
--cb-card-shadow | 0 1px 3px rgba(0,0,0,0.06) | Schatten der Karte |
--cb-price-fg | var(--cb-accent) | Hervorgehobene Preise |
--cb-price-size | 1.375rem | Schriftgröße des Preises auf der Karte |
Verfügbarkeitsstatus im Kalender
| Token | Standard | Verwendung |
|---|---|---|
--cb-state-available-bg | #e9f5ea | Hintergrund verfügbarer Tage |
--cb-state-available-fg | #1f6a2a | Text verfügbarer Tage |
--cb-state-restricted-bg | #fff4d9 | Hintergrund eingeschränkter Tage |
--cb-state-restricted-fg | #8a5a00 | Text eingeschränkter Tage |
--cb-state-no-arrival-bg | #eceff3 | Hintergrund von Tagen ohne Anreise |
--cb-state-no-arrival-fg | #4a5568 | Text von Tagen ohne Anreise |
--cb-state-unavailable-bg | #f5e6e6 | Hintergrund nicht verfügbarer Tage |
--cb-state-unavailable-fg | #8a2a2a | Text nicht verfügbarer Tage |
Interaktion im Kalender
| Token | Standard | Verwendung |
|---|---|---|
--cb-stepper-bg | #e8e8e8 | Hintergrund der Zeile mit den Belegungs-Steppern |
--cb-stepper-btn-bg | #dddddd | Buttons +/- der Stepper |
--cb-selection-bg | #f5d547 | Hintergrund des gewählten Datumsbereichs |
--cb-selection-fg | #1a1a1a | Text des gewählten Datumsbereichs |
--cb-enquiry-bg | var(--cb-selection-bg) | Hintergrund des Anfrage-Buttons |
--cb-enquiry-fg | var(--cb-selection-fg) | Text des Anfrage-Buttons |
--cb-past-bg | #ececec | Hintergrund vergangener Tage |
--cb-past-fg | #aaaaaa | Text vergangener Tage |
--cb-past-mark | #bbbbbb | Durchstreichung vergangener Tage |
Seitenleiste mit Angebotsauswahl
| Token | Standard | Verwendung |
|---|---|---|
--cb-offer-bg | #ffffff | Hintergrund der Angebotszeile |
--cb-offer-border | #e2e2e2 | Rahmen der Angebotszeile |
--cb-offer-selected-bg | #fffbea | Hintergrund des gewählten Angebots |
--cb-offer-selected-border | #c9a900 | Rahmen des gewählten Angebots |
--cb-clear-bg | #ffffff | Hintergrund des Buttons zum Zurücksetzen des Datums |
--cb-clear-fg | #333333 | Symbol des Buttons zum Zurücksetzen des Datums |
--cb-clear-hover-bg | #f0f0f0 | Hover-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:
| Wert | Wirkung |
|---|---|
default | Karte mit Rahmen, Innenabstand und weißem Hintergrund (Standard) |
inherit | Transparenter Hintergrund, kein Rahmen, kein Innenabstand – fügt sich in das Seitenlayout ein |
compact | Reduziertes --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 auswidget.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.jsweiterhin geladen (Interaktivität des Kalenders, Belegungs-Stepper, Übergabe an die Booking Engine). - Muss dein Sitepackage alle benötigten
.cb-*-Klassen definieren oderwidget.csskopieren und die Tokens anpassen. - Gelten die Inline-Theme-Werte aus den Site Settings (
theme.accentusw.) weiterhin übercbThemeStyle.
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, stattwidget.cssdirekt 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
includeCssnur, 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-widgetnicht aus Fluid-Overrides. Die Tokens sind darauf begrenzt. - Forke
widget.cssnicht 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.