Zum Hauptinhalt springen

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 WidgetWordPress-Block / Shortcode
Header-Buchungssnippet (Header booking snippet)Search bar
BuchbarkeitskalenderAvailability calendar
Zimmertypen-WidgetRoom types (+ optionale Zimmerdetailseite)
Pauschalen-WidgetPackages (+ 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​

  1. Erstelle das installierbare ZIP-Paket mit ./bin/build-zip.sh.
  2. Öffne im WordPress-Admin Plugins → Installieren → Plugin hochladen.
  3. Wähle dist/casablanca-booking.zip aus 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​

  1. Öffne CASABLANCA Booking im Admin-Menü.
  2. 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.

Hinweis

Ö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-widget begrenzt)
  • Theme: Datei casablanca-booking.css in 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-bar
  • casablanca/calendar
  • casablanca/room-types
  • casablanca/packages
  • casablanca/room-detail
  • casablanca/package-detail
  • casablanca/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.

  1. Lege eine Seite an, die ein einzelnes Zimmer bzw. eine einzelne Pauschale zeigt (zum Beispiel Pakete oder Zimmer).
  2. Platziere auf dieser Seite den Block Room details (casablanca/room-detail) bzw. Package details (casablanca/package-detail).
  3. Stelle im Übersichtsblock (Room types bzw. Packages) die Option Card link auf Details und wähle die Detailseite aus.
  4. 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):

  1. Mitgeliefertes CSS assets/css/widget.css
  2. Block-Attribute themeAccent und themeRadius (Inline-Style)
  3. Site CSS overrides im Backend
  4. 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​

RouteZugriffZweck
GET /wp-json/casablanca-booking/v1/calendarÖffentlichLive-Daten der Kalendermonate
GET /wp-json/casablanca-booking/v1/offersÖffentlichBuchungsangebote für einen Zeitraum
GET /wp-json/casablanca-booking/v1/catalogRedakteureDaten für die Auswahlfelder Zimmertyp und Pauschale
?casablanca_booking_redirect=1ÖffentlichServerseitige 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 LICENSE im Hauptverzeichnis des Plugins.

→ Siehe Integration über CMS Plugins / Widgets
→ Siehe TYPO3
→ Siehe Standardintegration