Zum Hauptinhalt springen

Konfiguration

Öffne Tools → CASABLANCA Booking, um pro TYPO3-Site einen Konfigurationsdatensatz zu verwalten. Die Datenbankkonfiguration hat Vorrang vor den optionalen casablanca_booking:-Schlüsseln in config/sites/*/config.yaml.

Modulübersicht​


Das Modul hat zwei Ansichten:

  • Index – listet alle gespeicherten Site-Konfigurationen mit Verbindungsstatus auf.
  • Edit – legt eine Konfiguration an bzw. bearbeitet sie. Die Ansicht enthält die Reiter Configuration, Mapping codes und Sync logs.

Bei gespeicherten Konfigurationen stehen diese Aktionen zur Verfügung:

  • Save – speichert Zugangsdaten und Einstellungen der Booking Engine und führt eine Verbindungsprüfung aus.
  • Test connection – prüft die API-Zugangsdaten ohne vollständigen Sync.
  • Sync now – importiert Verfügbarkeiten, Zimmertypen und Raten sofort.
  • Cancel – kehrt ohne Speichern zum Index zurück.

Reiter Configuration – Feldreferenz​


Zugangsdaten​

FeldPflichtStandardWirkung
Site identifierJa–TYPO3-Site, zu der diese Konfiguration gehört. Wähle sie beim Anlegen aus, nach dem Speichern ist sie schreibgeschützt. Muss mit dem Site-Identifier in config/sites/*/config.yaml übereinstimmen.
Tenant IDJa–UUID des CASABLANCA-Mandanten (Tenant) aus dem Admin-Bereich der Booking Engine. Für API und Sync erforderlich.
API keyJa (neu)–CASABLANCA-API-Schlüssel. Wird verschlüsselt in der Datenbank gespeichert. Lass das Feld beim Bearbeiten leer, um den bestehenden Schlüssel zu behalten. Wird nie in der Site-YAML oder in Umgebungsvariablen gespeichert.

Booking Engine und Space​

FeldPflichtStandardWirkung
Use custom IBE domainNeinnicht aktiviertKennzeichnet eine Buchungsdomain, die nicht von CASABLANCA gehostet wird. Beeinflusst Warnungen bei der Prüfung des Link-Stils.
IBE base URLNeinhttps://bookingengine.casablanca.atBasis-URL für die Übergabe-Links ins Frontend der Booking Engine.
Space nameNeinbookingengineKontext-Kennung der Booking Engine (URL-freundliche ID des Spaces). In der CASABLANCA-Terminologie ist der Space (früher Betrieb) dieser Kontext. Für den Link-Stil full_path erforderlich.
Link styleNeinfull_pathSteuert das Pfadmuster der Übergabe-URL. Siehe Link-Stile für die Übergabe.
Booking Engine URL–(Vorschau)Schreibgeschützte Live-Vorschau der resultierenden URL der Booking Engine auf Basis der aktuellen Feldwerte. Wird beim Bearbeiten aktualisiert (JavaScript).
Default cultureNeindeStandard-Kultur (Sprachsegment) der Booking Engine, z. B. de oder en. Wird verwendet, wenn die FlexForm-Sprache auf Auto steht, und für API-Sync-Anfragen.

Theming​

Praktisch für Agenturen ohne Deploy-Zugriff auf das Sitepackage. Ergänzt die TypoScript-Einstellungen theme.*. Die vollständige Token-Liste, die Reihenfolge der Ebenen und Beispiele stehen unter Theming.

FeldPflichtStandardWirkung
CSS design tokens–(Referenz)Einklappbare Liste aller --cb-*-Standardwerte aus widget.css.
Site CSS overridesNeinleerCSS pro Site, in der Datenbank gespeichert (theme_css). Wird nach dem mitgelieferten CSS und den TypoScript-Theme-Einstellungen angewendet und als Inline-<style> in jedem Widget eingefügt. Begrenze die Regeln auf .cb-widget.

Sync​

Der Bereich Sync zeigt nur Informationstext an. In der Oberfläche gibt es keine bearbeitbaren Felder. Im Reiter Sync logs siehst du die letzten Importläufe. Das Verhalten des Syncs steuern interne Standardwerte im Konfigurationsdatensatz:

DatenbankfeldFeld in der OberflächeStandardWirkung
sync_range_days–365Wie viele Tage im Voraus Verfügbarkeiten pro Sync-Lauf importiert werden.
sync_chunk_days–31Blockgröße der API-Anfragen (Tage pro Aufruf).
pagination_top–100Seitengröße der API-Paginierung.
default_adults–2Ersatzwert für die Standardanzahl der Erwachsenen, wenn sie weder in FlexForm noch in TypoScript gesetzt ist.
default_children_ages–(leer)Ersatzwert für das Alter der Kinder (in der Datenbank kommagetrennt). Wird für Belegungsstandards verwendet.
api_base_url–https://api.casablanca.atCASABLANCA-API-Host.
service_path–ibePfadsegment der API zwischen Host und Tenant.

Automatischer Sync-Zeitplan:

  • Beim ersten Speichern wird ein täglicher TYPO3-Scheduler-Task angelegt (zeitlich auf den Speicherzeitpunkt versetzt).
  • Ein erster Sync läuft, wenn eine neue Konfiguration die Verbindungsprüfung besteht.
  • Der Sync startet auch nach dem Leeren von Backend-Caches.

Verbindungsstatus​

Nach Save oder Test connection zeigt das Modul den Verbindungsstatus an:

StatusBedeutung
OK (grün)Die API-Zugangsdaten wurden erfolgreich geprüft.
Fehler (rot)Verbindung fehlgeschlagen. Prüfe Tenant-ID, API-Schlüssel und Netzwerk.
UnbekanntNoch nicht geprüft.

