Buchungsanfragen für Gruppenangebote erforderten bisher die Anlage einzelner Formulare je Gruppenangebot und Sprache. Formulare können jetzt für Buchungsanfragen für Gruppenangebote als dynamische Formulare angelegt werden.

Folgende Funktionen wurden ergänzt und werden in dieser Anleitung in ihrer Einrichtung beschrieben:

1) die Werte der zu einem referenzierten Angebot zugeordneten Konstanten können automatisch in einem Dropdown / Elementtyp Select ausgegeben und bei Auswahl durch den Nutzer des Formulars in die Buchungsanfrage übernommen werden;

2) weiterhin können standardmäßig die Eingaben der Datenfelder der öffentlichen Daten von einem referenzierten Angebot und dem Museum des Angebots sowie der Ausstellung des Angebots, sofern vorhanden, im Formular als Text angezeigt werden;

3) Die Einbindung per Widget-URL für Webseiten referenziert ein bestimmtes Angebot und ermöglicht die Verwendung eines Formulars für eine beliebige Anzahl an Gruppenangeboten.

Einrichten des Formulars

Richten Sie das Formular nach Bedarf grundlegend ein.

Referenz zu einem Angebot für die Einbindung per Widget-URL herstellen

1. Fügen Sie ein Element vom Typ Hidden Input an einer beliebigen Stelle im Formular ein.

   

2. Fügen Sie in das Feld Name den Parameter request[tour_id] ein, um das Formular mit einem Angebot zu Verknüpfen. Das Feld Value muss leer bleiben.

   

3. Schließen Sie den Vorgang durch Speichern der Änderungen am Ende der Seite ab oder ergänzen Sie weitere Elemente.

Automatische Ausgabe der Werte einer zugeordneten Konstante des referenzierten Angebots einrichten

Die Werte einer dem Angebot zugeordneten Konstante können im Formular automatisch in einem Formularelement vom Typ Select / Dropdown ausgegeben werden. Alle Werte einer Konstante, die dem Angebot zugeordnet sind, werden automatisch gelistet. Es kann eine Konstante in einem Formularelement Select ausgegeben werden.

Dem Angebot neu zugeordnete oder entfernte Werte werden automatisch beim nächsten Aufruf des Formulars aktualisiert. Der vom Nutzer ausgewählte Wert der Konstante wird anschließend in die Buchungsanfrage im go~mus Backend automatisch übernommen.

Die folgenden dem Angebot zugeordneten Konstanten können im Formular dynamisch ausgegeben werden: Altersgruppen, Klassenstufen, Zielgruppen, Schlagworte, Sprachen, Einschränkungen, Besucherkategorien.

1. Fügen Sie ein Element vom Typ Select/Dropdown ein und öffnen Sie das Element zur Bearbeitung.

   

2. Geben Sie unter Name den entsprechenden Parameter wie unten gelistet für die gewünschte Konstante ein.

3. Geben Sie bei Options im rechten Feld unter Value den entsprechenden Parameter wie unten gelistet für die gewünschte Konstante ein.

4. Geben Sie unter Label den Key für die definierte Übersetzung der Bezeichnung des Formularfeldes ein. Informationen zur Erstellung des Keys und zu Übersetzungen finden Sie unter Detailansicht eines Formulars.

   

5. Schließen Sie den Vorgang durch Speichern der Änderungen am Ende der Seite ab.

6. Prüfen Sie die Ausgabe durch Aufrufen des Widgets mit der Widget-URL wie unten beschrieben.

Für die Konstanten sind folgende Parameter zu verwenden:

Es werden nur die zugeordneten Werte in der Ansicht des Formulars über das Widget ausgegeben.

Ausgabe von öffentlichen Daten von Museum, Ausstellung und Angebot im Formular einrichten

Über die ID des Angebots wird in der URL zur Einbindung des iframe-Widgets ein Gruppenangebot referenziert. Für dieses Gruppenangebot können im Formular Daten aus den Öffentlichen Daten von Museum, Ausstellung und Angebot zur Information ausgegeben werden. Die Ausgabe kann mit den Formular-Elementen vom Typ Header oder Paragraph eingerichtet werden.

