Zum Hauptinhalt springen

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:

  1. Backend-Konfiguration: Speichere die Zugangsdaten unter Tools → CASABLANCA Booking für den Identifier der aktuellen TYPO3-Site.
  2. Sync: Führe Sync now aus (oder warte auf den Scheduler), damit Zimmertypen, Raten und Verfügbarkeiten lokal zwischengespeichert sind.
  3. Site Sets: Die config.yaml der Site muss casablanca/booking (und üblicherweise typo3/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üsselTypStandardWirkung
settings.defaultRoomsint1Vorausgewählte Zimmeranzahl (1–5) für Mehrzimmer-Formulare. Jedes Zimmer hat eigene Felder für Erwachsene und Kinder. Nur Widget und Search Bar.
settings.defaultAdultsint2Standardanzahl 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.defaultChildrenint0Standardanzahl der Kinder pro Zimmer (0–10). Bei 0 werden die Eingabefelder für das Kinderalter in Formularen ausgeblendet. Nur Widget und Search Bar.
settings.defaultChildrenAgesstring(leer)Kommagetrennte Altersangaben (z. B. 4,8). Wird verwendet, wenn Kinder > 0. Fehlende Altersangaben werden mit 0 aufgefüllt.
settings.languageselectAutoKultur der Booking Engine bei der Übergabe: de, en, it, fr oder Auto (Standard der Site).
settings.ibeLinkTargetselect_self_self = gleiches Fenster, _blank = neuer Tab (erfordert JavaScript). Der Formular-Fallback öffnet immer im gleichen Fenster.
settings.windowDaysint90Vorausschau in Tagen (7–180) für die Kalenderanzeige oder die Ermittlung des Ab-Preises.
settings.appearanceselectdefaultLayout-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üsselTypStandardWirkung
settings.preselectRoomCategoryselect(keiner)Beschränkt den Kalender auf einen Zimmertyp. Die Optionen werden nach dem Sync befüllt. Praktisch für zimmerspezifische Landingpages.
settings.calendarInitialMonthsselect1Beim ersten Laden sichtbare Monate: nur der aktuelle Monat (1) oder aktueller plus nächster Monat (2). Weitere Monate werden über die Navigation geladen.
settings.calendarOfferModeselectnoneAngebote, die nach der Datumsauswahl angezeigt werden: none, rates_only, packages_only, packages_and_rates
settings.showEnquiryButtoncheckbox0Zeigt neben dem Buchen-Button einen Anfrage-Button. Erfordert enquiryUrl.
settings.enquiryUrlstring(leer)Ziel-URL des Anfrage-Buttons (Kontaktformular, Anfrageseite).
settings.enquiryLinkTargetselect_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üsselTypStandardWirkung
settings.labels.headingstring(leer)Überschrift des Kalenders. Leer = widget.heading.default oder Zimmername.
settings.labels.bookNowstring(leer)Buchen-Button. Leer = widget.calendar.bookNow.
settings.labels.enquirystring(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__children und Alters-Parameter an die Booking Engine übergeben.
  • Ist ein Zimmertyp vorausgewählt, wird die Belegung auf die maxOccupancy dieses 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.


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.

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üsselTypStandardWirkung
settings.filterRoomTypeselect(alle)Zeigt in der Übersicht nur ein Zimmer.
settings.stayNightsint7Standardaufenthalt 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üsselTypStandardWirkung
settings.displayModeselectoverviewoverview = Kartenraster, detail = einzelnes Zimmer aus dem Slug in der URL.
settings.showNamecheckbox1Zeigt den Zimmernamen auf Karten bzw. in der Detailansicht.
settings.showDescriptioncheckbox1Zeigt die Zimmerbeschreibung.
settings.overviewDescriptionModeselectteaserNur Übersicht: kurzer Teaser oder gekürzte vollständige Beschreibung mit More-Steuerelement.
settings.overviewDescriptionLimitint250Zeichenlimit für den vollständigen Text in der Übersicht.
settings.overviewLayoutselectgridKartenlayout der Übersicht: grid oder list.
settings.showPricecheckbox1Zeigt den Ab-Preis (günstigster Preis im Zeitfenster).
settings.showImagecheckbox1Zeigt das Zimmerbild.
settings.cardLinkTypeselectbookNur Übersicht: book = direkt zur Booking Engine, details = Link zur TYPO3-Detailseite.
settings.detailPageUidpage(keine)Zielseite für Details-Links. Muss dieses Plugin im Detailmodus enthalten.
settings.showDetailCalendarcheckbox0Bettet auf Detailseiten den Buchungskalender ein.
settings.detailCalendarPositionselectbelowKalender oberhalb oder unterhalb des Detailinhalts.
settings.detailCalendarInitialMonthsselect1Sichtbare Monate des Detailkalenders.
settings.detailCalendarOfferModeselectrates_onlyAngebote 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 cardLinkType zur Booking Engine (book) oder zur Detailseite (details).
  • Der Ab-Preis verwendet die Vorausschau windowDays aus dem lokalen Verfügbarkeits-Cache.

Detailmodus

  • Ein einzelnes Zimmer, das über das URL-Argument roomSlug gewä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 detailCalendarPosition die Position (oberhalb/unterhalb des Inhalts).
  • Legt detailCalendarInitialMonths fest, ob anfangs 1 oder 2 Monate sichtbar sind.
  • Zeigt detailCalendarOfferMode nach 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üsselTypStandardWirkung
settings.filterPackageselect(alle)Zeigt in der Übersicht nur eine Pauschale. (alle) hebt die Filterung nach Aufenthaltsdauer nicht auf, siehe unten.
settings.stayNightsint7Standardaufenthalt 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.filterByStayNightscheckanIst 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 aus packageSlug
  • cardLinkType – book öffnet die Booking Engine mit Vorauswahl über rateIds, details verlinkt zur Pauschalen-Detailseite
  • detailPageUid – Ziel für Details-Links der Karten
  • showDetailCalendar, detailCalendarPosition, detailCalendarInitialMonths – bettet den Kalender auf Pauschalen-Detailseiten ein (Packages haben kein detailCalendarOfferMode, 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 stayNights buchbar sind. Deaktiviere filterByStayNights, 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üsselTypStandardWirkung
settings.roomTypeselect(alle)Beschränkt auf einen Zimmertyp. Leer = günstigster Preis über alle Zimmer.
settings.windowDaysint90Vorausschau in Tagen für die Suche nach dem günstigsten Preis (7–180).
settings.appearanceselectdefaultLayout-Stil (default/inherit/compact).
settings.labels.headingstring(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
)}
ArgumentTypStandardBeschreibung
siteIdentifierstringerforderlichTYPO3-Site-Identifier
roomTypeIdstring''Optionale Zimmertyp-UUID. Leer = alle.
rateIdstring''Optionale UUID der Pauschalrate.
daysint90Vorausschau (1–365 Tage).
formatstring'%.2f'sprintf-Format für die Preiszahl.
currencybooltrueHängt den Währungscode an (z. B. EUR).

Gibt einen leeren String zurück, wenn kein Preis verfügbar ist.

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>
ArgumentTypStandardBeschreibung
siteIdentifierstringerforderlichTYPO3-Site-Identifier
arrivalstring''Anreisedatum Y-m-d. Standard: morgen.
departurestring''Abreisedatum Y-m-d. Standard: +1 Tag.
adultsint2Anzahl der Erwachsenen.
childrenint0Anzahl der Kinder.
childrenAgesstring''Kommagetrennte Altersangaben der Kinder.
roomTypeIdsstring''Vorausgewählte Zimmertyp-ID(s), kommagetrennt.
rateIdsstring''ID der Pauschalrate für die Vorauswahl.
culturestring''Überschreibt das Kultursegment der Booking Engine.
linkStylestring''Ü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