WordPress
Mit dem Plugin CASABLANCA Booking bindest du Inhalte der CASABLANCA Booking Engine in deine WordPress-Website ein, zum Beispiel Suchleiste, Verfügbarkeitskalender, Zimmertypen und Pauschalen. Die Buchung selbst findet weiterhin in der Booking Engine statt. Gäste werden dorthin weitergeleitet.
Was das Plugin kann
- Synchronisation im Hintergrund: Das Plugin lädt Zimmertypen, Raten bzw. Pauschalen und Kalenderpreise aus der CASABLANCA-BE-v2-API in lokale Tabellen.
- SSR-Widgets: Gutenberg-Blöcke und Shortcodes ersetzen die bisherigen JavaScript-Web-Widgets durch durchsuchbares HTML mit JSON-LD (Preis-Teaser).
- Detailseiten: Übersichtskarten können auf
/{detail-page}/{slug}/verlinken. Der Block für Zimmer- bzw. Pauschalendetails löst den synchronisierten Slug auf. Auf Live-URLs ist dafür keine Ersatz-ID nötig. - PCI-sichere Übergabe: Gäste werden zur CASABLANCA Booking Engine weitergeleitet. WordPress verarbeitet keine Zahlungsdaten.
Widgets
| Bisheriges Widget | WordPress-Block / Shortcode |
|---|---|
| Header-Buchungssnippet (Header booking snippet) | Search bar |
| Buchbarkeitskalender | Availability calendar |
| Zimmertypen-Widget | Room types (+ optionale Zimmerdetailseite) |
| Pauschalen-Widget | Packages (+ optionale Pauschalendetailseite) |
| SEO-Preisblock (SEO price block) | Price teaser |
Voraussetzungen
Für das Plugin benötigst du eine aktive CASABLANCA Booking Engine Lizenz, die eine API-Lizenz enthält. Ohne diese Lizenz funktionieren die Synchronisation und die Buchungs-Widgets nicht.
→ Siehe Lizenzen
→ Siehe Integration über CMS Plugins / Widgets
Installation
Installation per ZIP-Upload
- Erstelle das installierbare ZIP-Paket mit
./bin/build-zip.sh. - Öffne im WordPress-Admin Plugins → Installieren → Plugin hochladen.
- Wähle
dist/casablanca-booking.zipaus und aktiviere das Plugin.
Installation über das Plugin-Verzeichnis
Kopiere den Ordner casablanca-booking nach wp-content/plugins/ und aktiviere das Plugin unter Plugins.
Erste Konfiguration
- Öffne CASABLANCA Booking im Admin-Menü.
- Gib die Tenant-ID und den API-Schlüssel ein und speichere.
Beim ersten erfolgreichen Verbindungstest plant das Plugin eine tägliche Synchronisation und führt einen ersten Import aus.
Öffne nach der Aktivierung (oder nach einem Plugin-Update, das die Rewrite-Regeln ändert) Einstellungen → Permalinks und klicke einmal auf Speichern. Das Plugin aktualisiert die Rewrite-Regeln bei der Aktivierung und immer dann, wenn sich die Rewrite-Version ändert. Detail-URLs wie /{detail-page}/{slug}/ funktionieren deshalb meist ohne manuelles Speichern. Das Speichern der Permalinks bleibt aber die zuverlässige Absicherung.
Konfiguration
Admin-Modul
CASABLANCA Booking hat drei Reiter:
- Configuration – Zugangsdaten, Link-Stil für die Übergabe an die Booking Engine und Site-CSS-Overrides
- Mapping codes – ID von Zimmertypen und Pauschalen nach der Synchronisation (nur lesbar)
- Sync logs – die letzten 50 Importläufe
Umgebungsmodus (Staging)
Der Umgebungsmodus lässt sich nicht im Admin-Bereich ändern. Setze ihn in wp-config.php:
define('CASABLANCA_BOOKING_ENV', 'production'); // staging | development
Die Produktions-Hosts von API und Booking Engine werden zur Laufzeit nur umgeschrieben, wenn die Konstante staging oder development wählt.
Verschlüsselter API-Schlüssel
Der API-Schlüssel wird mit libsodium und AUTH_KEY verschlüsselt gespeichert. Lass das Feld für den API-Schlüssel beim Bearbeiten leer, wenn du den bestehenden Schlüssel behalten möchtest.
CSS-Anpassungen
Du kannst das Aussehen der Widgets an drei Stellen überschreiben:
- Backend: Textfeld Site CSS overrides (auf
.cb-widgetbegrenzt) - Theme: Datei
casablanca-booking.cssin deinem Theme oder Child-Theme - Filter:
casablanca_booking_theme_css
Das mitgelieferte CSS deaktivierst du über das Block- bzw. Shortcode-Attribut includeCss="0" oder indem du das Handle casablanca-booking-widget entfernst (dequeue).
Blöcke und Shortcodes
Gutenberg-Blöcke
casablanca/search-barcasablanca/calendarcasablanca/room-typescasablanca/packagescasablanca/room-detailcasablanca/package-detailcasablanca/price-teaser
Shortcodes (Classic Editor, Page Builder)
[casablanca_search_bar][casablanca_calendar][casablanca_room_types][casablanca_packages][casablanca_room_detail][casablanca_package_detail][casablanca_price_teaser]
Attribute übergibst du als Shortcode-Schlüssel, zum Beispiel [casablanca_calendar windowDays="90" appearance="compact"].
Übersichtskarten mit Detailseiten verknüpfen
Die Übersichten für Zimmer und Pauschalen können eine eigene Detailseite öffnen, statt direkt in die Booking Engine zu springen.
- Lege eine Seite an, die ein einzelnes Zimmer bzw. eine einzelne Pauschale zeigt (zum Beispiel Pakete oder Zimmer).
- Platziere auf dieser Seite den Block Room details (
casablanca/room-detail) bzw. Package details (casablanca/package-detail). - Stelle im Übersichtsblock (Room types bzw. Packages) die Option Card link auf Details und wähle die Detailseite aus.
- Veröffentliche beide Seiten.
Die öffentlichen URLs sehen dann so aus:
/{detail-page-slug}/{synced-item-slug}/
Beispiel: /pakete/skispass-im-jaenner-inkl-kt/
Das letzte Pfadelement ist der Slug, der bei der Synchronisation gespeichert wurde. Der Detailblock ermittelt das Zimmer bzw. die Pauschale anhand dieses Slugs. Eine Ersatz-ID (Fallback) für Zimmer oder Pauschale ist optional. Sie wird nur verwendet, wenn die URL keinen Slug enthält, zum Beispiel bei der Vorschau der Detailseite im Editor.
Öffne nach der Installation oder einem Update des Plugins Einstellungen → Permalinks und klicke einmal auf Speichern, damit WordPress die Rewrite-Regeln für die Detailseiten registriert. Das Plugin aktualisiert die Regeln bei der Aktivierung und bei einer neuen Rewrite-Version automatisch.
Live-Kalender
Der Kalender-Block ruft die Verfügbarkeiten über die WordPress-REST-Route casablanca-booking/v1/calendar ab. Der Browser greift nie direkt auf die CASABLANCA-API zu.
Sprache
Jeder Block hat die Einstellung Language: Auto, Deutsch, English, Italiano, Français (Werte '' / de / en / it / fr).
- Auto folgt der Sprache der Website (
determine_locale()):de_*→ Deutsch,it_*→ Italienisch,fr_*→ Französisch, sonst Englisch. - Eine ausdrücklich gewählte Sprache stellt alle Texte der Plugin-Oberfläche (Vorlagen, Fußnoten, Buttons,
window.CB_LABELS) sowie die API-Kultur auf Englisch, Deutsch, Italienisch oder Französisch um. Das gilt auch dann, wenn die Website selbst auf Englisch läuft. - Eigene Beschriftungen pro Block (Überschrift, „Jetzt buchen“, Absenden-Button usw.) haben Vorrang, sobald du sie ausfüllst.
Die Texte liegen in resources/i18n/widget-strings.php. Für die Frontend-Widgets sind sie nicht von load_plugin_textdomain abhängig.
Synchronisation im Hintergrund
Täglicher Scheduler
Beim ersten Speichern der Konfiguration registriert das Plugin ein tägliches WP-Cron-Ereignis, das zeitlich auf den Speicherzeitpunkt versetzt wird.
Für Produktivseiten mit wenig Traffic solltest du einen System-Cron einrichten:
*/15 * * * * cd /path/to/wordpress && wp cron event run --due-now
Manuelle Synchronisation
- Admin: Sync now oder Clear synced data and sync
- WP-CLI:
wp casablanca-booking sync [--days=14] [--force]
Synchronisationsprotokoll
Jeder Lauf speichert seinen Status (running, success, partial, failure), die Anzahl geschriebener bzw. geänderter Zeilen und eine Meldung. Die letzten 50 Einträge findest du im Reiter Sync logs.
Theming
CSS-Aufbau
Alle Widgets verwenden das Präfix .cb- und die Design-Tokens --cb-* auf .cb-widget.
Reihenfolge der Ebenen (von niedriger zu höherer Priorität):
- Mitgeliefertes CSS
assets/css/widget.css - Block-Attribute
themeAccentundthemeRadius(Inline-Style) - Site CSS overrides im Backend
- Theme-Datei
casablanca-booking.css
Darstellungsmodi
Das Block-Attribut appearance kennt die Werte default, inherit und compact.
Mitgeliefertes CSS deaktivieren
Setze includeCss am Block oder Shortcode auf false, wenn dein Theme einen vollständigen Ersatz mitbringt. JavaScript wird immer geladen.
Referenz
REST-Routen
| Route | Zugriff | Zweck |
|---|---|---|
GET /wp-json/casablanca-booking/v1/calendar | Öffentlich | Live-Daten der Kalendermonate |
GET /wp-json/casablanca-booking/v1/offers | Öffentlich | Buchungsangebote für einen Zeitraum |
GET /wp-json/casablanca-booking/v1/catalog | Redakteure | Daten für die Auswahlfelder Zimmertyp und Pauschale |
?casablanca_booking_redirect=1 | Öffentlich | Serverseitige Weiterleitung (HTTP 303) zur Booking Engine |
WP-CLI
wp casablanca-booking sync [--site=1] [--force] [--days=14]
Filter
casablanca_booking_theme_css– ändert das CSS pro Website vor der Ausgabe
Cron-Hook
casablanca_booking_daily_sync
Datenbanktabellen
Die Tabellen haben das Präfix {wpdb.prefix}casablanca_: configuration, availability, roomtype, rate, synclog.
Autor und Lizenz
- Autor: Martin Hairer – martin.hairer@casablanca.at
- Lizenz: GPL-3.0-only – Copyright CASABLANCA hotelsoftware GmbH. Siehe
LICENSEim Hauptverzeichnis des Plugins.
→ Siehe Integration über CMS Plugins / Widgets
→ Siehe TYPO3
→ Siehe Standardintegration