Referenz
Referenz zu TypoScript und Site Settings für plugin.tx_casablancabooking. Verwende diese Seite, wenn du die Extension global (Sitepackage oder Site Management) konfigurierst und nicht pro Inhaltselement über FlexForm.
Überblick
Je nach TYPO3-Version gibt es zwei Möglichkeiten zur Konfiguration:
- TYPO3 v12 – TypoScript-Konstanten im Template-Modul (
constants.typoscriptaus dem Site Setcasablanca/booking). - TYPO3 v13+ – Site Settings unter Site Management → Settings in der Kategorie CASABLANCA Booking (
settings.definitions.yaml).
FlexForm-Einstellungen pro Plugin überschreiben TypoScript-Standards, wenn beide existieren. Optionen einzelner Inhaltselemente stehen unter Inhaltselemente.
Einstellungen von plugin.tx_casablancabooking
Globale Plugin-Einstellungen
| Einstellung | Typ | Standard | Wirkung |
|---|---|---|---|
settings.includeCss | bool/int | 1 | Bindet widget.css auf Seiten mit Booking-Plugins ein. Setze 0, wenn das Sitepackage ein eigenes Stylesheet mitbringt. JavaScript wird immer geladen. |
settings.appearance | string | default | Standard-Layout-Stil für alle Plugins, sofern er nicht in FlexForm überschrieben wird. Werte: default, inherit, compact. |
settings.windowDays | int | 90 | Standard der Vorausschau (Tage) für Kalender und Preise. Wird von FlexForm überschrieben. |
settings.defaultAdults | int | 2 | Standardanzahl der Erwachsenen für Formulare und die Übergabe an die Booking Engine, wenn sie nicht in FlexForm gesetzt ist. |
settings.defaultChildrenAges | string | (leer) | Kommagetrennte Standard-Altersangaben der Kinder (z. B. 4,8). Ist das Feld leer, wird die Belegung des Backend-Moduls verwendet. |
settings.language | string | (leer) | Standard-Kulturcode der Booking Engine. Leer = Standard der Site / defaultCulture des Backends. |
Theme-Einstellungen (settings.theme)
Diese Werte werden als Inline-CSS-Custom-Properties am Widget-Wrapper ausgegeben:
| Einstellung | Typ | Standard | CSS-Variable |
|---|---|---|---|
settings.theme.accent | string | (leer) | --cb-accent |
settings.theme.accentContrast | string | (leer) | --cb-accent-contrast |
settings.theme.radius | string | (leer) | --cb-radius |
Lass die Theme-Werte leer, um die Standardwerte der Extension aus widget.css zu verwenden (Akzent #8b1e1e, Radius 6px). Erlaubt ist jeder gültige CSS-Farb- oder Längenwert (z. B. #0a6e5e, 4px, 0.25rem).
Das Feld Site CSS overrides (theme_css) im Backend-Modul wird nach den Inline-Theme-Werten aus TypoScript / Site Settings angewendet. Damit kannst du sie mit beliebigem CSS auf .cb-widget überschreiben oder erweitern. Siehe Theming, Ebene 4.
View-Pfade (plugin.tx_casablancabooking.view)
| Einstellung | Typ | Standard | Wirkung |
|---|---|---|---|
view.templateRootPath | string | (leer) | Zusätzlicher Fluid-Template-Root. Wird mit Priorität 10 mit dem Pfad der Extension (Priorität 0) zusammengeführt. |
view.partialRootPath | string | (leer) | Zusätzlicher Fluid-Partial-Root. |
view.layoutRootPath | string | (leer) | Zusätzlicher Fluid-Layout-Root. |
Beispiel – Templates aus einem Sitepackage überschreiben:
plugin.tx_casablancabooking.view {
templateRootPath = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Templates/
partialRootPath = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Partials/
layoutRootPath = EXT:my_sitepackage/Resources/Private/Extensions/CasablancaBooking/Layouts/
}
Site Settings (TYPO3 v13+)
Mit dem Site Set casablanca/booking erscheinen diese Einstellungen unter Site Management → Settings → CASABLANCA Booking:
| Schlüssel der Site Setting | Typ | Standard | Entspricht |
|---|---|---|---|
casablancaBooking.includeCss | bool | true | plugin.tx_casablancabooking.settings.includeCss |
casablancaBooking.theme.accent | str | '' | settings.theme.accent |
casablancaBooking.theme.accentContrast | str | '' | settings.theme.accentContrast |
casablancaBooking.theme.radius | str | '' | settings.theme.radius |
YAML-Beispiel in config/sites/main/settings.yaml:
casablancaBooking:
includeCss: true
theme:
accent: '#0a6e5e'
accentContrast: '#ffffff'
radius: '4px'
TypoScript-Konstanten (TYPO3 v12)
Die Konstanten sind in Configuration/Sets/CasablancaBooking/constants.typoscript definiert und erscheinen im Constants-Editor des Templates unter plugin.tx_casablancabooking:
plugin.tx_casablancabooking {
includeCss = 1
appearance = default
theme {
accent =
accentContrast =
radius =
}
view {
templateRootPath =
partialRootPath =
layoutRootPath =
}
}
Zuordnung im TypoScript-Setup
setup.typoscript verbindet die Konstanten mit den Plugin-Einstellungen:
plugin.tx_casablancabooking {
settings {
includeCss = {$plugin.tx_casablancabooking.includeCss}
appearance = {$plugin.tx_casablancabooking.appearance}
theme {
accent = {$plugin.tx_casablancabooking.theme.accent}
accentContrast = {$plugin.tx_casablancabooking.theme.accentContrast}
radius = {$plugin.tx_casablancabooking.theme.radius}
}
}
}
Brücke zu den Site Settings (v13+)
plugin.tx_casablancabooking.settings {
includeCss = {$casablancaBooking.includeCss}
theme {
accent = {$casablancaBooking.theme.accent}
accentContrast = {$casablancaBooking.theme.accentContrast}
radius = {$casablancaBooking.theme.radius}
}
}
Frontend-Assets
Unabhängig von includeCss registriert das Setup die Assets global:
page.includeCSS.casablancaBookingWidget = EXT:casablanca_booking/Resources/Public/Css/widget.css
page.includeJSFooter.casablancaBookingWidget = EXT:casablanca_booking/Resources/Public/JavaScript/widget.js
Zur Laufzeit steuert includeCss, ob das CSS tatsächlich über den AssetCollector (TYPO3 v12+) oder den PageRenderer eingebunden wird.
Belegungsstandards (Backend-Modul)
Die Standardbelegung für Widgets wird in dieser Reihenfolge ermittelt:
- FlexForm
defaultAdults,defaultChildren,defaultChildrenAges - TypoScript
settings.defaultAdults/defaultChildrenAges - Datensatz des Backend-Moduls (
default_adults,default_children_ages)
Die Belegung mehrerer Zimmer (Widget und Search bar) verwendet das FlexForm-Feld defaultRooms (1–5). Jedes Zimmer wiederholt die Standardwerte für Erwachsene und Kinder pro Zimmer.
Das Verhalten pro Plugin steht unter Inhaltselemente.
Aufenthaltsdauer: API oder TYPO3-Einstellungen
| Funktion | Quelle | Hinweise |
|---|---|---|
| Mindestaufenthalt im Kalender (Widget, Detailkalender) | CASABLANCA API (CalendarDates) | minLengthOfStay pro Tag, live über fetchCalendar. Wird in JS bei der Auswahl der Abreise durchgesetzt. Nicht in TYPO3 bearbeitbar. |
| Buchbare Nächte im Kalender | API (synchronisiertes Abbild) | bookable_nights pro Tag im Sync-Cache. Wird für die Anzeige von Restriktionen verwendet. |
| Filter in der Übersicht der Pauschalen | Synchronisierte API-Daten + TYPO3 FlexForm | bookable_nights_with_packages aus dem Sync wird mit stayNights verglichen. Deaktivierbar mit filterByStayNights = 0. |
| Links zur Booking Engine bei Pauschalen / Zimmern | TYPO3 FlexForm | stayNights legt bei Packages die Standardnächte der Buchen-Buttons fest. Es erzwingt keinen Mindestaufenthalt. |
| Standarddaten der Search bar | TYPO3 (fest: +7) | Nur im Formular. Die Booking Engine erhält die abgesendeten Daten. |
Pflege Regeln zur Aufenthaltsdauer an einer Stelle, nämlich in CASABLANCA. Das Kalender-Widget liest die Restriktionen automatisch aus der API. Der Filter der Pauschalen-Übersicht verwendet die synchronisierten Werte bookable_nights_with_packages. Deaktiviere filterByStayNights, wenn alle synchronisierten Pauschalen unabhängig vom FlexForm-Wert stayNights gelistet werden sollen.