X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/dc647c050ea84192f225e5ee35d913945966fcb5..88aa9dc7ff0e0cd2b6b7d5a7816600e3a956d740:/readme.htm

diff --git a/readme.htm b/readme.htm
index ffde610..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 <i>Form E-Mail</i> diese Formularfelder behandelt, wird &uuml;ber verschiede
 </tr>
 <tr>
 <td><code>$user_fields['beruf']['check']</code></td>
-<td>Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert gepr&uuml;ft werden soll.</td>
+<td>Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert gepr&uuml;ft werden soll. Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss <code>true</code> zur&uuml;ckgeben, wenn der Wert in Ordnung ist, ansonsten <code>false</code>.</td>
 </tr>
 </table>
 
@@ -571,7 +571,7 @@ Wie <i>Form E-Mail</i> diese Formularfelder behandelt, wird &uuml;ber verschiede
 </tr>
 <tr>
 <td><code>$user_fields['beruf']['prepare']</code></td>
-<td>Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Pr&uuml;fungen noch ver&auml;ndern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Gro&szlig;buchstaben umwandelt).</td>
+<td>Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Pr&uuml;fungen noch ver&auml;ndern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Gro&szlig;buchstaben umwandelt). Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss den bearbeiteten Wert zur&uuml;ckgeben.</td>
 </tr>
 <tr>
 <td><code>$user_fields['beruf']['tpl_var']</code></td>
@@ -581,6 +581,52 @@ Wie <i>Form E-Mail</i> diese Formularfelder behandelt, wird &uuml;ber verschiede
 
 <p>Sie m&uuml;ssen die individuellen Formularfelder nun noch in Ihrem Mail-Formular und in den <a href="#templates">Templates</a> erg&auml;nzen.</p>
 
+<p>Es folgt Beispiel-Konfiguration f&uuml;r ein Formularfeld namens <i>beruf</i>:</p>
+
+<pre>
+$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&ouml;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 &auml;&ouml;&uuml; haben!';
+
+# Beispiel-Check-Funktion
+
+function check_beruf($content) {
+    if(strpos($content,'&auml;') !== false) return false;
+    if(strpos($content,'&ouml;') !== false) return false;
+    if(strpos($content,'&uuml;') !== false) return false;
+    
+    return true;
+}
+
+# Beispiel-Vorbereitungs-Funktion
+
+function prepare_beruf($content) {
+    return strtolower($content);
+}
+</pre>
+
+<p>Das Formularfeld hat die folgenden Eigenschaften:</p>
+
+<ul>
+<li>Der Beruf muss aus mind. 5 Zeichen und max. 10 Zeichen bestehen (<code>min</code> und <code>max</code>)</li>
+<li>Das Formularfeld ist ein Pflichtfeld (<code>required</code>)</li>
+<li>Es sind nur die Buchstaben A-Z (gro&szlig; und klein) erlaubt (<code>regex</code>)</li>
+<li>&Uuml;ber die Pr&uuml;ffunktion <code>check_beruf()</code> wird verhindert, dass &auml;, &ouml; und &uuml; angegeben werden (das wird nat&uuml;rlich auch durch den regul&auml;ren Ausdruck ausgeschlossen, es soll lediglich zur Verdeutlichung dienen)</li>
+<li>Durch die Vorbereitungsfunktion <code>prepare_beruf()</code> werden alle Gro&szlig;buchstaben in Kleinbuchstaben umgewandelt</li>
+<li>In den Templates wird die Variable <code>{BERUF}</code> durch den Inhalt des Formularfeldes ersetzt (<code>tpl_var</code>)</li>
+<li>Die Fehlermeldungen sollten selbsterkl&auml;rend sein</li>
+</ul>
+
 <p class="upanddown"><a href="#top">Nach oben</a></p>
 
 <h2><a name="templates" id="templates">Templates anpassen</a></h2>