Formularfelder

Lesen Sie hier, wie Sie Formularfelder, Pflichtfelder, E-Mail-Felder, Vergleichsfelder und Dankeseiten festlegen können.

Zu jedem Formularfeldnamen im Template existiert automatisch ein gleichnamiger Platzhalter. Dadurch ist sichergestellt, dass die Daten bei einer Fehlermeldung im Formular wieder erscheinen. Der Platzhalter hat die gleiche Bezeichnung, wie das Formularfeld.

Beispiel:

<input type="text" name="lastname" value="{lastname}">

Sie können das Formular beliebig um weitere Felder erweitern. Bitte achten Sie jedoch darauf, dass die Feldnamen und Platzhalter keine Leer- oder Sonderzeichen enthalten.

Auswahl-Menüs (Select-Menüs)

Das Script kann Auswahl-Felder verarbeiten, die wie folgt aufgebaut sind:

<select name="" size="">
<option value=""></option>
<option value=""></option>
</select>

Es können auch Multiple Select-Felder verarbeitet werden. Ein Beispiel dazu finden Sie im HTML-Template /templates/example_multiples/form.tpl.html.

Um sicher zu stellen, dass der vom Benutzer ausgewählte Wert bei einem erneuten Aufruf des Formulars (z.B. bei einem Fehler oder der Vorschau-Funktion) ausgewählt bleibt, fügen Sie spezielle Platzhalter wie folgt ein:

<select name="Anrede" size="2">
<option value="Herr" {select:Anrede=Herr}>Herr</option>
<option value="Frau" {select:Anrede=Frau}>Frau</option>
</select>

Der Platzhalter {select:Anrede=Herr} hat folgende Eigenschaften: An erster Stelle steht die Art des Formularfeldes. In diesem Fall ist es ein Select-Menü (= select). Danach folgt ein Doppelpunkt (:). An zweiter Stelle muss der Name des Formularfeldes erscheinen. Das ist im obigen Beispiel Anrede. Danach folgt ein Gleichheitszeichen (=). An letzter Stelle muss der Wert des Options-Feldes stehen (also der Wert aus value=).

Um den ausgewählten Wert im Mail-Template erscheinen zu lassen, tragen Sie bitte im Mail-Template den Namen des Feldes, eingeschlossen durch geschweifte Klammern - {select:} - ein. Beispiel:

{select:Anrede}

Für den Fall, dass der Benutzer keine Option des Menüs ausgewählt hat, wird der Platzhalter im Mail-Template automatisch entfernt.

Soll ein Select-Feld ein Pflichtfeld sein und sie haben es in die Liste im Formularfeld required_fields aufgenommen, muss die erste Option einen leeren Wert (value="") besitzen. Andernfalls wird das Script keinen Fehler anzeigen.

<select name="Anrede" size="2">
<option value="">Bitte wählen Sie aus</option>
<option value="Herr" {select:Anrede=Herr}>Herr</option>
<option value="Frau" {select:Anrede=Frau}>Frau</option>
</select>

Weitere Beispiele finden Sie im Template /examples/advanced_form.tpl.html.

Checkboxen

Das Script kann Checkbox-Felder verarbeiten, die wie folgt aufgebaut sind:

<input type="checkbox" name="" value="" />

Es können auch Multiple Checkbox-Felder verarbeitet werden. Ein Beispiel dazu finden Sie im HTML-Template /templates/example_multiples/form.tpl.html.

Um sicher zu stellen, dass die vom Benutzer ausgewählte Checkbox auch bei einem erneuten Aufruf des Formulars (z.B. bei einem Fehler oder der Vorschau-Funktion) ausgewählt bleibt, fügen Sie spezielle Platzhalter wie folgt ein:

<input type="checkbox" name="Newsletter" value="Yes" {checkbox:Newsletter=Yes} />

Der Platzhalter {checkbox:Newsletter=Yes} hat folgende Eigenschaften. An erster Stelle steht die Art des Formularfeldes. In diesem Fall ist es eine Checkbox (= checkbox). Danach folgt ein Doppelpunkt (:). An zweiter Stelle muss der Name des Formularfeldes erscheinen. Das ist im obigen Beispiel Newsletter. Danach folgt ein Gleichheitszeichen (=). An letzter Stelle muss der Wert des Feldes stehen (also der Wert aus value=).

Um den ausgewählten Wert im Mail-Template erscheinen zu lassen, tragen Sie bitte im Mail-Template den Namen des Feldes, eingeschlossen durch geschweifte Klammern - {checkbox:} - ein. Beispiel:

{checkbox:Newsletter}

Für den Fall, dass der Benutzer die Checkbox nicht ausgewählt hat, wird der Platzhalter im Mail-Template automatisch entfernt.

Radio-Buttons

Das Script kann Radio-Button-Felder verarbeiten, die wie folgt aufgebaut sind:

<input type="radio" name=“" value="" />

Um sicher zu stellen, dass der vom Benutzer ausgewählte Radiobutton auch bei einem erneuten Aufruf des Formulars (z.B. bei einem Fehler oder der Vorschau-Funktion) ausgewählt bleibt, fügen Sie spezielle Platzhalter wie folgt ein:

<input type="radio" name="Anrede" value="Herr" {radiobutton:Anrede=Herr} />

