X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/63ac0f78a9fdcbfb7d6a35b5e797b2305dcf7575..88aa9dc7ff0e0cd2b6b7d5a7816600e3a956d740:/readme.htm diff --git a/readme.htm b/readme.htm index a51734f..d040622 100644 --- a/readme.htm +++ b/readme.htm @@ -67,8 +67,8 @@ p } pre { - padding-left: 0.5cm; - padding-right: 0.5cm; + padding-left: 0.7cm; + padding-right: 0.7cm; font-family: 'Courier New', Courier, monospace; font-size: 10pt; color: #0000B0; @@ -529,7 +529,7 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede $user_fields['beruf']['check'] -Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert geprüft werden soll. +Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert geprüft werden soll. Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss true zurückgeben, wenn der Wert in Ordnung ist, ansonsten false. @@ -571,7 +571,7 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede $user_fields['beruf']['prepare'] -Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Prüfungen noch verändern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Großbuchstaben umwandelt). +Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Prüfungen noch verändern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Großbuchstaben umwandelt). Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss den bearbeiteten Wert zurückgeben. $user_fields['beruf']['tpl_var'] @@ -581,6 +581,52 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede

Sie müssen die individuellen Formularfelder nun noch in Ihrem Mail-Formular und in den Templates ergänzen.

+

Es folgt Beispiel-Konfiguration für ein Formularfeld namens beruf:

+ +
+$user_fields['beruf']['min'] = 5;
+$user_fields['beruf']['max'] = 10;
+$user_fields['beruf']['required'] = 1;
+$user_fields['beruf']['regex'] = '/^[A-Za-z]+$/';
+$user_fields['beruf']['check'] = 'check_beruf';
+$user_fields['beruf']['prepare'] = 'prepare_beruf';
+$user_fields['beruf']['tpl_var'] = 'BERUF';
+
+$user_fields['beruf']['errors']['too_short'] = 'Der Beruf muss mind. 5 Zeichen lang sein!';
+$user_fields['beruf']['errors']['too_long'] = 'Der Beruf darf höchstens 10 Zeichen lang sein!';
+$user_fields['beruf']['errors']['not_set'] = 'Sie haben keinen Beruf eingegeben!';
+$user_fields['beruf']['errors']['match_fail'] = 'Der Beruf darf nur aus Buchstaben bestehen!';
+$user_fields['beruf']['errors']['check_fail'] = 'Der Beruf sollte keine äöü haben!';
+
+# Beispiel-Check-Funktion
+
+function check_beruf($content) {
+    if(strpos($content,'ä') !== false) return false;
+    if(strpos($content,'ö') !== false) return false;
+    if(strpos($content,'ü') !== false) return false;
+    
+    return true;
+}
+
+# Beispiel-Vorbereitungs-Funktion
+
+function prepare_beruf($content) {
+    return strtolower($content);
+}
+
+ +

Das Formularfeld hat die folgenden Eigenschaften:

+ + +

Nach oben

Templates anpassen

@@ -622,7 +668,7 @@ Der eingegebene Mail-Text Die formatierte Zeitangabe -Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden.
+Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben haben) verwenden.

Zusätzlich können Sie hier durch Variablen, die mit ENV_ beginnen, Server-Umgebungsvariablen im Text einfügen (siehe auch Konfigurationsvariable $allowed_envs. @@ -646,7 +692,7 @@ Der eingegebene Mail-Text Die formatierte Zeitangabe -Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden. +Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben haben) verwenden. @@ -666,7 +712,7 @@ Der Betreff der Mail Der eingegebene Mail-Text -Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden.
+Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben haben) verwenden.

Zusätzlich ist es möglich, einen Bereich, der nur angezeigt werden soll, wenn Captchas aktiviert sind, anzuzeigen, indem Sie diesen in folgenden Block einschließen (der {ELSE}-Teil ist optional):