Partner Widget 1.0
Drupal B2B Rest Client
Unser drittes Projekt für HolidayCheck ist eine B2B-Anwendung. Als führender Anbieter von Hotelbewertungen im deutschsprachigen Raum stellt die HolidayCheck AG ihre enorme Datenbasis via REST API Reiseveranstaltern zur Verfügung, die Partner des Unternehmens sind. Zielsetzung des Projekts war es, den Partnern eine einfachere Möglichkeit zu bieten, die Datenbasis in Ihre Websites zu integrieren, ohne dass dort noch eigens Anbindungen zur REST-Schnittstelle programmiert werden müssen.
Das Drupal-Framework erwies sich dabei wiederum als hochflexibler Alleskönner: In Drupal selbst werden nur die Daten über die Partner (Berechtigungen, Einstellungen und Ausgabestile) gespeichert. Beim Aufruf des Partner-Widgets kommuniziert Drupal über den internen HTTP-Client mit der Holiday-Check API, um die angeforderten Informationen dann als HTML-Dokument darzustellen.
Bestandteile
Das Partner-Widget stellt in verschiedenen Sprachen zwei Teile zur Verfügung: die Ansicht von Hotelbewertungen (und ggf. Medien) und die Bewertungsstrecke zur Abgabe von Hotelbewertungen. Die Partner von HolidayCheck können beide Teile als fertiges HTML in ihre Websites und Shops integrieren, sei es als PopUp-Fenster oder mittels iframe. Die Auswahl des Partners und des anzuzeigenden Hotels wird dabei durch die URL gesteuert: ein Parameter legt den Partner fest, der andere das Hotel, zu dem Informationen angezeigt werden sollen.
Theming und Konfiguration von Partnern
Im Backend lassen sich bei HolidayCheck Partner anlegen und verwalten. Jeder Partner verfügt verschiedene Optionen zur Ausgabe der Informationen. So können etwa Schriftstile und Farbschema gemäß dem Corporate Design des jeweiligen Partners angegeben werden. Auch die für den Partner angepasste Ausgabe des Partner Widgets wird darin gesteuert - so lässt sich festlegen, ob der jeweilige Partner Zugriff auf Bildmaterial hat oder ob über seinen Zugang Hotelbewertungen abgegeben werden können.
![partner-widget-data.png](/sites/default/files/styles/crop_none_6col_variable_height_sm_1x_w246/public/media/image/partner-widget-data.png?itok=nS4gTnC5)
Partner Widget Daten
Drupal Modul-Programmierung: Schnittstelle zur API
Ein eigens programmiertes Modul stellt die Anfragen an die HolidayCheck API. Dabei wird der Datensatz zum angeforderten Hotel abgerufen und durch Drupal zur Ausgabe aufbereitet. Da Aufrufe an die API und die Aufbereitung Ressourcen und vor allem Zeit kosten, ist in dem Modul ein Caching-Mechanismus integriert. Die abgerufenen Hotelinformationen können für einen frei festzulegenden Zeitraum zwischengespeichert werden.
Beim Abgeben von Hotelbewertungen werden die Daten zunächst in einem mehrstufigen Formular durch Drupal erfasst und validiert. Sind die Daten alle gültig, werden sie wiederum per POST-Aufruf durch den internen HTTP-Client an die REST-API zu HolidayCheck gesendet.
![partner-widget-frontend-1.png](/sites/default/files/styles/crop_none_6col_variable_height_sm_1x_w246/public/media/image/partner-widget-frontend-1.png?itok=WhSYQHaQ)
Partner Widget Frontend
Tracking von Aufrufen und Bewertungsabgaben
Ein weiteres Drupal-Modul, das für das HolidayCheck Partner Widget entstanden ist, dient dem Tracking von Aufrufen. Die Aufrufe des Partner Widgets werden für jeden einzelnen Partner erfasst, damit eine Auswertung der Nutzung des Dienstes möglich ist. Separat wird zudem protokolliert, wie viele Bewertungen angefangen und wie viele tatsächlich über die API eingereicht wurden. Die gesamten protokollierten Daten können als CSV-Datei zur weiteren Verarbeitung und Archivierung exportiert werden.