From 5224fe74fba39cf1553cae3e423bb6677b08f378 Mon Sep 17 00:00:00 2001
From: Patrick Canterino <patrick@patshaping.de>
Date: Sun, 15 Jan 2012 21:20:06 +0000
Subject: [PATCH 1/1] Weitermachen bei Doku fuer indiv. Formularfelder

---
 readme.htm | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/readme.htm b/readme.htm
index 65e49fe..910fd6c 100644
--- a/readme.htm
+++ b/readme.htm
@@ -65,6 +65,14 @@ p
  padding-left: 0.5cm;
  padding-right: 0.5cm;
 }
+pre
+{
+ padding-left: 0.5cm;
+ padding-right: 0.5cm;
+ font-family: 'Courier New', Courier, monospace;
+ font-size: 10pt;
+ color: #0000B0;
+}
 table
 {
  font-size: 10pt;
@@ -484,6 +492,52 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 <p>Seit Version&nbsp;3.5 ist es m&ouml;glich, in <i>Form E-Mail</i> zus&auml;tzlich zu den vorgegebenen Formularfeldern f&uuml;r Name, E-Mail-Adresse, Betreff und Text eigene Formularfelder zu definieren, die dann von <i>Form E-Mail</i> verarbeitet und in die Mail eingef&uuml;gt werden.<br />
 Wie <i>Form E-Mail</i> diese Formularfelder behandelt, wird &uuml;ber verschiedene Optionen gesteuert, so ist es m&ouml;glich die L&auml;nge des Inhalts zu pr&uuml;fen, den Inhalt gegen einen regul&auml;ren Ausdruck und gegen eine frei definierbare PHP-Funktion zu pr&uuml;fen und am Ende den Inhalt noch durch eine PHP-Funktion aufzubereiten.</p>
 
+<p>Die Konfiguration der individuellen Formularfelder geschieht &uuml;ber das PHP-Array <code>$user_fields</code> in <i>config.php</i>. Sie ben&ouml;tigen zun&auml;chst den Namen des Formularfeldes, also das, was Sie im HTML-Formular als Namen angeben. Nehmen wir an, Sie haben folgenden HTML-Code f&uuml;r ein Formularfeld:</p>
+
+<p><code>&lt;input type=&quot;text&quot; name=&quot;beruf&quot; /&gt;</code></p>
+
+<p>Der Name des Feldes lautet also <b>beruf</b>. Dies ben&ouml;tigen wir f&uuml;r die weitere Definition.</p>
+
+<p>Sie k&ouml;nnen nun verschiedene Pr&uuml;fwerte definieren, mit denen <i>Form E-Mail</i> den Inhalt des Formularfeldes &uuml;berpr&uuml;ft und ggf. eine Fehlermeldung ausgibt. Diese werden in der folgenden Tabelle erl&auml;utert (die Tabelle geht der Einfachheit halber weiterhin vom Formularfeld <b>beruf</b> aus - Sie m&uuml;ssen dies nat&uuml;rlich anpassen!):</p>
+
+<table border="1">
+<tr>
+<td><b>Einstellung</b></td>
+<td><b>Beschreibung</b></td>
+</tr>
+<tr>
+<td><code>$user_fields['beruf']['min']</code></td>
+<td></td>
+</tr>
+<tr>
+<td><code>$user_fields['beruf']['max']</code></td>
+<td></td>
+</tr>
+<tr>
+<td><code>$user_fields['beruf']['required']</code></td>
+<td></td>
+</tr>
+<tr>
+<td><code>$user_fields['beruf']['regex']</code></td>
+<td></td>
+</tr>
+<tr>
+<td><code>$user_fields['beruf']['check']</code></td>
+<td></td>
+</tr>
+</table>
+
+<pre>
+$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!';
+</pre>
+
 <p class="upanddown"><a href="#top">Nach oben</a></p>
 
 <h2><a name="templates" id="templates">Templates anpassen</a></h2>
-- 
2.34.1