Angebotsliste-Widget Seitenreferenz

Das Angebotsliste-Widget zeigt auf einer Seite eines SiMedia Tourismusportals die Angebote (Pauschalen) der Betriebe als Karten. Besucher können nach Zeitraum filtern, weitere Angebote nachladen und ein Angebot entweder direkt beim Betrieb öffnen oder in einem Overlay ansehen und dort anfragen. Die Angebote stammen aus der Seite Angebote, die die Betriebe im Mandant-Dashboard pflegen. Betriebe richten das Widget nicht selbst ein. Es wird für jedes Portal im Portalsystem konfiguriert und auf der Portalseite eingebunden.

Einbindung

Das Widget besteht aus einem Skript, einer CSS-Datei und dem Element <offerlist-widget>. Die Optionen stehen im globalen Objekt window.GLOBAL_SI_PORTAL_WIDGETS unter derselben ID wie im Attribut portal-widget-id.

<script
  type="module"
  defer
  src="https://widgets.cloud.anex.is/portals/offerlist-widget/offerlist-widget.js"
></script>
<link
  rel="stylesheet"
  href="https://widgets.cloud.anex.is/portals/offerlist-widget/offerlist-widget.css"
/>

<script>
  window.GLOBAL_SI_PORTAL_WIDGETS = window.GLOBAL_SI_PORTAL_WIDGETS || {}
  window.GLOBAL_SI_PORTAL_WIDGETS[1] = {
    api_key: '<Konfigurations-ID>::1',
    type: 'request',
    showFilter: true,
    page_size: 6,
    detail_paths: { 1: '/unterkuenfte-detail/?id=[id]---[rewrite_key]' },
  }
</script>
<offerlist-widget portal-widget-id="1"></offerlist-widget>

Die Testversion liegt unter https://widgets.cloud.anex.is/portals/TESTS/offerlist-widget/.

Attribut

Attribut	Gültige Werte	Hinweise
`portal-widget-id`	Text	Pflicht. Schlüssel in `window.GLOBAL_SI_PORTAL_WIDGETS`. Fehlt das Attribut, startet das Widget nicht.

Optionen

Die Optionen schreibst du in Kleinbuchstaben mit Unterstrich, außer showFilter.

Option	Gültige Werte	Hinweise
`api_key`	`<Konfigurations-ID>::<Portalsprache>`	Pflicht. Ohne gültigen Schlüssel werden keine Angebote geladen. Die Zahl nach `::` legt die Sprache fest, siehe Sprachen.
`type`	`click`, `request`	Standard: `click`. Bei `click` öffnet die Karte die Angebotsseite des Betriebs in einem neuen Tab. Bei `request` öffnet die Karte das Anfrage-Overlay.
`showFilter`	`true`, `false`	Standard: `false`. Blendet den Datumsfilter ein.
`static`	`true`, `false`	Standard: `false`. Bei `true` sind Filter, Weitere laden und die Trefferzahl ausgeblendet. Es erscheint nur die erste Seite.
`page_size`	Ganzzahl	Standard: 3. Anzahl Angebote pro Seite.
`sorting`	Objekt `{ type: <Zahl> }`	Standard: `{ type: 1 }`. Wird unverändert an das Portalsystem übergeben.
`detail_paths`	Objekt `{ <Portalsprache>: "<Pfad>" }`	Pfad zur Detailseite der Unterkunft je Sprache, mit den Platzhaltern `[id]` und `[rewrite_key]`. Ohne Eintrag fehlt im Overlay der Link Details der Unterkunft.
`style_variables`	Objekt mit CSS-Variablen	`--ctaButton-bg` (Standard `#2c2b30`) und `--ctaButton-color` (Standard `#fff`) für die Schaltflächen.

Sprachen

Das Widget zeigt seine Texte auf Deutsch, Italienisch oder Englisch. Die Sprache ergibt sich aus der Portalsprache in api_key: 1 = Deutsch, 2 = Italienisch, 3 = Englisch. Österreich (9) und Schweiz (10) erscheinen auf Deutsch, alle anderen Portalsprachen auf Englisch.

Darstellung

Filter

Nur mit showFilter: true.

Element	Hinweise
Anreise und Abreise	Kalender für den Zeitraum, ab heute. Sobald An- und Abreise gewählt sind, lädt die Liste neu.
Suchen	Ohne eigene Funktion. Die Liste lädt bereits nach der Datumsauswahl.
Filter löschen	Erscheint nach dem Filtern und setzt den Zeitraum zurück.

Über der Liste steht die Trefferzahl, z. B. „Es wurden 12 Angebote gefunden“, oder „Es wurden keine Angebote gefunden“.

Angebotskarte

Bereich	Inhalt
Bild	Erstes Bild des Angebots.
Angebot	Titel und Vorschautext (höchstens drei Zeilen).
Betrieb	Klassifizierung (Sterne, Sonnen oder Blumen, ggf. „Superior“), Name, CIN-Codes und Ort.
Zeitraum	Erster Zeitraum des Angebots, bei mehreren zusätzlich z. B. „(2 alternative Zeiträume)“.
Preis	Z. B. „7 Nächte ab 840 € pro Person“.
Schaltfläche	Zum Angebot bei `type: click` (öffnet die Angebotsseite des Betriebs in einem neuen Tab), Alle Details bei `type: request` (öffnet das Overlay).

Unter der Liste lädt Weitere laden die nächste Seite nach, solange es weitere Angebote gibt.

Anfrage-Overlay

Nur bei type: request. Das Overlay zeigt untereinander:

Titel, Bild und Vorschautext des Angebots.
Zeiträume: alle Zeiträume mit Nächten und Preis ab.
Anfragen: springt zum Anfrageformular weiter unten.
Inklusivleistungen: die im Angebot enthaltenen Leistungen.
Beschreibung: der Detailtext des Angebots.
Bilder, Klassifizierung, Name und Ort des Betriebs und der Link Details der Unterkunft (neuer Tab, nur mit detail_paths).
Das Anfrageformular des Betriebs aus dem eAssistant. Im Kommentarfeld stehen bereits Titel, Vorschautext und Zeiträume des Angebots.

Das X oben rechts oder ein Klick neben das Overlay schließt es.

Abhängigkeiten

Das Widget zeigt nur Angebote, die die Betriebe auf der Seite Angebote veröffentlicht haben.
Antwortet das Portalsystem mit einem Fehler, zeigt das Widget „Es wurden keine Angebote gefunden“. Eine eigene Fehlermeldung gibt es nicht.
Geladene Angebote und der gewählte Zeitraum werden zehn Minuten im Browser des Besuchers zwischengespeichert. Änderungen an Angeboten erscheinen deshalb mit bis zu zehn Minuten Verzögerung.

Mandant

Allgemein

SiMedia Tourismusportale

BOOKED!

Portalverwaltung

CONNECT!

VOUCHER!

Einstellungen

Angebotsliste-Widget Seitenreferenz

Einbindung

Attribut

Optionen

Sprachen

Darstellung

Filter

Angebotskarte

Anfrage-Overlay

Abhängigkeiten

Verwandte Artikel

​Einbindung

​Attribut

​Optionen

​Sprachen

​Darstellung

​Filter

​Angebotskarte

​Anfrage-Overlay

​Abhängigkeiten

​Verwandte Artikel

Einbindung

Attribut

Optionen

Sprachen

Darstellung

Filter

Angebotskarte

Anfrage-Overlay

Abhängigkeiten

Verwandte Artikel