Der Platzhalter {radiobutton:Anrede=Herr} hat folgende Eigenschaften. An erster Stelle steht die Art des Formularfeldes. In diesem Fall ist es ein Radio-Button(= radiobutton). Danach folgt ein Doppelpunkt (:). An zweiter Stelle muss der Name des Formularfeldes erscheinen. Das ist im obigen Beispiel Anrede. Danach folgt ein Gleichheitszeichen (=). An letzter Stelle muss der Wert des Feldes stehen (also der Wert aus value=).

Um den ausgewählten Wert im Mail-Template erscheinen zu lassen, tragen Sie bitte im Mail-Template den Namen des Feldes, eingeschlossen durch geschweifte Klammern - {radiobutton:} - ein. Beispiel:

{radiobutton:Anrede}

Für den Fall, dass der Benutzer keinen der Radio-Buttons ausgewählt hat, wird der Platzhalter im Mail-Template automatisch entfernt.

Beispiele zu den eben beschriebenen Funktionen finden Sie im Template /examples/advanced_form.tpl.html.

Danke-Seite (Bestätigungsseite)

Nachdem das Formular abgeschickt wurde, können Sie auf eine vordefinierte Seite weiterleiten lassen. Diese Seite können Sie im folgenden Feld definieren:

<input type="hidden" name="thanks" value="" />

Beispiel:

<input type="hidden" name="thanks" value="http://www.example.com/danke.html" />

Achten Sie bitte darauf, dass Sie den kompletten URL inklusive http:// und Ihrer Domain (z.B.: http://www.example.com/) angeben.

Wenn Sie dieses Feld nicht definieren oder es leer lassen, werden automatisch die vom Benutzer eingegebenen Daten als Bestätigung angezeigt.

Fehler-Seite

Ähnlich wie die Danke-Seite können Sie eine Fehlerseite anzeigen lassen. Der Benutzer muss dann den „Zurück-Button“ des Browsers anklicken, um zum Formular zurückzukehren und den Fehler zu korrigieren.

<input type="hidden" name="error_page" value="" />

Beispiel:

<input type="hidden" name="error_page" value="http://www.example.com/fehler.html" />

Achten Sie bitte darauf, dass Sie den kompletten URL inklusive http:// und Ihrer Domain (z.B.: http://www.example.com/) angeben.

Wenn Sie dieses Feld nicht definieren oder es leer lassen, wird das Formular selbst mit entsprechender Fehlermeldung angezeigt.

Pflichtfelder

Alle Formularfelder lassen sich als Pflichtfelder definieren. Das Formular wird erst dann abgeschickt, wenn alle Pflichtfelder ausgefüllt sind. Tragen Sie dazu die Formularfeldnamen der gewünschten Formularfelder in folgendes Hidden-Formularfeld im HTML-Template:

<input type="hidden" name="required_fields" value="" />

Beispiel:

<input type="hidden" name="required_fields" value="lastname, email, subject" />

Bitte beachten Sie: Upload-Felder können nicht als Pflichtfelder festgelegt werden.

E-Mail-Syntax

Ähnlich wie bei den Pflichtfeldern können Sie bestimmen, welche Felder auf ein korrektes E-Mail-Format geprüft werden sollen.

<input type="hidden" name="email_fields" value="" />

Beispiel:

<input type="hidden" name="email_fields" value="email" />

Zwei oder mehr Felder miteinander vergleichen

Das Script erlaubt Ihnen, den Inhalt zweier oder mehr Felder miteinander zu vergleichen. Sind die Werte unterschiedlich, wird eine Fehlermeldung angezeigt. Auf diese Art können Sie sicherstellen, dass E-Mails oder Passwörter keine Tippfehler enthalten. Fügen Sie ein Hidden-Formularfeld wie folgt ein:

<input type="hidden" name="compare_fields[]" value="email, confirm_email" />

Die obige Zeile würde dem Script mitteilen, dass es die Felder email und confirm_email testen soll.

Sie können mehrere dieser Zeilen in Ihr Formular einfügen.

<input type="hidden" name="compare_fields[]" value="email, confirm_email" />

<input type="hidden" name="compare_fields[]" value="password, confirm_password" />

Festlegen des HTML-Templates

Sie können das Script direkt oder von einem bereits fertigen Formular in einer statischen HTML-Seite aus aufrufen. Wenn Sie dabei nicht das in der index.php definierte HTML-Template nutzen wollen, können Sie das HTML-Template in folgendem Feld festlegen:

<input type="hidden" name="html_template" value="" />

Beispiel:

<input type="hidden" name="html_template" value="form.tpl.html" />

Festlegen des Mail-Templates

Die Mail-Templates definieren Sie auf die gleiche Weise:

<input type="hidden" name="mail_template" value="" />

Dazu können Sie ein einziges Mail-Template,

<input type="hidden" name="mail_template" value="mail.tpl.txt" />

oder mehrere Mail-Templates definieren. Durch die mehrfachen Mail-Templates können Sie mehrere E-Mails mit verschieden formatierten Inhalten versenden.

<input type="hidden" name="mail_template" value="mail.tpl.txt, mail2.tpl.txt" />

Auf diese Art können sie auch eine Bestätigungs-E-Mail (Autoresponder) senden. Das zweite E-Mail-Template enthält in diesem Fall den Inhalt der Bestätigungs-E-Mail.