Wenn vorhanden, zeigt das Modul auch den Zeitpunkt der letzten Prüfung und die Fehlermeldung an.

Reiter Mapping codes​


Der Reiter ist nur sichtbar, wenn der Verbindungsstatus OK ist. Er listet synchronisierte Entitäten mit PMS-Mapping-Codes für Redakteure:

  • Space – Space-Titel, Space-ID
  • Company ID
  • Room types – ID, Name, Typ, Code, Min./Std./Max. Belegung
  • Rates (all) – Standardraten
  • Packages – Pauschalraten

Voraussetzung ist mindestens ein erfolgreicher Sync. Verwende Sync now, wenn der Reiter No mapping codes synced yet anzeigt.

Reiter Sync logs​


Der Reiter ist bei jeder gespeicherten Konfiguration verfügbar. Er zeigt die letzten Sync-Läufe der aktuellen Site (bis zu 50 Einträge) mit Sync now am oberen Rand.

SpalteBedeutung
StartedZeitpunkt, zu dem der Sync-Lauf begonnen hat
DurationDauer in Sekunden (leer, solange der Lauf noch aktiv ist)
Statusrunning, success, partial oder failure
Rows writtenWährend des Laufs geschriebene Verfügbarkeitszeilen
Rows changedZeilen, die sich vom bisherigen Cache unterschieden haben
Cache tagsNach Änderungen geleerte Seiten-Cache-Tags
MessageBei Erfolg der Zeitraum des Syncs (z. B. Window 2026-09-22–2027-09-21), bei Fehler oder Teilerfolg der Ausnahmetext

Erwarteter Ablauf​


  1. Konfiguration hinzufügen: Wähle einen TYPO3-Site identifier, gib Tenant ID und API key ein und klicke auf Save.
  2. Konfiguration bearbeiten: Nach dem Speichern enthält die URL die uid der Konfiguration. Eine Meldung bestätigt, dass der Datensatz gespeichert wurde (der API-Schlüssel liegt verschlüsselt in der Datenbank).
  3. Verbindungsprüfung: Sie läuft beim Speichern automatisch. Die Statusanzeige ist grün (OK), rot (fehlgeschlagen) oder grau (noch nicht geprüft).
  4. Automatischer Sync: Beim ersten Speichern legt die Extension einen täglichen TYPO3-Scheduler-Task an (zeitlich auf den Speicherzeitpunkt versetzt) und führt einen ersten Import aus, wenn die Verbindungsprüfung erfolgreich ist. Der Sync läuft auch nach dem Leeren von Backend-Caches.
  5. Sync now: Importiert Verfügbarkeiten, Zimmertypen und Raten der Site sofort.
  6. Mapping codes: Der Reiter erscheint, sobald der Verbindungsstatus OK ist. Er listet synchronisierte Zimmertypen, Raten und Pauschalen mit PMS-Codes für Redakteure.
Hinweis

Mit Test connection kannst du die Zugangsdaten jederzeit erneut prüfen, ohne einen vollständigen Sync zu starten. Den Scheduler-Task findest du unter System → Scheduler.

In der CASABLANCA-Terminologie ist der Space (früher Betrieb) der Kontext der Booking Engine, den du als Space name konfigurierst.


Der Link-Stil betrifft nur die Übergabe-URLs im Frontend. API-Sync-URLs verwenden immer {apiBaseUrl}/{servicePath}/{tenant}/{space}/....

WertResultierender PfadWann verwenden
full_path{base}/{culture}/{tenant}/{space}Standarddomain von CASABLANCA
culture_space{base}/{culture}/{space}Eigene Domain, der Proxy ergänzt den Tenant
culture_only{base}/{culture}Eigene Domain, der Proxy ergänzt Tenant und Space (z. B. Cloudflare Worker)

Beispiel für die Query-Parameter (alle Stile):

?arrivalDate=2026-06-01&departureDate=2026-06-08&rooms_0__adults=2

Das Backend-Modul zeigt beim Bearbeiten der Konfiguration eine Live-Vorschau der Booking Engine URL, inklusive einer Musterzeile (z. B. Pattern: {culture}/{space}). Die Vorschau aktualisiert sich, wenn sich Tenant, Space, Kultur, Link-Stil oder die Basis-URL ändern. Sie ist im hellen und im dunklen Backend-Modus lesbar.

→ Siehe Benutzerdefinierte Domain (Reverse Proxy) → Siehe Übergabe von URL-Parametern

Validierung​

  • full_path erfordert einen Space-Namen.
  • culture_space und culture_only zeigen mit der Standarddomain von CASABLANCA eine nicht blockierende Warnung im Backend. Sie sind für eigene Domains der Booking Engine gedacht.
  • Ältere Werte tenant_only werden beim Laden zu culture_space normalisiert.

Speicherung des API-Schlüssels​


API-Schlüssel gibst du nur unter Tools → CASABLANCA Booking ein. Sie werden verschlüsselt in der Datenbank gespeichert. Umgebungsvariablen und Klartext-Schlüssel in der Site-YAML werden nicht unterstützt.

Site-YAML (optional)​


Entwickler können weiterhin casablanca_booking: in config/sites/*/config.yaml ergänzen. Ist eine Datenbankkonfiguration aus dem Backend-Modul vorhanden, hat sie Vorrang.

Optionaler YAML-Schlüssel für den Link-Stil:

casablanca_booking:
ibeLinkStyle: full_path # oder culture_space, culture_only

→ Siehe Referenz
→ Siehe Theming