X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/4ff866daddd79266ed5152c9c4e63cc73723a825..27560e4c6034a1cc4454ddf14ac9add602b5e284:/readme.htm diff --git a/readme.htm b/readme.htm index 19b225e..a205582 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 > 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ä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ä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öscht. Die Mail-Dateien werden anhand des mit <code>$store_mails_prefix</code> definierten Prä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> @@ -447,6 +492,85 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td> <p>Seit Version 3.5 ist es möglich, in <i>Form E-Mail</i> zusätzlich zu den vorgegebenen Formularfeldern fü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ügt werden.<br /> Wie <i>Form E-Mail</i> diese Formularfelder behandelt, wird über verschiedene Optionen gesteuert, so ist es möglich die Länge des Inhalts zu prüfen, den Inhalt gegen einen regulären Ausdruck und gegen eine frei definierbare PHP-Funktion zu prüfen und am Ende den Inhalt noch durch eine PHP-Funktion aufzubereiten.</p> +<p>Die Konfiguration der individuellen Formularfelder geschieht über das PHP-Array <code>$user_fields</code> in <i>config.php</i>. Sie benötigen zunächst den Namen des Formularfeldes, also das, was Sie im HTML-Formular als Namen angeben. Nehmen wir an, Sie haben folgenden HTML-Code für ein Formularfeld:</p> + +<p><code><input type="text" name="beruf" /></code></p> + +<p>Der Name des Feldes lautet also <b>beruf</b>. Dies benötigen wir für die weitere Definition.</p> + +<p>Sie können nun verschiedene Prüfwerte definieren, mit denen <i>Form E-Mail</i> den Inhalt des Formularfeldes überprüft und ggf. eine Fehlermeldung ausgibt. Diese werden in der folgenden Tabelle erläutert (die Tabelle geht der Einfachheit halber weiterhin vom Formularfeld <b>beruf</b> aus - Sie müssen dies natü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>Geben Sie hier an, wie lang der vom Benutzer eingebene Wert mindestens sein muss</td> +</tr> +<tr> +<td><code>$user_fields['beruf']['max']</code></td> +<td>Geben Sie hier an, wie lang der vom Benutzer eingebene Wert höchstens sein darf</td> +</tr> +<tr> +<td><code>$user_fields['beruf']['required']</code></td> +<td>Geben Sie hier den Wert 1 an, wenn das Formularfeld ausgefüllt sein muss. Wenn Sie hier eine 0 oder die Option weglassen, ist das Feld optional.</td> +</tr> +<tr> +<td><code>$user_fields['beruf']['regex']</code></td> +<td>Geben Sie hier einen <a href="http://de.php.net/manual/de/book.pcre.php">Perl-kompatiblen regulären Ausdruck</a> zur Prüfung des Wertes ein. Der Ausdruck wird direkt an <a href="http://de.php.net/manual/de/function.preg-match.php"><code>preg_match()</code></a> weitergegeben.</td> +</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üft werden soll.</td> +</tr> +</table> + +<table border="1"> +<tr> +<td><b>Einstellung</b></td> +<td><b>Beschreibung</b></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['errors']['too_short']</code></td> +<td></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['errors']['too_long']</code></td> +<td></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['errors']['not_set']</code></td> +<td></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['errors']['match_fail']</code></td> +<td></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['errors']['check_fail']</code></td> +<td></td> +</tr> +</table> + + +<table border="1"> +<tr> +<td><b>Einstellung</b></td> +<td><b>Beschreibung</b></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['prepare']</code></td> +<td></td> +</tr> +<tr> +<td><code>$user_fields['beruf']['tpl_var']</code></td> +<td></td> +</tr> +</table> + + <p class="upanddown"><a href="#top">Nach oben</a></p> <h2><a name="templates" id="templates">Templates anpassen</a></h2>