01 Grundprinzip

XForm ist ein AddOn für das REDAXO CMS, welches helfen soll unterschiedlichste Formulare aufzubauen. Diese Formulare können aus diversen Feldern bestehen, unterschiedlich überprüft werden und letztendlich E-Mails verschicken oder Einträge in Datenbank vollziehen. Dieses Tutorial bezieht sich immer auf die aktuellste Version.

Über den Menüpunkt “Setup” kann man mit Modul erstellen oder aktualisieren das Modul-XFormbuilder nutzen. In jedem Artikel ist nun, sofern es das Template erlaubt und man die entsprechenden Userrechte dazu hat, dieses Modul verfügbar.

Weiterhin gibt es PlugIns wie den Manager, Geo und E-Mail wie das Setup. Setup ist wie beschrieben für die Installation des Moduls zuständig, E-Mail für das Management von E-Mails-Templates und das Bereitstellen der Versandmöglichkeit, Geo für spezielle GoogleMap-Positionierung und der Manager für das Verwalten und Erstellen von Tabellen. Zu diesen Plugin aber erst später mehr. Zurück zum Formbuilder.

Im entsprechenden Artikel das Modul auswählen. Hier geht es nun vorerst um die Felddefinitionen, quasi das Herz dieses Moduls. Der Debugmodus kann aktiviert werden, um während der Entwicklungszeit mehr Informationen über die Abwicklung des eigene Formulars zu erfahren.

Felddefinitionen
Hier werden alle nötigen Informationen abgelegt. Dabei unterteilt sich die Erstellung eines Formulars in 3 Bereiche. Zunächst definiert man die einene “Values”. Das sind im Normalfall einfach nur die Feldtypen mit den enstprechenden Bezeichnungen. Also zum Beispiel ein Textfeld. Dann werden die “Validates” bestimmt. Die sind dafür zuständig, um die Richtigkeit der Eingaben zu prüfen. Im einfachsten Fall z.b. ob ein Feld ausgeführt ist. Schliesslich kommen die “Actions”. Das sind die Tätigkeiten, die nach allem ausgeführt werden. Also z.B. wenn ein Textfeld eingetragen wurde und die Überprüfung bestanden hat, dann kann dieses Feld als E-Mail verschickt werden.
Bei der Eingabe der Felddefinition muss man darauf achten, dass eine bestimmt Aktion immer nur in eine Zeile geschrieben werden darf. Die einzelnen Werte z.B. eines Feldes werden mit einer Pipe “|” getrennt.

Im Modul findet man die verfügbaren Klassen, welche in einer zugegebenermaßen sehr kurzen Form beschrieben sind. (Verfügbare Klassen). Dort bekommt man bereits einen Eindruck was alles möglich ist.

Eine einfache Formulardefinition könnte heißen:

text|name|Name
validate|empty|name|Bitte gib den Namen ein
action|showtext|

Super – du hast einen Namen eingetragen

Das Formular besteht aus einem Text-Input-Feld, dieses wird überprüft ob es eingetragen worden ist und anschliessend wird eine Meldung ausgegeben. Das HTML-Markup wird in diesem Fall automatisch. Sowohl die Fehlermeldungen, wie auch das ganze Formular ansich.