Mit den Seekda Widgets lassen sich die Daten von Seekda (ehem. Kognitiv) übersichtlich und einfach in ein Online-Projekt einbinden. Die in den Widgets angezeigten Zimmer, Pauschalen, Preise und Verfügbarkeiten entsprechen dabei immer dem aktuellen Verfügbarkeits- und Preisstand und werden live aktualisiert.
Um die Widgets in das eigene Online-Projekt einbinden zu können, ist eine Seekda-Installation beim Kunden notwendig. Die Erweiterung API muss in Seekda freigeschaltet sein. Im Anschluss können die Widgets bei uns gebucht und eingerichtet werden. Gerne helfen wir bei der Einrichtung und erstellen ein persönliches Angebot. Unser Supportteam steht unter support@bakehouse.at jederzeit zur Verfügung.
Dieser obligatorische Tag muss im <head> Element der Webseite eingebaut werden. Hiermit werden die notwendigen JavaScript Dateien nachgeladen. Über die Data-Attribute werden wichtige Einstellungen vorgenommen, die sich auf das Verhalten der Widgets auswirken. Werden Fehler aufgrund von falschen Attributangaben verursacht, können über die Debug Console des Browsers genauere Informationen aufgerufen werden. Die ID hapi darf nicht verändert werden.
Werden die Widgets in einem Bakehouse verwendet, darf folgendes Script nicht im Template eingebunden werden. Durch die Verwendung der Widget-ViewHelper und entsprechender API-Konfiguration werden die Widgets automatisch importiert, die die Anwendung erleichtert und mehrfaches Laden des Scripts verhindert.
| Attribut | Type | Beschreibung | Required |
| data-token | String | Der Token für die Hotel Zuordnung - dieser wird von uns (Cookis GmbH) bei der Installation der Widgets erstellt und übermittelt. | true |
| data-lang | [de, en, it, nl, fr] | Der Sprachkürzel für die Spracheinstellung und -ausgabe der Widgets (z. B. "de" für Deutsch und "en" für Englisch). | true |
| data-book-href | URL | Die URL, die aufgerufen wird, wenn der/die Besucher:in auf Buchen klickt. Auf dieser URL muss eine Seekda Buchungsstrecke eingebunden sein. | true |
| data-inquiry-href | URL | Die URL, die aufgerufen wird, wenn der/die Besucher:in auf Anfragen klickt. Zu dieser URL werden vom Widget auch Parameter hinzugefügt (siehe Punkt Parameterübergabe). Wenn dieses Attribut nicht gesetzt ist, wird kein Anfrage-Button ausgegeben. | false |
| data-package-detail-href | URL | Die URL, die aufgerufen wird, wenn der/die Besucher:in auf Details bei einer Pauschale klickt. Auf dieser Seite muss das Widget Pauschalen-Detail eingebaut werden. | false |
| data-booking-engine | [dsr, kube] | Die Buchungs-Engine, welche auf der Buchungsseite verwendet wird. Für eine korrekte Funktion und Parameterübergabe muss die richtige Engine eingestellt sein. | false |
Das Erscheinungsbild der Widgets kann mit einfachen CSS-Variablen angepasst werden.
Anpassungen, die die Möglichkeiten der CSS-Variablen übetreffen, können über eigene CSS-Regeln durchgeführt werden. Änderungen an der Seekda API machen jedoch immer wieder Anpassungen an den Widgets notwendig. Wir bitten dies bei manuellen Eingriffen zu berücksichtigen.
Die Seekda Codes zu den verschiedenen Parametern, wie z. B. Zimmer-Codes, können aus dem HAPI-Code-Tool entnommen werden.
Dazu wird nur der von uns zur Verfügung gestellte Token benötigt, um die Codes, die im Seekda System konfiguriert sind, abrufen zu können.
Gibt den aktuellen Verfügbarkeitskalender für ein Zimmer aus. Dabei wird Tagesaktuell der Preis für jeden Tag ausgegeben. Bei erfolgter Personenauswahl wird der Gesamtpreis ermittelt und angezeigt.
| Attribut | Type | Beschreibung |
| room | String (required) | Der Zimmer-Code aus dem Seekda System |
Verfügbarkeitskalender Live-Beispiel
Gibt eine Liste aller aktuell verfügbaren Pauschalen aus. Die Kategorien aus Seekda können ausgelesen und entsprechend gefiltert werden. Die Detailansicht der Pauschale kann in der Lightbox geöffnet werden. Wird beim Script im <head>-Element das Attribut data-package-detail-href angegeben, wird bei Klick auf Detail die entsprechende URL aufgerufen. Auf der Zielseite muss das Widget Pauschal-Detail eingebaut werden.
| Attribut | Type | Beschreibung |
| categories | String (optional) | Ein oder mehrere Kategorie-Codes (kommasepariert) aus dem Seekda System. Dient zur Einschränkung der ausgegebenen Kategorien und den zugeordneten Pauschalen. Wenn keine Kategorien angegeben sind, werden alle im System vorhandenen Kategorien ausgegeben, zu denen aktive Pauschalen gefunden werden. |
Pauschalen-Liste Live-Beispiel
Gibt eine Swiperansicht der aktuell verfügbaren Pauschalen aus. Es ist möglich, die Ansicht auf eine bestimmte Pauschalkategorie einzuschränken. Die Detailansicht der Pauschale kann in der Lightbox oder einer eigenen Seite geöffnet werden.
| Attribut | Type | Beschreibung |
| category | String (optional) | Der Kategorie-Code aus dem Seekda System Wenn das Attribut vorhanden ist, werden Pauschalen aus dieser Kategorie angezeigt. Wenn das Attribut nicht vorhanden ist, werden alle verfügbaren Pauschalen angezeigt. |
Pauschalen-Swiper Live-Beispiel
Die Detailansicht einer Pauschale. Der verfügbare Zeitraum wird ebenso ausgegeben wie die buchbaren Zimmer und die Pauschalbeschreibung. Bei Auswahl der Personenanzahl wird live der Preis ermittelt. Wird von einer Pauschalen-Liste oder vom Pauschalen-Swiper zu diesem Widget gelinkt, wird automatisch die richtige Pauschale ausgegeben. Mittels Attribut kann aber auch eine bestimmte Pauschale vordefiniert werden.
| Attribut | Type | Beschreibung |
| package | String (optional) | Der Package-Code aus dem Seekda System Wenn das Attribut vorhanden ist, wird diese Pauschale angezeigt. Wenn das Attribut nicht vorhanden ist, wird der Package-Code aus dem URL Parameter ausgelesen (z. B. ?package=[PACKAGE_CODE]) |
Pauschalen-Detail Live-Beispiel
Entspricht der Standard Detailansicht einer Pauschalen, wird aber um einige Features reduziert. Der Fokus dieses Widgets liegt am Verfügbarkeitskalender und den buchbaren Zimmern.
| Attribut | Type | Beschreibung |
| package | String (required) | Der Package-Code aus dem Seekda System |
Pauschalen-Detail Simple Live-Beispiel
Gibt eine Liste von Zimmern aus. Es können einzelne Zimmer-Codes im rooms-Attribute angegeben werden oder alle Zimmer ausgegben werden. Die Detailansicht der Zimmer kann in der Lightbox geöffnet werden. Wird beim Script im <head>-Element das Attribut data-room-detail-href angegeben, wird bei Klick auf Detail die entsprechende URL aufgerufen.
| Attribut | Type | Beschreibung |
| rooms | String (optional) | Ein oder mehrere Zimmer-Codes (kommasepariert) aus dem Seekda System |
Zimmerliste Live-Beispiel
Bei der Rateplan-Liste muss eine Rateplan-Kategorie angegeben werden. Die zugeordneten Raten werden in einem Kalender mit Liste ausgegeben.
Um die Rateplan-Liste verwenden zu können, muss die Restplatzbörse-Erweiterung gebucht sein. Für mehr Informationen kontaktieren Sie bitte ihren Widget-Partner oder uns unter support@bakehouse.at
| Attribut | Type | Beschreibung |
| category | String (required) | Der Kategorie-Code aus dem Seekda System |
Restplatzbörse Beispiel-Screenshot
Wenn ein/e Besucher:in in den Widgets auf einen Anfragebutton klickt, werden alle vorhandenen Werte als GET-Parameter übergeben. Diese Daten können auf Wunsch ausgelesen und ins Anfrageformular übertragen werden. Diese Übernahme und Ausgabe muss durch den/die Integrator:in des jeweiligen Online-Projekts erfolgen.
| Parameter | Type | Beschreibung |
| checkin | Date (yyyy-mm-dd) | Anreisedatum |
| checkout | Date (yyyy-mm-dd) | Abreisedatum, immer vorhanden wenn checkin vorhanden ist |
| adults | Integer | Anzahl der Erwachsenen |
| children | Integer | Anzahl der Kinder |
| age_of_child_[X] | Integer | Alter von einem Kind Das "[X]" steht für das Kind, z. B. bei 2 Kinder mit 2 und 5 Jahren gibt es "age_of_child_1=2" und "age_of_child_2=5" |
| room | String | Zimmer Code aus dem Seekda System, z. B. "ROOM_1" |
| mealplan | Integer | Verpflegungsart, die zu einem Rateplan bei Seekda hinterlegt ist (die Liste der IDs ist vorzugsweise bei Seekda zu entnehmen, die Liste anbei dient zur schnellen Übersicht)
|
| package | String | Pauschalen Code aus dem Seekda System, z. B. "PACK_1" |
Dieses Event wird gefeuert, wenn ein Anfrage Button geklickt wurde. Die ursprüngliche Intention war, eine Möglichkeit zu bieten, um das Standardverhalten unterbinden zu können, um eventuell eine eigene Parameterübergabe Methode zu integrieren. Ansonsten kann man dies auch für das Tracking verwenden.
| Event | Type | Beschreibung |
| hapi-inquiry-click | CustomEvent | cancelable = true bubbles = true detail = Beschreibung im nächsten Punkt "Übergebene Daten" |
Übergebene Daten
| Event | Type | Beschreibung |
| inquiryUrl | String (URL) | Die im Widget eingestellte Inquiry URL |
| url | String (URL) | Die URL, die der ursprüngliche Klick aufgerufen hätte |
| params | Object | Siehe Punkt "Paramaterübergabe an das Anfrageformular" |
Beispiel:
Dieses Event wird auf dem window ausgelöst, wenn das Hauptscript komplett geladen wurde. Zu diesem Zeitpunkt ist das Widget-Script zwar geladen, aber die benötigten Seekda-Daten werden erst angerufen.
Einige Funktionen der Widgets senden direkte Anfragen an Seekda Server. Das ist notwendig, um standort- und geräteabhängige Informationen korrekt weiterzuleiten. Durch diese Anfragen können Cookies von Seekda gesetzt werden, auf die die Cookis GmbH (Bakehouse) keinen Einfluss hat. Die Widgets selbst setzen das Cookie hapi_session, das die jeweilige Benutzersession speichert, um Preise und Verfügbarkeiten der Bakehouse Hotel API richtig zu übermitteln, und von Servern innerhalb der EU abgerufen wird. Für Informationen zu den Seekda Cookies kontaktieren Sie bitte direkt den Seekda-Support unter support@seekda.com. Für weitere Informationen steht unser Team unter support@bakehouse.at jederzeit gerne zur Verfügung. (Stand November 2022)