Folgende Parameter entsprechen den Datenfeldern der öffentlichen Daten und stehen standardmäßig zur Verfügung:

1. Wählen Sie ein Formularelement vom Typ Header oder Paragraph aus, in dem der Inhalt des Datenfeldes der öffentlichen Daten ausgegeben werden soll. Welchen Elementtyp Sie auswählen, hängt davon ab, wie sie die Elemente für die Gestaltung durch die Widgetkonfiguration oder durch die Gestaltung des iframes über Ihre Webseite zur Verfügung stellen wollen. Klassischerweise wird ein Titel in einem Header abgebildet und eine Beschreibung in einem Paragraph-Element.

   

2. 1. Zur Ausgabe der Daten als Header geben Sie im Feld Label den entsprechenden Parameter ein. 

   2. Zur Ausgabe als Paragraph tragen Sie den Parameter im Feld Content ein.

      

3. Konfigurieren Sie die Felder wie gewünscht. Die Eintragung von Übersetzungs-Keys ist nicht notwendig. Die Übersetzungen werden automatisch über die öffentlichen Daten bereit gestellt.

4. Beim Schließen des Elements wird folgende Ausgabe für die Standard-Konfiguration Header mit h1 und Paragraph p für die Eingaben “Titel des Angebots” im Element Header und “Beschreibung des Angebots” im Element Paragraph angezeigt:

   

5. Schließen Sie den Vorgang durch Speichern der Änderungen am Ende der Seite ab.

6. Prüfen Sie die Ausgabe durch Aufrufen des Widgets mit der Widget-URL wie unten beschrieben.

Hinweis: in der Konfiguration von HTML-Elementen im Formular kann es zusammen mit dem Styling per CSS in der Widgetkonfiguration und des Stylings im Editor der Eingabefelder der öffentlichen Daten zu Überlagerungen der Style-Definitionen kommen und die Anzeige gegenseitig beeinflussen. Wir empfehlen das Styling im Editor der öffentlichen Daten zu löschen und das Styling ausschließlich über ein CSS-Style-Sheet in der Widgetkonfiguration durchzuführen.

Alle Informationen zu Elementen, Nomenklatur und Attributen für Formulare sind zu finden unter Neues Formular anlegen.

Anzeige des Formulars über die Widget-URL

Zur Einbindung eines dynamischen Formulars für Buchungsanfragen per i-frame-Widget wird die bestehende Widget-URL erweitert. Benötigt werden zusätzlich:

• ID des Angebots – product_id/tour_id 

• ID des Formulars – form_id 

• API-Key des Formulars – wird am Seitenende der Formularvorlage generiert und ist immer spezifisch zu verwenden

1. Stellen Sie die Widget-URL mit den genannten IDs und dem API-Key des Formulars entsprechend dem folgenden Schema zusammen: https://account.gomus.de/widget/v1/form_api_key/form/form_id?product_id=product_id&form_data[inputs[request[tour_id]]]=tour_id
   
   Die URL sollte wie im folgenden Beispiel aussehen: https://barberini.gomus.de/widget/v1/4c15fbe76467249a2e46831a46f4251c06a49ecfb295836d3167e89cff2e57c5d024307b28bace659e06/form/22?product_id=112&form_data[inputs[request[tour_id]]]=112

2. Geben Sie die URL in die Adressleiste Ihres Browsers ein. Das Formular wird mit den entsprechenden Eingaben aus den öffentlichen Daten und den Werten der Konstanten ausgegeben.

   

3. Um weitere Sprachen anzuzeigen erweitern Sie die URL mit einem locale-Parameter und wählen Sie die gewünschte Sprache. https://account.gomus.de/widget/v1/form_api_key/form/form_id?product_id=product_id&form_data[inputs[request[tour_id]]]=tour_id&locale=language
   
   Am Beispiel für Englisch: https://barberini.gomus.de/widget/v1/4c15fbe76467249a2e46831a46f4251c06a49ecfb295836d3167e89cff2e57c5d024307b28bace659e06/form/22?product_id=112&form_data[inputs[request[tour_id]]]=112&locale=en