Zum Inhalt springen
Developer

Widget Veranstaltungsanmeldung

Anmeldung zu Kursen, Veranstaltungen und einzelnen Terminen direkt auf eurer Website, mit Produkten, Pflichtangaben und Zahlung.

Das Widget zeigt eine Veranstaltung aus vynst (inwendo ERP) mit Terminen, Ort und Preisen und nimmt Anmeldungen an. Es fragt genau die Angaben ab, die ihr an der Veranstaltung eingestellt habt, prüft freie Plätze und Anmeldezeitraum und öffnet bei Bedarf die Zahlung.

<div data-iw-event-signup
     data-iw-host="verein.iw-erp.de"
     data-iw-event-id="523"></div>
<script src="https://verein.iw-erp.de/frontend_assets/backend/iw_erp_web_ui/event-signup.js" async></script>

Shortcode: [iw-event-signup host="verein.iw-erp.de" event-id="523"]

Welche Veranstaltung

Attribut Bedeutung
data-iw-event-id ID oder Kurzname (Slug) der Veranstaltung. Kurz: data-iw-event
data-iw-event-token Token einer nicht öffentlichen Veranstaltung (beginnt mit EBE)
data-iw-invite-token Token einer Einladung (beginnt mit BEIV)
data-iw-booking-id nur diesen einen Termin anbieten
data-iw-selected-product dieses Produkt vorauswählen

Gebt Token nur an, wenn ihr sie habt. Platzhalter wie optional würden als echter Token gesendet.

Weitere Optionen

Attribut Standard Bedeutung
data-iw-redirect-payment an false: Zahlungsseite nicht automatisch öffnen, nur den Link anzeigen
data-iw-success-payment-base-url Zahlungsseite von vynst eigene Adresse für den Zahlungslink, der Zahlungs-Token wird angehängt
data-iw-session-token leer Sitzung eines angemeldeten Mitglieds, dann meldet sich das Mitglied mit seinem Konto an
data-iw-theme…, data-iw-text-… Gestaltung und Texte

Texte, die ihr häufig ändert: send (Button), success (Meldung danach), notYetOpen (Anmeldung noch nicht offen), legal (Hinweis zu den Bedingungen).

In vynst einrichten

  • Die Veranstaltung muss öffentlich sein und die Anmeldung über die Website erlauben. Nicht öffentliche Veranstaltungen gebt ihr per data-iw-event-token frei.
  • Eure Website steht in CORS - HTTP Origins, siehe Einbinden.
  • Ist Anmeldung - Mindestversion der App (event_sign_up_allow_self_min_ui_version) gesetzt, muss das Widget mindestens diesen Stand haben. Das Widget meldet sich mit 2026090201. Ein höherer Wert in vynst sperrt Anmeldungen über die Website.
  • Für kostenpflichtige Anmeldungen einen Zahlungsanbieter einrichten.

Ereignisse

iw:event-signup:ready, :validated, :submitted, :payment-opened, :error und :link (Klick auf einen Link im Widget). Ein Beispiel für Google Analytics:

document.querySelector('[data-iw-event-signup]')
  .addEventListener('iw:event-signup:submitted', () => {
    gtag('event', 'sign_up', { method: 'vynst' });
  });

API

Das Widget nutzt GET /api/event/base_event/{id}, POST /api/event/public/test_base_event_signup zur Prüfung und POST /api/event/public/base_event_signup zum Anmelden. Wer ein eigenes Formular bauen will, findet sie unter Veranstaltungen.