Zum Hauptinhalt springen

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.typoscript aus dem Site Set casablanca/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​

EinstellungTypStandardWirkung
settings.includeCssbool/int1Bindet widget.css auf Seiten mit Booking-Plugins ein. Setze 0, wenn das Sitepackage ein eigenes Stylesheet mitbringt. JavaScript wird immer geladen.
settings.appearancestringdefaultStandard-Layout-Stil für alle Plugins, sofern er nicht in FlexForm überschrieben wird. Werte: default, inherit, compact.
settings.windowDaysint90Standard der Vorausschau (Tage) für Kalender und Preise. Wird von FlexForm überschrieben.
settings.defaultAdultsint2Standardanzahl der Erwachsenen für Formulare und die Übergabe an die Booking Engine, wenn sie nicht in FlexForm gesetzt ist.
settings.defaultChildrenAgesstring(leer)Kommagetrennte Standard-Altersangaben der Kinder (z. B. 4,8). Ist das Feld leer, wird die Belegung des Backend-Moduls verwendet.
settings.languagestring(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:

EinstellungTypStandardCSS-Variable
settings.theme.accentstring(leer)--cb-accent
settings.theme.accentContraststring(leer)--cb-accent-contrast
settings.theme.radiusstring(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)​

EinstellungTypStandardWirkung
view.templateRootPathstring(leer)Zusätzlicher Fluid-Template-Root. Wird mit Priorität 10 mit dem Pfad der Extension (Priorität 0) zusammengeführt.
view.partialRootPathstring(leer)Zusätzlicher Fluid-Partial-Root.
view.layoutRootPathstring(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 SettingTypStandardEntspricht
casablancaBooking.includeCssbooltrueplugin.tx_casablancabooking.settings.includeCss
casablancaBooking.theme.accentstr''settings.theme.accent
casablancaBooking.theme.accentContraststr''settings.theme.accentContrast
casablancaBooking.theme.radiusstr''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:

  1. FlexForm defaultAdults, defaultChildren, defaultChildrenAges
  2. TypoScript settings.defaultAdults / defaultChildrenAges
  3. 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​


FunktionQuelleHinweise
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 KalenderAPI (synchronisiertes Abbild)bookable_nights pro Tag im Sync-Cache. Wird für die Anzeige von Restriktionen verwendet.
Filter in der Übersicht der PauschalenSynchronisierte API-Daten + TYPO3 FlexFormbookable_nights_with_packages aus dem Sync wird mit stayNights verglichen. Deaktivierbar mit filterByStayNights = 0.
Links zur Booking Engine bei Pauschalen / ZimmernTYPO3 FlexFormstayNights legt bei Packages die Standardnächte der Buchen-Buttons fest. Es erzwingt keinen Mindestaufenthalt.
Standarddaten der Search barTYPO3 (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.

→ Siehe Konfiguration
→ Siehe Theming