Objekt
Die Objekteinbindung beinhaltet die vollständige Darstellung einer Unterkunft mit allen (vor-)konfigurierten Ausgabemöglichkeiten. Von hier ist es ebenfalls möglich direkt eine Buchung oder Anfrage zu starten. Die benötigten Module werden hierzu im Bedarfsfall automatisch nachgeladen und eingebunden.
Beispielansicht für den Anfang einer Objektseite
Elemente (Sub-Module)
Die Detailsseite eines Objekts besteht aus verschiedenen Elementen, die nachfolgend kurz benannt werden:
Einleitung
Hauptbild mit den wichtigsten Informationen und ein kurzer Einleitungstext
Buchungs-Widget
Zentrale Stelle zur Prüfung der Verfügbarkeit und Berechnung des Reisepreises (kann mehrfach innerhalb einer Objektseite vorkommen)
Bildergalerie
Anzeige der hinterlegten Bilder (inkl. 360°-Bilder - sofern vorhanden).
Ausstattung
Auflistung aller, zur Ausstattung gehörender, Merkmale.
Saisonpreise
Tabellarische Darstellung aller Saisonzeiten/-preise inkl. der wichtigsten Detailinformationen.
Belegungsplan
Kalendarische Jahresübersicht der freien und bereits gebuchten Tage.
Lage und Entfernungen
Übersicht der Lage des Objekts und der hinterlegten Entfernungen zu relevanten Orten.
Beschreibung
Beschreibungstext des Objekts
Kontakt
Kontaktmöglichkeiten zu diesem Objekt
(Dies ist eine Beispielliste von möglichen Elementen und muss nicht zwangsläufig die exakte Ausgabe jedes Objekts widerspiegeln!)
Einbindung
Für die Einbindung des Widgets muss der OP Client geladen sein (siehe Installation).
Der Elementname für die Einbindung des Widgets lautet op-frontend-object.
<div id="op_content_box">
<script type="text/javascript">
// diese Werte können/müssen angepasst werden:
var loadOptions = {
module: 'op-frontend-object', // Name des zu ladenden Moduls
content_id: 'op_content_box', // ID des HTML Elements, in das der Inhalt geladen wird
options: {
//useCookies: true,
//hasOwnCookieInfo: false,
//languageSwitcherEnabled: true,
//scrollTopOffset: 10,
//scrollToTop: true,
//alwaysShowExtendedFilters: true,
//enableShare: false,
//limit: {
//ToNr: [123],
//GaGeNr: [123,456,789],
//ObjMetaNr: [123],
//OrtNr: [123]
//}
}
};
// diesen Code nicht mehr ändern!
var secra_op_client;
if(secra_op_client){
secra_op_client.loadModule(
loadOptions['module'],
loadOptions['content_id'],
loadOptions['options']
);
} else {
secra_op_client = {};
secra_op_client.loadQueue = [];
secra_op_client.loadQueue.push({
module: loadOptions['module'],
embed_id: loadOptions['content_id'],
options: loadOptions['options']
}
);
}
</script>
</div>
Optionen
Dies sind die möglichen Optionen die bei der Einbindung angegeben werden können.
| Option | Typ | Werte | Standard | Erklärung |
|---|---|---|---|---|
| useCookies | Bool | true,false | true | deaktiviert die Nutzung von Cookies für diese Einbindung (nicht empfohlen) |
| hasOwnCookieInfo | Bool | true,false | false | gibt an, ob ein eigener Cookiehinweis auf der Seite vorhanden ist, falls nicht, wird auf Seiten mit Inhalten aus der OP ggf. ein Cookiehinweis angezeigt |
| languageSwitcherEnabled | Bool | true,false | true | aktiviert oder deaktiviert die Sprachumschaltungsoption |
| scrollTopOffset | Integer | 0 | gibt die Höhe des Headers der Webseite an, damit bei Scroll-to-Top Aktionen an die richtige Position gescrollt wird (und nicht über die Einbindung höher oder tiefer hinaus) | |
| scrollToTop | Bool | true,false | true | wenn aktiviert wird dynamisch ein Scroll-To-Top Button in der unteren rechten Ecke angezeigt, deaktivieren, wenn schon einer auf der Seite vorhanden ist |
Routen
Die Objektseite unterstützt die Verwendung folgender Routen für den direkten Aufruf.
| Aktion | Default | Route | Beispiel URL |
|---|---|---|---|
| Objektseite laden | nein | /object/:metaid | http://www.demo.me/demo.php#!m/object/220 |
URL Parameter
Die Objektseite kann zum initialen Start mit GET Parametern (die Bestandteil der Route sein müssen - s. Beispiel) aufgerufen werden. Mit diesen werden die Buchungseingaben gesteuert. Damit sind Sie in der Lage, bereits beim Öffnen einer Objektseite evtl. vorher gewählte Buchungsdaten an das Buchungswidget in der Objektseite zu übergeben.
| Parameter | Werte | Funktion | Beispiel |
|---|---|---|---|
arrival |
Date(EN) | englisches Anreisedatum (YYYY-MM-DD) | "2017-01-31" |
departure |
Date(EN) | englisches Abreisedatum (YYYY-MM-DD) | "2017-02-28" |
adults |
Integer | Anzahl der Erwachsenen | "3" |
childs |
Integer | Anzahl der Kinder | "2" |
age |
CSV (Integer) | Alter der Kinder als CSV-Liste | "5,11" |
https://www.musterhausen.de/object.php?#!m/object/202?arrival=2018-03-01&departure=2018-03-08&adults=2
Beispiel
Dieses Beispiel zeigt exemplarisch eine Einbindung mit allen Optionen. In der Praxis sollten Sie nur die Optionen angeben, die Sie auch benötigen.
<div id="op_content_box">
<script type="text/javascript">
secra_op_client.loadModule(
'op-frontend-object',
'op_content_box',
{
hasOwnCookieInfo: false,
alwaysShowExtendedFilters: true,
limit: {}
});
</script>
</div>