Support
HelpHelp Center
  1. Dokumentation
  2. Erweiterungen
  3. Booking
  4. API-Konfiguration

    Hotel-Connection-API Konfiguration

    Die Hotel Connection API (HAPI) sammelt Daten von verschiedenen Quellen und bereitet diese auf. Die aufbereiteten Daten können im Anschluss über einfache Fluid-ViewHelper auf der Seite ausgegeben werden. Dies kann sowohl in Templates als auch Contentelementen erfolgen. 

    Derzeit werden folgende Datenquellen von der Bakehouse HAPI unterstützt:
    Seekda (ehem. Kognitiv)

    Um die Hotel Connection API verwenden zu können, muss die Erweiterung HAPI im Bakehouse installiert sein. Bitte kontaktieren Sie uns: support@bakehouse.at

    JavaScript

    Um die HAPI Schnittstelle nutzen zu können, müssen folgende Zeilen im JavaScript (z. B. in der script.js) auf der Seite geladen werden:

    Javascript
    if (Bh == null) { var Bh = {}; } if (Bh.hapi == null) { Bh.hapi = {}; } Bh.hapi.settings = { hotel : 'MEIN-HOTEL-KEY', engine : 'kube', datepicker : { scope : 'global' } };

    Spracheinstellungen

    Die Sprache wird standardmäßig automatisch aus der aktuellen in Bakehouse ausgegeben Sprache ausgelesen. Der Wert language : 'de' ist optional und kann wenn gewünscht angepasst werden.

    Javascript
    Bh.hapi.settings.language = 'de';

    Falls man die Sprache bei der Ausführung des Scriptes zur Verfügung hat, kann man mit einer Funktion die Sprache zurückgeben. Wenn die Funktion "null" zurückgibt, wird wieder auf die automatische Sprache zurückgegriffen.

    Javascript
    Bh.hapi.settings.language = function () { if(Bh.page.activeLanguageCode() == 'sk') { return 'en'; } }

    TypoScript

    Zu Beginn müssen folgende Einstellungen im TypoScript der Rootseite vorgenommen werden.

    Typoscript
    plugin.tx_bhhapi { settings { service { code = MEIN-HOTEL-KEY engine = kube loadscript = auto } pages { book = https://kube.bakehouse.at/ form = 50 roomdetail = 29 packagedetail = 31 } } }

    Hier werden folgende Werte gesetzt:

    EigenschaftRückgabewertBeschreibung
    codeStringHAPI ID des Hotels
    engine[dsr, kube]Die Buchungs-Engine der Buchungsseite
    loadscript[0, 1, auto]Bestimmt, ob das Widget-Script geladen wird - Bei auto wird das Script nur geladen, wenn Widget-ViewHelper verwendet werden (default: 0)
    bookIntSeite mit der Buchungsstrecke:
    - engine "dsr": Page ID
    - engine "kube": absolute URL auf die KUBE
    formIntSeite mit dem Anfrageformular (Page ID)
    roomdetailIntSeite mit der Detailansicht (Page ID)
    packagedetailIntSeite mit der Detailansicht für die Pauschalen (Page ID)

    Sprachkonfiguration - Alternative Sprache

    Will man die Ausgabe der HAPI Integration, entgegen der aktuellen in Bakehouse ausgegeben Sprache ändern, benötigt man folgende Anweisung im Root TypoScript:

    Typoscript
    [siteLanguage("languageId") == 2] plugin.tx_bhhapi.settings.languageCode = en [global]

    Die TypoScript Bedingung prüft die aktuelle Sprach ID und ändert die Ausgabe der HAPI Integration auf die gewünschte Sprache.

    Tracking

    Mit folgendem Code können automatisch E-Commerce Buchungen an Google Analytics und Matamo übertragen werden:

    Typoscript
    page.includeJS.seekdaTracking = https://hapi.bakehouse.at/js/seekdaTracking.js bhDefaultMobilePage.includeJS.seekdaTracking = https://hapi.bakehouse.at/js/seekdaTracking.js