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
| Feld | Pflicht | Standard | Wirkung |
|---|---|---|---|
| Site identifier | Ja | – | 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 ID | Ja | – | UUID des CASABLANCA-Mandanten (Tenant) aus dem Admin-Bereich der Booking Engine. Für API und Sync erforderlich. |
| API key | Ja (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
| Feld | Pflicht | Standard | Wirkung |
|---|---|---|---|
| Use custom IBE domain | Nein | nicht aktiviert | Kennzeichnet eine Buchungsdomain, die nicht von CASABLANCA gehostet wird. Beeinflusst Warnungen bei der Prüfung des Link-Stils. |
| IBE base URL | Nein | https://bookingengine.casablanca.at | Basis-URL für die Übergabe-Links ins Frontend der Booking Engine. |
| Space name | Nein | bookingengine | Kontext-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 style | Nein | full_path | Steuert 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 culture | Nein | de | Standard-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.
| Feld | Pflicht | Standard | Wirkung |
|---|---|---|---|
| CSS design tokens | – | (Referenz) | Einklappbare Liste aller --cb-*-Standardwerte aus widget.css. |
| Site CSS overrides | Nein | leer | CSS 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:
| Datenbankfeld | Feld in der Oberfläche | Standard | Wirkung |
|---|---|---|---|
sync_range_days | – | 365 | Wie viele Tage im Voraus Verfügbarkeiten pro Sync-Lauf importiert werden. |
sync_chunk_days | – | 31 | Blockgröße der API-Anfragen (Tage pro Aufruf). |
pagination_top | – | 100 | Seitengröße der API-Paginierung. |
default_adults | – | 2 | Ersatzwert 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.at | CASABLANCA-API-Host. |
service_path | – | ibe | Pfadsegment 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:
| Status | Bedeutung |
|---|---|
| OK (grün) | Die API-Zugangsdaten wurden erfolgreich geprüft. |
| Fehler (rot) | Verbindung fehlgeschlagen. Prüfe Tenant-ID, API-Schlüssel und Netzwerk. |
| Unbekannt | Noch 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.
| Spalte | Bedeutung |
|---|---|
| Started | Zeitpunkt, zu dem der Sync-Lauf begonnen hat |
| Duration | Dauer in Sekunden (leer, solange der Lauf noch aktiv ist) |
| Status | running, success, partial oder failure |
| Rows written | Während des Laufs geschriebene Verfügbarkeitszeilen |
| Rows changed | Zeilen, die sich vom bisherigen Cache unterschieden haben |
| Cache tags | Nach Änderungen geleerte Seiten-Cache-Tags |
| Message | Bei Erfolg der Zeitraum des Syncs (z. B. Window 2026-09-22–2027-09-21), bei Fehler oder Teilerfolg der Ausnahmetext |
Erwarteter Ablauf
- Konfiguration hinzufügen: Wähle einen TYPO3-Site identifier, gib Tenant ID und API key ein und klicke auf Save.
- Konfiguration bearbeiten: Nach dem Speichern enthält die URL die
uidder Konfiguration. Eine Meldung bestätigt, dass der Datensatz gespeichert wurde (der API-Schlüssel liegt verschlüsselt in der Datenbank). - Verbindungsprüfung: Sie läuft beim Speichern automatisch. Die Statusanzeige ist grün (OK), rot (fehlgeschlagen) oder grau (noch nicht geprüft).
- 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.
- Sync now: Importiert Verfügbarkeiten, Zimmertypen und Raten der Site sofort.
- Mapping codes: Der Reiter erscheint, sobald der Verbindungsstatus OK ist. Er listet synchronisierte Zimmertypen, Raten und Pauschalen mit PMS-Codes für Redakteure.
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.
Link-Stile für die Übergabe
Der Link-Stil betrifft nur die Übergabe-URLs im Frontend. API-Sync-URLs verwenden immer {apiBaseUrl}/{servicePath}/{tenant}/{space}/....
| Wert | Resultierender Pfad | Wann 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_patherfordert einen Space-Namen.culture_spaceundculture_onlyzeigen mit der Standarddomain von CASABLANCA eine nicht blockierende Warnung im Backend. Sie sind für eigene Domains der Booking Engine gedacht.- Ältere Werte
tenant_onlywerden beim Laden zuculture_spacenormalisiert.
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