Zum Inhalt springen
Developer

Widget Registrierung und Mitgliedsantrag

Neue Mitglieder registrieren sich auf eurer Website, allein oder als Familie, mit Mitgliedschaft, Bankverbindung, SEPA-Mandat und Einwilligungen.

Mit diesem Widget registrieren sich neue Mitglieder und Kunden selbst. Es gibt zwei Formen, beide im selben Script:

Form für Platzhalter
Registrierung eine Person, Schritt für Schritt data-iw-registration
Mitgliedsantrag mehrere Personen in einem Antrag, etwa eine Familie data-iw-registration data-iw-people="multi" 
<div data-iw-registration
     data-iw-host="verein.iw-erp.de"
     data-iw-people="multi"
     data-iw-max-people="6"
     data-iw-shared-last-name="true"></div>
<script src="https://verein.iw-erp.de/frontend_assets/backend/iw_erp_web_ui/registration.js" async></script>

Shortcodes: [iw-registration host="verein.iw-erp.de"] und [iw-registration host="verein.iw-erp.de" people="multi"]

Welche Mitgliedschaften und Produkte zur Auswahl stehen, welche Pflichtfelder gelten und ob ein neues Konto angelegt wird, legt ihr in vynst bei der Selbstregistrierung fest. Das Widget zeigt genau das an.

Optionen für beide Formen

Attribut Standard Bedeutung
data-iw-invite-code leer Einladungscode, etwa für einen bestimmten Tarif. Kurz: data-iw-code
data-iw-require-acceptance an Pflicht-Haken für Bedingungen und Datenschutz
data-iw-conditions-text, data-iw-privacy-text Standardtexte Text der beiden Haken
data-iw-cancellation-text, data-iw-disclaimer-text leer zusätzliche Haken für Widerruf und Haftung, nur wenn ein Text gesetzt ist
data-iw-show-but-fields aus Felder für Bildung und Teilhabe
data-iw-require-but-number aus BuT-Nummer wird Pflicht
data-iw-activate-sepa-payment an erfasste Bankdaten als SEPA-Lastschrift aktivieren
data-iw-success-redirect-url leer nach dem Absenden auf diese Seite wechseln
data-iw-local-storage-key automatisch Schlüssel für zwischengespeicherte Eingaben; setzen, wenn ihr den Platzhalter per JavaScript einfügt
data-iw-render shadow light: in die Seite rendern, damit euer CSS greift; mit data-iw-styles="none" ganz ohne eigenes CSS des Widgets

Nur Registrierung

Attribut Standard Bedeutung
data-iw-registration-flow auto unified (mit Mitgliedschaft und Bankdaten), basic (nur Stammdaten) oder auto (erst unified, sonst basic)
data-iw-show-birthday aus Geburtsdatum abfragen
data-iw-minor-requires-guardian aus bei Minderjährigen Angaben der Erziehungsberechtigten verlangen

Nur Mitgliedsantrag

Attribut Standard Bedeutung
data-iw-min-people, data-iw-max-people 1, unbegrenzt Anzahl Personen
data-iw-max-adults unbegrenzt höchstens so viele Volljährige
data-iw-adult-age 18 ab diesem Alter volljährig
data-iw-shared-last-name aus ein Nachname für alle
data-iw-main-product aus je Person eine Hauptmitgliedschaft wählen
data-iw-entry-date-months 3 so viele Monatsersten stehen als Eintrittsdatum zur Wahl
data-iw-photo-consent aus Foto-Einwilligung je Person
data-iw-referral-code aus Feld für einen Werbe-Code
data-iw-show-comment-field aus Kommentarfeld in der Zusammenfassung
data-iw-show-intro an Startseite vor dem Antrag
data-iw-iban-lookup an Bank und BIC aus der IBAN ermitteln
data-iw-persist an angefangene Eingaben zwischenspeichern
data-iw-rules-url, data-iw-rules leer Regeln für Beiträge und Kombinationen als JSON (Datei auf eurer Website oder direkt im Attribut)
data-iw-calculator aus Beitragsrechner statt Antrag, braucht Regeln; data-iw-application-url verlinkt zum Antrag

In vynst einrichten

  • Registrierungs - Modus (iw_self_sign_up_mode) darf nicht NONE sein. Erlaubt sind NEW_ACCOUNT, EXISTING_ACCOUNT und BOTH. Bei NONE lehnt vynst das Absenden ab.
  • Die Mitgliedschaften und Produkte für die Selbstregistrierung freigeben.
  • Eure Website in CORS - HTTP Origins eintragen.

Ereignisse

Registrierung: iw:registration:ready, :validated, :submitted, :error. Mitgliedsantrag: iw:register-multi-person:ready, :validated, :submitted, :error, beim Rechner :apply. Die Ereignisse des Mitgliedsantrags enthalten nur Zahlen wie Schritt, Anzahl Personen und IDs, keine persönlichen Daten.

API

Das Widget nutzt GET /api/cp/signup/unified_start/json (oder /api/cp/signup/start) zum Start und POST /api/cp/signup/finish/{token} zum Absenden, beim Mitgliedsantrag mit allen weiteren Personen in einem Aufruf.