X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/beba1c3cc4bb271923f1f6d0f14d8a76885cd489..5224fe74fba39cf1553cae3e423bb6677b08f378:/readme.htm?ds=sidebyside

diff --git a/readme.htm b/readme.htm
index da63c71..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;
@@ -269,6 +277,31 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 </tr>
 </table>
 
+<p><b>Mails speichern</b></p>
+
+<table border="1">
+<tr>
+<td><b>Einstellung</b></td>
+<td><b>Beschreibung</b></td>
+</tr>
+<tr>
+<td><code>$store_mails</code></td>
+<td>Wenn &gt; 0, speichert <i>Form E-Mail</i> die Mails nach dem Versenden noch auf dem Server als Datei ab.</td>
+</tr>
+<tr>
+<td><code>$store_mails_dir</code></td>
+<td>Geben Sie hier das Verzeichnis an, in dem <i>Form E-Mail</i> die Mails speichern soll (Standard ist <i>stored_mails</i>). Die Dateinamen bestehen aus dem Pr&auml;fix, dem Absender, dem Betreff, der Uhrzeit und einem eindeutigen Wert.</td>
+</tr>
+<tr>
+<td><code>$store_mails_prefix</code></td>
+<td>Geben Sie hier einen Pr&auml;fix an, der den Dateinamen der gespeicherten Mails vorangestellt werden soll (Standard ist <i>feml_</i>).</td>
+</tr>
+<tr>
+<td><code>$store_mails_max</code></td>
+<td>Geben Sie hier die Zahl der Mails an, die maximal aufbewahrt werden sollen. Wenn Sie hier 0 angeben, werden keine Mails gel&ouml;scht. Die Mail-Dateien werden anhand des mit <code>$store_mails_prefix</code> definierten Pr&auml;fixes erkannt.</td>
+</tr>
+</table>
+
 <p><b>Captchas</b></p>
 
 <table border="1">
@@ -382,6 +415,18 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 <td>Der vom Benutzer eingegebene Text ist nicht lang genug</td>
 </tr>
 <tr>
+<td><code>$err_name_long</code></td>
+<td>Der vom Benutzer eingegebene Name ist nicht zu lang</td>
+</tr>
+<tr>
+<td><code>$err_subject_long</code></td>
+<td>Der vom Benutzer eingegebene Betreff ist zu lang</td>
+</tr>
+<tr>
+<td><code>$err_text_long</code></td>
+<td>Der vom Benutzer eingegebene Text ist zu lang</td>
+</tr>
+<tr>
 <td><code>$err_send_error</code></td>
 <td>Die Mail konnte nicht versendet werden</td>
 </tr>
@@ -394,6 +439,10 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 <td>Der im HTTP-Referer angegebene Host darf keine Mails &uuml;ber das Script senden</td>
 </tr>
 <tr>
+<td><code>$err_indiv_errmsg_miss</code></td>
+<td>Eine Fehlermeldung f&uuml;r die individuellen Formularfelder wurde nicht definiert (die Variable <code>{INDIVIDUAL}</code> gibt das Formularfeld an, <code>{ERRMSG}</code> die fehlende Fehlermeldung).</td>
+</tr>
+<tr>
 <td><code>$err_captcha_incorrect</code></td>
 <td>Der vom Benutzer eingegebene Captcha-Code ist nicht korrekt</td>
 </tr>
@@ -443,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>
@@ -539,7 +634,7 @@ Zus&auml;tzlich ist es m&ouml;glich, einen Bereich, der nur angezeigt werden sol
 
 <hr width="80%" noshade="noshade" />
 
-<p style="font-size:8pt">&copy;&nbsp;2002-2011 Patrick Canterino</p>
+<p style="font-size:8pt">&copy;&nbsp;2002-2012 Patrick Canterino</p>
 
 <table border="0" cellspacing="0" style="font-size:8pt">
 <tr>

Einstellung	Beschreibung
`$store_mails`	Wenn > 0, speichert Form E-Mail die Mails nach dem Versenden noch auf dem Server als Datei ab.
`$store_mails_dir`	Geben Sie hier das Verzeichnis an, in dem Form E-Mail die Mails speichern soll (Standard ist stored_mails). Die Dateinamen bestehen aus dem Präfix, dem Absender, dem Betreff, der Uhrzeit und einem eindeutigen Wert.
`$store_mails_prefix`	Geben Sie hier einen Präfix an, der den Dateinamen der gespeicherten Mails vorangestellt werden soll (Standard ist feml_).
`$store_mails_max`	Geben Sie hier die Zahl der Mails an, die maximal aufbewahrt werden sollen. Wenn Sie hier 0 angeben, werden keine Mails gelöscht. Die Mail-Dateien werden anhand des mit `$store_mails_prefix` definierten Präfixes erkannt.
Der vom Benutzer eingegebene Text ist nicht lang genug
`$err_name_long`	Der vom Benutzer eingegebene Name ist nicht zu lang
`$err_subject_long`	Der vom Benutzer eingegebene Betreff ist zu lang
`$err_text_long`	Der vom Benutzer eingegebene Text ist zu lang
`$err_send_error`	Die Mail konnte nicht versendet werden
Der im HTTP-Referer angegebene Host darf keine Mails über das Script senden
`$err_indiv_errmsg_miss`	Eine Fehlermeldung für die individuellen Formularfelder wurde nicht definiert (die Variable `{INDIVIDUAL}` gibt das Formularfeld an, `{ERRMSG}` die fehlende Fehlermeldung).
`$err_captcha_incorrect`	Der vom Benutzer eingegebene Captcha-Code ist nicht korrekt
Einstellung	Beschreibung
`$user_fields['beruf']['min']`
`$user_fields['beruf']['max']`
`$user_fields['beruf']['required']`
`$user_fields['beruf']['regex']`
`$user_fields['beruf']['check']`