Die Anmeldeformulare können über Verowa sehr flexibel konfiguriert werden. Die webseitige Anzeige ist entsprechend mit einem nicht unerheblichen Aufwand verbunden. Aus diesem Grund verzichten viele Agenturen darauf, die Anmeldungen selber zu implementieren, und binden Anmeldeformulare stattdessen über ein iFrame ein, das Picture-Planet zur Verfügung stellt. Technisch sind das kleine WordPress-Webseiten, die das kostenlose Plugin Verowa-Connect nutzen. Das Plugin hat die Anmeldeformulare bereits integriert und kann für die Darstellung externe CSS-Dateien verwenden, so dass die Formulare nahtlos zum Design Ihrer Webseite passen. Falls Sie diese Variante bevorzugen, nehmen Sie bitte mit uns Kontakt auf!
Einzelne Schritte
Ist über geteventdetails das Feld subs_state nicht none, gibt es für die betreffende Veranstaltung eine Anmeldemöglichkeit.
1. Anmelde-Button und -formular zusammenstellen
Die API gibt über get_subscription_form alle nötigen Informationen mit, um das gesamte individuelle Anmeldeformular zusammenzubauen. Die Feldbeschreibungen sind auf einer separaten Seite im Detail zusammengestellt.
Zusätzlich erhalten Sie mit get_subscription_form die Anzahl der aktuell verfügbaren Plätze, den Anmeldeschluss, direkt verwendbare Textbausteine etc. Z.B. gibt es einen Textvorschlag für die Beschriftung des Anmelde-Buttons. Er kann statt «Anmelden» etwa auch mit «ausgebucht» oder «Warteliste» beschriftet und deaktiviert sein, je nach Kontext.
Achtung: Falls Sie die Verowa-Veranstaltungsdaten lokal verwalten, empfiehlt es sich, die aktuellen Infos zur jeweiligen Veranstaltung direkt beim Aufbau des Anmeldeformulars nochmals in Echtzeit vom Verowa-Server zu holen, damit Sie auf jeden Fall die aktuelle Zahl der freien Plätze zur Verfügung haben.
Verowa gibt in get_subscription_form auch alle Restriktionen mit, damit Sie die Feldinhalte bereits Client-seitig mit JavaScript validieren können. Verowa wird die Werte aber vor dem Speichern auf jeden Fall selbst nochmals prüfen und ggf. passende Fehlermeldungen zurückgeben.
Falls Sie zusätzlich einen Honeypot oder eine Captcha-Funktion implementieren möchten, können Sie das gut im Formular ergänzen. Verowa setzt von sich aus keine solchen Funktionen ein.
2. Formulardaten senden
Senden Sie die Formulardaten via subscribe_to_event über AJAX an Verowa zurück. Falls Verowa in einem Feld ungültige Daten entdeckt oder ein Pflichtfeld leer ist, gibt es eine entsprechende Fehlermeldung zurück. Lassen Sie in diesem Fall das Formular offen und zeigen Sie die Fehler an. (In sehr speziellen Fällen können die Standard-Fehlermeldungen in Verowa vom Admin überschrieben werden. Es empfiehlt sich also, immer den von Verowa zurückgemeldeten Text auszugeben.)
Wenn alles passt, fügt diese Funktion die Angaben in die Verowa-Datenbank ein und verschickt ein entsprechendes Mail an den User.
Falls für das Formular das Double-opt-in-Verfahren nicht aktiviert ist, was Verowa-seitig konfiguriert wird, ist damit schon alles erledigt. Springen Sie direkt zu Schritt 4.
3. Optional: Zwischenschritt fürs Double-opt-in-Verfahren
Falls für das Formular das Double-opt-in-Verfahren aktiviert ist, ist das Mail aus dem Schritt 2 nur das erste von zweien: Es enthält den Bestätigungslink. Leiten Sie den User nun auf eine Seite weiter, die auffällig darauf hinweist, dass es eine zusätzliche Aktion braucht, damit seine Anmeldung gültig wird. Bewährt hat sich z.B. der Titel «Bitte bestätigen!»
Der Link ist nur für eine gewisse Zeit gültig, typischerweise 30 Minuten. Über Verowa kann dieses Zeitfenster konfiguriert werden. In dieser Zeit bleiben die Plätze reserviert, deshalb sollte es nicht zu gross sein. Der Link enthält als Parameter die Laufnummer der Anmeldung (Subs-ID) sowie einen Key.
Klickt der User auf den Bestätigungslink im Mail, erreicht er ein Ziel auf Ihrer Webseite. Diese Seite ruft – ebenfalls via AJAX die Funktion validate_subscription auf. Damit markiert Verowa die Anmeldung als bestätigt, verschickt ein entsprechendes Mail an den User und gibt die Angaben für den Schritt 4 zurück: die URL für die Bestätigungsseite inkl. der passenden Textbausteine. Leiten Sie den User entsprechend weiter und geben Sie die Parameter von der API via POST an die Zielseite mit.
4. Bestätigung für den User
Zeigen Sie dem User eine nette Bestätigung und Möglichkeiten für die nächsten Schritte (z.B. «Zurück», «Kalender-Export», «Details zur Veranstaltung», «zur Agenda»). Wenn Sie einen Kalender-Export anbieten möchten, können Sie dafür direkt die Verowa-Funktion nutzen, indem Sie den Link nach folgendem Muster zusammensetzen: https://verowa.ch/beispielgemeinde/export/ical/e12345
Falls das Formular entsprechend konfiguriert ist (siehe Parameter support_next_subs in der Antwort der Funktion subscribe_to_event), sollte ein Knopf für «Weitere Anmeldung» angeboten werden. In diesem Fall wird das Formular für die einfachere Handhabung anhand der vorangehenden Anmeldung teilweise schon ausgefüllt sein. Geben Sie der Funktion get_subscription_form einfach den Parameter subs_id mit, Verowa kümmert sich um den Rest.
Möchten Sie ein mehrsprachiges Projekt umsetzen? Verowa ist auch dafür gerüstet und kann die Labels und Texte in verschiedenen Sprachen zurückgeben. Bitte wenden Sie sich an den Verowa-Support!