Inhaltselemente
Füge die Inhaltselemente über Create new content → Plugins ein. Es stehen fünf Plugins zur Verfügung. Jedes ersetzt ein bisheriges JavaScript-Widget von CASABLANCA durch serverseitig gerendertes HTML (SSR), Abfragen im lokalen ARI-Cache und eine PCI-sichere Weiterleitung zur Booking Engine.
Voraussetzungen
Damit die Inhaltselemente im Frontend echte Daten zeigen, müssen diese Punkte erfüllt sein:
- Backend-Konfiguration: Speichere die Zugangsdaten unter Tools → CASABLANCA Booking für den Identifier der aktuellen TYPO3-Site.
- Sync: Führe Sync now aus (oder warte auf den Scheduler), damit Zimmertypen, Raten und Verfügbarkeiten lokal zwischengespeichert sind.
- Site Sets: Die
config.yamlder Site musscasablanca/booking(und üblicherweisetypo3/fluid-styled-content) enthalten, damit TypoScript und Assets geladen werden.
Fehlt die Konfiguration, zeigen die Plugins eine freundliche Meldung not configured. Ein 503 Oops, an error occurred im Frontend deutet meist auf einen PHP-Fehler hin. Prüfe dann var/log/ und leere die Caches nach einem Update der Extension.
Gemeinsame Einstellungen im Reiter General
Die meisten Plugins teilen sich Felder im FlexForm-Reiter General. Konfiguriere sie einmal pro Inhaltselement. Die Standardwerte stammen aus TypoScript und dem Backend-Modul (siehe Referenz).
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.defaultRooms | int | 1 | Vorausgewählte Zimmeranzahl (1–5) für Mehrzimmer-Formulare. Jedes Zimmer hat eigene Felder für Erwachsene und Kinder. Nur Widget und Search Bar. |
settings.defaultAdults | int | 2 | Standardanzahl der Erwachsenen pro Zimmer (1–10). Füllt Formulare vor (Widget, Search Bar) bzw. wird bei der Übergabe an die Booking Engine verwendet (Room Types, Packages). |
settings.defaultChildren | int | 0 | Standardanzahl der Kinder pro Zimmer (0–10). Bei 0 werden die Eingabefelder für das Kinderalter in Formularen ausgeblendet. Nur Widget und Search Bar. |
settings.defaultChildrenAges | string | (leer) | Kommagetrennte Altersangaben (z. B. 4,8). Wird verwendet, wenn Kinder > 0. Fehlende Altersangaben werden mit 0 aufgefüllt. |
settings.language | select | Auto | Kultur der Booking Engine bei der Übergabe: de, en, it, fr oder Auto (Standard der Site). |
settings.ibeLinkTarget | select | _self | _self = gleiches Fenster, _blank = neuer Tab (erfordert JavaScript). Der Formular-Fallback öffnet immer im gleichen Fenster. |
settings.windowDays | int | 90 | Vorausschau in Tagen (7–180) für die Kalenderanzeige oder die Ermittlung des Ab-Preises. |
settings.appearance | select | default | Layout-Stil: default, inherit, compact. Siehe Theming. |
Reiter Texts (für Redakteure)
Jedes Plugin hat einen FlexForm-Reiter Texts für die Überschrift und die Beschriftung der wichtigsten Buttons (Call-to-Action). Leer = Standardübersetzung für die aktuelle Sprache der Site (aus locallang.xlf). Beschriftungen für die Belegung (Adults, Children), die Legende, Lademeldungen und Fehler sind keine FlexForm-Felder, siehe Lokalisierung.
Ein eigener FlexForm-Text gilt für alle Sprachversionen dieses Inhaltselements (langDisable = 1). Für Formulierungen pro Sprache verwendest du XLF oder TypoScript _LOCAL_LANG.
Availability calendar (Widget)
Plugin-Key: casablancabooking_widget
Ersetzt: Buchbarkeitskalender (bisheriges JS-Widget)
Zweck
Vollständiger Verfügbarkeitskalender mit Monatsraster, Preisen pro Tag, Auswahl eines Datumsbereichs, Seitenleiste für die Belegung mehrerer Zimmer, optionaler Angebotsauswahl und Übergabe an die Booking Engine. Die Daten werden bei Bedarf live aus der CASABLANCA-API geladen. Der lokale Sync-Cache liefert die SSR-Startdaten und das JSON-LD für SEO.
Typische Platzierung
- Eigene Buchungsseite
- Landingpages einzelner Zimmer (mit Vorauswahl des Zimmers)
- Eingebetteter Detailkalender auf Zimmerseiten (über das Plugin Room Types)
Reiter General (spezifisch für das Widget)
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.preselectRoomCategory | select | (keiner) | Beschränkt den Kalender auf einen Zimmertyp. Die Optionen werden nach dem Sync befüllt. Praktisch für zimmerspezifische Landingpages. |
settings.calendarInitialMonths | select | 1 | Beim ersten Laden sichtbare Monate: nur der aktuelle Monat (1) oder aktueller plus nächster Monat (2). Weitere Monate werden über die Navigation geladen. |
settings.calendarOfferMode | select | none | Angebote, die nach der Datumsauswahl angezeigt werden: none, rates_only, packages_only, packages_and_rates |
settings.showEnquiryButton | checkbox | 0 | Zeigt neben dem Buchen-Button einen Anfrage-Button. Erfordert enquiryUrl. |
settings.enquiryUrl | string | (leer) | Ziel-URL des Anfrage-Buttons (Kontaktformular, Anfrageseite). |
settings.enquiryLinkTarget | select | _self | _self oder _blank für den Anfrage-Link. |
Die Untertitel der Angebote in der Seitenleiste nennen die Verpflegungsart, wenn die synchronisierte Rate eine liefert (aus dem API-Feld cateringType). Leere Werte oder Undefined werden weggelassen.
Dazu kommen alle gemeinsamen Einstellungen im Reiter General. windowDays heißt hier Calendar window (days).
Reiter Texts:
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.labels.heading | string | (leer) | Überschrift des Kalenders. Leer = widget.heading.default oder Zimmername. |
settings.labels.bookNow | string | (leer) | Buchen-Button. Leer = widget.calendar.bookNow. |
settings.labels.enquiry | string | (leer) | Anfrage-Button. Leer = widget.calendar.enquiry. |
Belegung (Widget)
- Unterstützt 1–5 Zimmer über
defaultRooms. - Jedes Zimmer hat eigene Angaben für Erwachsene, Kinder und das Alter jedes Kindes.
- JavaScript-Stepper in der Seitenleiste des Kalenders erlauben eine Anpassung in Echtzeit.
- Beim Absenden wird die Belegung als
rooms_N__adults,rooms_N__childrenund Alters-Parameter an die Booking Engine übergeben. - Ist ein Zimmertyp vorausgewählt, wird die Belegung auf die
maxOccupancydieses Zimmers aus dem synchronisierten Abbild begrenzt.
Datumsauswahl und Mindestaufenthalt (Widget)
Der Verfügbarkeitskalender lädt live Datumsdaten aus der CASABLANCA-API (CalendarDates). Jeder Tag enthält den minLengthOfStay aus der Booking Engine. Das ist keine FlexForm-Einstellung von TYPO3.
Wählt ein Gast einen Anreisetag, speichert das Widget den minLengthOfStay dieses Tages. Würde der Klick auf den Abreisetag zu weniger Nächten führen, erweitert JavaScript den Bereich auf den erlaubten Mindestaufenthalt (siehe pickToDate / data-cb-min-stay in widget.js). Beispiel: Anreise mit Mindestaufenthalt 4 und ein Klick auf eine Abreise 2 Nächte später → es werden 4 Nächte gewählt.
Tage mit minLengthOfStay > 1 erscheinen in der Legende Restrictions apply. Es gibt keine Einstellung für Redakteure, um den Mindestaufenthalt im Widget zu überschreiben. Ändere die Restriktionen in CASABLANCA (PMS / Ratenregeln) und synchronisiere erneut oder warte, bis der Live-Kalender die Änderungen übernimmt.
Die Search bar verwendet einen eigenen Standard: Ändert sich die Anreise, wird die Abreise automatisch auf Anreise + 7 Nächte gesetzt (nur zur Erleichterung im Formular). Kalender-Widgets verwenden immer den minLengthOfStay der API pro Anreisetag.
Search bar
Plugin-Key: casablancabooking_searchbar
Ersetzt: Header-Buchungssnippet (Header booking snippet)
Zweck
Kompaktes Formular für Anreise, Abreise und Belegung ohne Kalenderraster. Es sendet per HTTP-303-Weiterleitung direkt an die Booking Engine. Ideal für Seitenköpfe, Hero-Bereiche und fixierte Buchungsleisten.
Typische Platzierung
- Seitenkopf / Navigationsleiste
- Hero-Bereich der Startseite
- Buchungssnippet in der Seitenleiste
FlexForm-Einstellungen
Es gelten die gemeinsamen Einstellungen im Reiter General, außer:
- kein
windowDays(kein Kalender) - keine Vorauswahl eines Zimmers
- keine Optionen für Kalender, Angebote oder Anfrage
Reiter Appearance: settings.appearance (default / inherit / compact). Verwende inherit in Seitenköpfen, siehe Theming.
Reiter Texts: settings.labels.heading (leer = searchbar.heading), settings.labels.submit (leer = searchbar.submit).
Kompakte Belegung: settings.compactOccupancy (Checkbox, Standard an). Ist sie aktiv, zeigt das Frontend eine Zeile: Anreise, Abreise, Gäste-Symbol und Suchen-Button. Zimmer, Erwachsene und Kinder erscheinen in einem einklappbaren Bereich darunter, sobald der Redakteur oder der Gast auf das Symbol klickt. Deaktiviere die Option, um das bisherige Layout mit allen Belegungsfeldern im Formularraster beizubehalten.
Belegung (Search bar)
Das gleiche Mehrzimmer-Modell wie beim Widget (defaultRooms, Erwachsene, Kinder und Alter pro Zimmer). Standarddaten: Anreise = heute + 2 Tage, Abreise = Anreise + 7 Nächte.
Room types
Plugin-Key: casablancabooking_roomtypes
Ersetzt: Zimmertypen-Widget
Zweck
Zimmertyp-Karten mit synchronisiertem Namen, Beschreibung, Bild und Ab-Preis. Unterstützt eine Übersicht (Raster) und einen Detailmodus (einzelnes Zimmer über den Slug in der URL). Auf Detailseiten ist optional ein Verfügbarkeitskalender eingebettet.
Typische Platzierung
- Übersicht: Seite mit der Liste der Zimmer
- Detail: eigene Zimmer-Detailseite (eine Plugin-Instanz, Slug aus der URL)
Reiter General (spezifisch für Room types)
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.filterRoomType | select | (alle) | Zeigt in der Übersicht nur ein Zimmer. |
settings.stayNights | int | 7 | Standardaufenthalt für Buchen-Links zur Booking Engine (Anreise + N Nächte). Bereich 1–30. |
Dazu kommen windowDays, defaultAdults, defaultChildren und language aus den gemeinsamen Einstellungen (die Anzahl der Kinder wird nur für die Übergabe an die Booking Engine verwendet).
Reiter Texts (Übersicht): settings.labels.heading (leer = roomtypes.heading), settings.labels.book (leer = roomtypes.book), settings.labels.details (leer = roomtypes.details).
Reiter Display
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.displayMode | select | overview | overview = Kartenraster, detail = einzelnes Zimmer aus dem Slug in der URL. |
settings.showName | checkbox | 1 | Zeigt den Zimmernamen auf Karten bzw. in der Detailansicht. |
settings.showDescription | checkbox | 1 | Zeigt die Zimmerbeschreibung. |
settings.overviewDescriptionMode | select | teaser | Nur Übersicht: kurzer Teaser oder gekürzte vollständige Beschreibung mit More-Steuerelement. |
settings.overviewDescriptionLimit | int | 250 | Zeichenlimit für den vollständigen Text in der Übersicht. |
settings.overviewLayout | select | grid | Kartenlayout der Übersicht: grid oder list. |
settings.showPrice | checkbox | 1 | Zeigt den Ab-Preis (günstigster Preis im Zeitfenster). |
settings.showImage | checkbox | 1 | Zeigt das Zimmerbild. |
settings.cardLinkType | select | book | Nur Übersicht: book = direkt zur Booking Engine, details = Link zur TYPO3-Detailseite. |
settings.detailPageUid | page | (keine) | Zielseite für Details-Links. Muss dieses Plugin im Detailmodus enthalten. |
settings.showDetailCalendar | checkbox | 0 | Bettet auf Detailseiten den Buchungskalender ein. |
settings.detailCalendarPosition | select | below | Kalender oberhalb oder unterhalb des Detailinhalts. |
settings.detailCalendarInitialMonths | select | 1 | Sichtbare Monate des Detailkalenders. |
settings.detailCalendarOfferMode | select | rates_only | Angebote nach der Datumsauswahl: none oder rates_only (Raten dieses Zimmers). |
Dazu kommen settings.ibeLinkTarget und settings.appearance.
Anzeigemodi
Übersichtsmodus
- Zeigt ein responsives Kartenraster aller synchronisierten Zimmertypen.
- Die Karten verlinken je nach
cardLinkTypezur Booking Engine (book) oder zur Detailseite (details). - Der Ab-Preis verwendet die Vorausschau
windowDaysaus dem lokalen Verfügbarkeits-Cache.
Detailmodus
- Ein einzelnes Zimmer, das über das URL-Argument
roomSluggewählt wird. - Bildkarussell (bei mehreren Bildern), vollständige Beschreibung, Preis und Buchen-Button.
- Optional ein eingebetteter Kalender mit derselben Farblegende wie das Verfügbarkeits-Widget.
Optionen für den Detailkalender
Ist showDetailCalendar auf einer Detailseite aktiviert:
- Zeigt der Kalender die Farblegende (verfügbar, eingeschränkt, keine Anreise, nicht verfügbar).
- Ist der Kalender auf den aktuellen Zimmertyp beschränkt.
- Steuert
detailCalendarPositiondie Position (oberhalb/unterhalb des Inhalts). - Legt
detailCalendarInitialMonthsfest, ob anfangs 1 oder 2 Monate sichtbar sind. - Zeigt
detailCalendarOfferModenach der Datumsauswahl die Standardraten dieses Zimmers an oder nur die Daten (none).
Route Enhancer (Room types)
Für sprechende URLs brauchst du einen Extbase Route Enhancer. Kopiere ihn aus Configuration/SiteConfiguration/RouteEnhancer.yaml.example:
routeEnhancers:
CasablancaRoomDetail:
type: Extbase
extension: CasablancaBooking
plugin: RoomTypes
limitToPages:
- 123 # UID deiner Zimmer-Detailseite
routes:
- routePath: '/{roomSlug}'
_controller: 'RoomTypes::show'
_arguments:
roomSlug: roomSlug
defaultController: 'RoomTypes::show'
aspects:
roomSlug:
type: CasablancaRoomSlug
Beide URL-Formate werden unterstützt:
- Sprechender Pfad:
/room-detail/double-room - Query-Fallback:
/room-detail?tx_casablancabooking_roomtypes[roomSlug]=double-room
Führe nach einem Upgrade einen Sync aus, damit die Zimmer-Slugs im lokalen Abbild erzeugt werden.
Packages
Plugin-Key: casablancabooking_packages
Ersetzt: Pauschalen-Widget
Zweck
Pauschalen-Karten aus dem synchronisierten Raten-Abbild. Der Übersichtsmodus kann optional nach der buchbaren Aufenthaltsdauer filtern (stayNights + filterByStayNights). Der Detailmodus zeigt eine Pauschale mit optional eingebettetem Kalender.
Typische Platzierung
- Übersicht: Seite mit der Liste der Pauschalen bzw. Angebote
- Detail: eigene Pauschalen-Detailseite
Reiter General (spezifisch für Packages)
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.filterPackage | select | (alle) | Zeigt in der Übersicht nur eine Pauschale. (alle) hebt die Filterung nach Aufenthaltsdauer nicht auf, siehe unten. |
settings.stayNights | int | 7 | Standardaufenthalt für Buchen-Links zur Booking Engine und für die Nächte-Angabe auf den Karten. Ist die Filterung nach Aufenthaltsdauer aktiv, listet die Übersicht nur Pauschalen, die für diese Dauer buchbar sind. |
settings.filterByStayNights | check | an | Ist sie an, zeigt die Übersicht nur Pauschalen, die für stayNights buchbar sind. Ist sie aus, werden alle synchronisierten Pauschalen gelistet (filterPackage gilt weiterhin). |
Dazu kommen windowDays, defaultAdults und language (das FlexForm von Packages hat keine Anzahl der Kinder).
Reiter Texts (Übersicht): settings.labels.heading (leer = packages.heading), settings.labels.book (leer = packages.book), settings.labels.details (leer = packages.details).
Reiter Display
Dieselben Felder wie im Reiter Display von Room types, mit Besonderheiten für Pauschalen:
displayMode– Übersichtsliste oder Detail auspackageSlugcardLinkType– book öffnet die Booking Engine mit Vorauswahl überrateIds, details verlinkt zur Pauschalen-DetailseitedetailPageUid– Ziel für Details-Links der KartenshowDetailCalendar,detailCalendarPosition,detailCalendarInitialMonths– bettet den Kalender auf Pauschalen-Detailseiten ein (Packages haben keindetailCalendarOfferMode, sie verwenden die Vorauswahl der Rate)
Dazu kommen settings.ibeLinkTarget und settings.appearance.
Anzeigemodi
Übersichtsmodus
- Raster mit Pauschalen-Karten. Standardmäßig werden nur Pauschalen gelistet, die für
stayNightsbuchbar sind. DeaktivierefilterByStayNights, um alle synchronisierten Pauschalen zu zeigen. - Der Buchen-Button öffnet die Booking Engine mit
rateIds={rateId}.
Detailmodus
- Eine einzelne Pauschale aus dem URL-Argument
packageSlug. - Book now wählt die Rate der Pauschale in der Booking Engine vor.
Route Enhancer (Packages)
Kopiere ihn aus Configuration/SiteConfiguration/RouteEnhancerPackages.yaml.example:
routeEnhancers:
CasablancaPackageDetail:
type: Extbase
extension: CasablancaBooking
plugin: Packages
limitToPages:
- 456 # UID deiner Pauschalen-Detailseite
routes:
- routePath: '/{packageSlug}'
_controller: 'Packages::show'
_arguments:
packageSlug: packageSlug
defaultController: 'Packages::show'
aspects:
packageSlug:
type: CasablancaPackageSlug
URL-Formate:
- Sprechender Pfad:
/package-detail/zeit-zu-zweit - Query-Fallback:
/package-detail?tx_casablancabooking_packages[packageSlug]=zeit-zu-zweit
Price teaser
Plugin-Key: casablancabooking_priceteaser
Ersetzt: SEO-Block „ab €X“ (SEO "from €X" block)
Zweck
Minimale, zentrierte Ab-Preis-Anzeige „ab €X“ mit strukturierten Hotel-JSON-LD-Daten. Ohne Buchungsformular, ideal für SEO-Landingpages und Preishinweise im Hero-Bereich.
Typische Platzierung
- SEO-Landingpages („Hotel in … ab €X“)
- Preis-Highlight auf der Startseite
- Kampagnenseiten
FlexForm-Einstellungen
| FlexForm-Schlüssel | Typ | Standard | Wirkung |
|---|---|---|---|
settings.roomType | select | (alle) | Beschränkt auf einen Zimmertyp. Leer = günstigster Preis über alle Zimmer. |
settings.windowDays | int | 90 | Vorausschau in Tagen für die Suche nach dem günstigsten Preis (7–180). |
settings.appearance | select | default | Layout-Stil (default/inherit/compact). |
settings.labels.heading | string | (leer) | Optionale Überschrift über dem Preis. Leer = keine Überschrift (nur die Preiszeile). |
Es gibt keine Einstellungen für Belegung, Sprache oder Links zur Booking Engine. Das Plugin dient nur der Anzeige.
ViewHelper
Agenturen können Fluid-ViewHelper in Templates des Sitepackages verwenden. Namespace: casablanca (Vendor Casablanca\CasablancaBooking\ViewHelper).
casablanca:cheapestPrice
Gibt den günstigsten verfügbaren Ab-Preis für eine Site bzw. ein Zimmer in einem Tagesfenster aus dem lokalen Verfügbarkeits-Cache aus.
Verwendung:
{casablanca:cheapestPrice(
siteIdentifier: 'main',
roomTypeId: 'uuid-here',
days: 90,
format: '%.2f',
currency: 1
)}
| Argument | Typ | Standard | Beschreibung |
|---|---|---|---|
siteIdentifier | string | erforderlich | TYPO3-Site-Identifier |
roomTypeId | string | '' | Optionale Zimmertyp-UUID. Leer = alle. |
rateId | string | '' | Optionale UUID der Pauschalrate. |
days | int | 90 | Vorausschau (1–365 Tage). |
format | string | '%.2f' | sprintf-Format für die Preiszahl. |
currency | bool | true | Hängt den Währungscode an (z. B. EUR). |
Gibt einen leeren String zurück, wenn kein Preis verfügbar ist.
casablanca:ibeLink
Erzeugt eine Deeplink-URL zur Booking Engine für eigene Templates (Buttons, Links, Call-to-Actions).
Verwendung:
<a href="{casablanca:ibeLink(
siteIdentifier: 'main',
arrival: '2026-06-01',
departure: '2026-06-08',
adults: 2,
children: 0,
roomTypeIds: 'uuid-here',
rateIds: 'package-rate-uuid'
)}">Jetzt buchen</a>
| Argument | Typ | Standard | Beschreibung |
|---|---|---|---|
siteIdentifier | string | erforderlich | TYPO3-Site-Identifier |
arrival | string | '' | Anreisedatum Y-m-d. Standard: morgen. |
departure | string | '' | Abreisedatum Y-m-d. Standard: +1 Tag. |
adults | int | 2 | Anzahl der Erwachsenen. |
children | int | 0 | Anzahl der Kinder. |
childrenAges | string | '' | Kommagetrennte Altersangaben der Kinder. |
roomTypeIds | string | '' | Vorausgewählte Zimmertyp-ID(s), kommagetrennt. |
rateIds | string | '' | ID der Pauschalrate für die Vorauswahl. |
culture | string | '' | Überschreibt das Kultursegment der Booking Engine. |
linkStyle | string | '' | Überschreibt den Link-Stil: full_path, culture_space, culture_only. |
Gibt einen leeren String zurück, wenn die Site nicht konfiguriert ist.
→ Siehe Konfiguration
→ Siehe Lokalisierung
→ Siehe Referenz