Formulare
Mit dem CMS können Formulare auf Webseiten zusammengestellt werden, auf denen der Besucher Daten erfassen kann. Als Elemente kommen typische HTML Eingabeelemente wie Textfelder, Auswahllisten und Optionsfelder zum Einsatz. Der Shop bietet für das Formular vorgefertigte Formular-Aktionen wie z.B. Senden als E-Mail, Senden an einen REST Endpunkt, etc.
Eine der wichtigsten Einsätze von Formularen sind Customizer von Produkten. Beim Klicken auf In den Warenkorb wird eine eigene Seite gestartet, auf der beliebige Formularelemente angeordnet sind. Die Eingaben des Benutzers werden dann zur Bestellposition in den Warenkorb gespeichert. Damit kann das bestellte Produkt angepasst werden, z.B. bei einer bestellten Visitenkarte können Name, Adresse und Kontaktdaten eingegeben werden.
Aktuell sind folgende Formular-Aktionen möglich:
Speichern in den Warenkorb
Speichern in eine Tabelle in der Datenbank
Versenden per Mail
HTTP(S) POST eines Form-Objekts an eine CGI/PHP/ASP URL
HTTP(S) POST eines JSON-Objekts an einen REST Endpunkt
HTTP(S) POST eines XML-Objekts an einen CGI/PHP/ASP URL
Speichern in die aktuelle ASP.NET Session
Starten eines Workflows
Elemente innerhalb eines Formular
Ein Formular ist ein CMS Container und kann deshalb jedes Modul des CMS enthalten. Daten zur Weiterverarbeitung können aber nur von Formularelementen kommen. Das sind
Textfelder
Mehrzeilige Textfelder
Versteckte Felder
Dropdowns
Kontrollkästchen
Optionsfelder
Textfelder können im Typ festgelegt werden. Soweit sie vom Browser unterstützt werden sind das
Text
Zahlen
Datum
Zeit
Woche
Monat
Farbe
EMail
Weiterverarbeitet wird nur der Text in diesen Feldern, aber die Browser zeigen diesen in speziellen Editoren an, z.B. in Form eines Kalenders anstelle der normalen Eingabe eines Datums.
Platzhaltertext in Textfeldern
Bei Textfeldern kann ein Platzhaltertext eingeben werden. Dieser Text wird beim Speichern nicht weiterverarbeitet, sondern zeigt nur dem Benutzer einen Hilfetext an.
Standardwerte der Felder
Bei den Eigenschaften eines Formular Feldes kann nun auch ein Standardwert angegeben werden. Dieser Wert wird beim Anzeigen des Formulars sofort eingesetzt. Im Gegensatz zu Platzhaltertexten wird dieser Text gespeichert, wenn das Formular abgeschickt wird.
Im Gegensatz zu Platzhaltertexten können Standardwerte auch bei mehrzeiligen Textfeldern, Dropdown Feldern, Kontrollkästchen und Optionsfelder benutzt werden.
Im Text der Platzhalterfelder können auch Shortcuts verwendet werden, um den Inhalt mit Variablen zu versehen.
Shortcut | Inhalt |
|---|---|
[date] | Tagesdatum im Format dd.mm.yyyy |
[tomorrow] | Nächster Tag im Format dd.mm.yyyy |
[nextday] | Nächster Werktag im Format dd.mm.yyyy |
[month] | Ausgeschriebener Monat des aktuellen Datums |
[year] | Jahr des aktuellen Datums |
[sessionvariable] | Inhalt der ASP.NET Sessionvariable mit dem Namen sessionvariable |
[urlparameter] | URL Parameter mit dem Namen urlparameter |
[formularfeld] | Formularfeld mit dem Namen formularfeld |
{customernr} | Shop-Kundennummer |
{erp_customernr} | ERP Kundennummer |
{company} | Firma des angemeldeten Kunden |
{firstname} | Vorname des angemeldeten Kunden |
{lastname} | Nachname des angemeldeten Kunden |
{street} | Adresse des angemeldeten Kunden |
{zip} | PLZ des angemeldeten Kunden |
{city} | Ort des angemeldeten Kunden |
{country} | ISO Code des Landes des angemeldeten Kunden |
{tel} | Telefonnummer des angemeldeten Kunden |
{email} | EMail des angemeldeten Kunden |
Bestätigungsseite des Formulars
Na dem Übertragen der Daten an eines der obenstehenden Ziele wird der Besucher auf eine neue Adresse geleitet (normalerweise die URL eines weiteren CMS Seite).
Dazu muss im Formular Bereich die Ziel-Url festgelegt werden. Dort sollte immer mit absoluten Pfaden ohne Domäne genutzt werden. Wird nichts angegeben, springt der Besucher nach Abschicken des Formulars in den Warenkorb.
