Neue Lizenz im Change Log erwaehnen

[form-email.git] / readme.htm

diff --git a/readme.htm b/readme.htm
index 676e47826d20ee5e35a0af97699768d30bc2119e..65e49fe9eb3827bf03c4de0e8a392f531da80bd0 100644 (file)
--- a/readme.htm
+++ b/readme.htm
@@ -93,6 +93,7 @@ ul
 <a href="#wasistfeml">Was ist <i>Form E-Mail</i>?</a><br />\r
 <a href="#einrichten">Einrichten von <i>Form E-Mail</i></a><br />\r
 <a href="#einstellungen">Einstellungen</a><br />\r
 <a href="#wasistfeml">Was ist <i>Form E-Mail</i>?</a><br />\r
 <a href="#einrichten">Einrichten von <i>Form E-Mail</i></a><br />\r
 <a href="#einstellungen">Einstellungen</a><br />\r

+<a href="#individuell">Individuelle Formularfelder</a><br />\r

 <a href="#templates">Templates anpassen</a>\r
 </p>\r
 \r
 <a href="#templates">Templates anpassen</a>\r
 </p>\r
 \r


@@ -180,7 +181,7 @@ Die Aliase werden mit Hilfe eines assoziativen PHP-Arrays definiert. Da es wohl
 </tr>\r
 <tr>\r
 <td><code>$friendly_sender</code></td>\r
 </tr>\r
 <tr>\r
 <td><code>$friendly_sender</code></td>\r

-<td>Wenn 1, wird die E-Mail-Adresse des Autors der Mail als Absender angegeben. Bei 0 erscheint das, was der Server als Absender eintr&auml;gt. Wenn 2, wird zus&auml;tzlich noch der Name als Absender angegeben.<br />\r
+<td>Wenn 1, wird die E-Mail-Adresse des Autors der Mail als Absender angegeben. Bei 0 erscheint das, was der Server als Absender eintr&auml;gt und die E-Mail-Adresse des Absenders wird in den <code>Reply-To</code>-Header eingetragen, so dass beim Antworten auf die E-Mail schon der richtige Empf&auml;nger eingetragen wird. Wenn 2, wird zus&auml;tzlich noch der Name als Absender angegeben.<br />\r

 Bitte setzen Sie diese Option nur auf 0, wenn es wirklich sein muss!</td>\r
 </tr>\r
 <tr>\r
 Bitte setzen Sie diese Option nur auf 0, wenn es wirklich sein muss!</td>\r
 </tr>\r
 <tr>\r


@@ -203,10 +204,6 @@ Beachten Sie bitte, dass bei neueren PHP-Versionen, trotz deutscher Spracheinste
 <b style="color:#FF0000">Achtung:</b> Benutzen Sie hier nach M&ouml;glichkeit absolute URLs! Ich habe zwar etwas eingebaut, was hier relative URLs in absolute umwandelt, um dem HTTP-Standard gerecht zu werden, aber ich garantiere nicht, dass diese Umwandlung immer einwandfrei funktioniert. Seien Sie bei relativen URLs also sehr vorsichtig und verwenden Sie im Fehlerfall absolute.</td>\r
 </tr>\r
 <tr>\r
 <b style="color:#FF0000">Achtung:</b> Benutzen Sie hier nach M&ouml;glichkeit absolute URLs! Ich habe zwar etwas eingebaut, was hier relative URLs in absolute umwandelt, um dem HTTP-Standard gerecht zu werden, aber ich garantiere nicht, dass diese Umwandlung immer einwandfrei funktioniert. Seien Sie bei relativen URLs also sehr vorsichtig und verwenden Sie im Fehlerfall absolute.</td>\r
 </tr>\r
 <tr>\r

-<td><code>$no_tld</code></td>\r
-<td>Setzen Sie diese Option auf 1, wenn der Absender auch E-Mail-Adressen ohne Top-Level-Domain angeben darf.</td>\r
-</tr>\r
-<tr>\r

 <td><code>$allowed_envs</code></td>\r
 <td>Geben Sie hier die Server-Umgebungsvariablen, die im Mailtext angezeigt werden d&uuml;rfen, als normales PHP-Array an (siehe auch die Erl&auml;uterungen zur Template-Datei <i>mail.txt</i>).<br />\r
 Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>\r
 <td><code>$allowed_envs</code></td>\r
 <td>Geben Sie hier die Server-Umgebungsvariablen, die im Mailtext angezeigt werden d&uuml;rfen, als normales PHP-Array an (siehe auch die Erl&auml;uterungen zur Template-Datei <i>mail.txt</i>).<br />\r
 Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>\r


@@ -272,6 +269,31 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 </tr>\r
 </table>\r
 \r
 </tr>\r
 </table>\r
 \r

+<p><b>Mails speichern</b></p>\r
+\r
+<table border="1">\r
+<tr>\r
+<td><b>Einstellung</b></td>\r
+<td><b>Beschreibung</b></td>\r
+</tr>\r
+<tr>\r
+<td><code>$store_mails</code></td>\r
+<td>Wenn &gt; 0, speichert <i>Form E-Mail</i> die Mails nach dem Versenden noch auf dem Server als Datei ab.</td>\r
+</tr>\r
+<tr>\r
+<td><code>$store_mails_dir</code></td>\r
+<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>\r
+</tr>\r
+<tr>\r
+<td><code>$store_mails_prefix</code></td>\r
+<td>Geben Sie hier einen Pr&auml;fix an, der den Dateinamen der gespeicherten Mails vorangestellt werden soll (Standard ist <i>feml_</i>).</td>\r
+</tr>\r
+<tr>\r
+<td><code>$store_mails_max</code></td>\r
+<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>\r
+</tr>\r
+</table>\r
+\r

 <p><b>Captchas</b></p>\r
 \r
 <table border="1">\r
 <p><b>Captchas</b></p>\r
 \r
 <table border="1">\r


@@ -385,6 +407,18 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 <td>Der vom Benutzer eingegebene Text ist nicht lang genug</td>\r
 </tr>\r
 <tr>\r
 <td>Der vom Benutzer eingegebene Text ist nicht lang genug</td>\r
 </tr>\r
 <tr>\r

+<td><code>$err_name_long</code></td>\r
+<td>Der vom Benutzer eingegebene Name ist nicht zu lang</td>\r
+</tr>\r
+<tr>\r
+<td><code>$err_subject_long</code></td>\r
+<td>Der vom Benutzer eingegebene Betreff ist zu lang</td>\r
+</tr>\r
+<tr>\r
+<td><code>$err_text_long</code></td>\r
+<td>Der vom Benutzer eingegebene Text ist zu lang</td>\r
+</tr>\r
+<tr>\r

 <td><code>$err_send_error</code></td>\r
 <td>Die Mail konnte nicht versendet werden</td>\r
 </tr>\r
 <td><code>$err_send_error</code></td>\r
 <td>Die Mail konnte nicht versendet werden</td>\r
 </tr>\r


@@ -397,6 +431,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>\r
 </tr>\r
 <tr>\r
 <td>Der im HTTP-Referer angegebene Host darf keine Mails &uuml;ber das Script senden</td>\r
 </tr>\r
 <tr>\r

+<td><code>$err_indiv_errmsg_miss</code></td>\r
+<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>\r
+</tr>\r
+<tr>\r

 <td><code>$err_captcha_incorrect</code></td>\r
 <td>Der vom Benutzer eingegebene Captcha-Code ist nicht korrekt</td>\r
 </tr>\r
 <td><code>$err_captcha_incorrect</code></td>\r
 <td>Der vom Benutzer eingegebene Captcha-Code ist nicht korrekt</td>\r
 </tr>\r


@@ -441,6 +479,13 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 \r
 <p class="upanddown"><a href="#top">Nach oben</a></p>\r
 \r
 \r
 <p class="upanddown"><a href="#top">Nach oben</a></p>\r
 \r

+<h2><a name="individuell" id="individuell">Individuelle Formularfelder</a></h2>\r
+\r
+<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 />\r
+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>\r
+\r
+<p class="upanddown"><a href="#top">Nach oben</a></p>\r
+\r

 <h2><a name="templates" id="templates">Templates anpassen</a></h2>\r
 \r
 <p>Die Anpassung der Ausgaben von <i>Form E-Mail</i> erfolgt &uuml;ber Templates (englisch f&uuml;r &quot;Vorlagen&quot;). Jede der Templates enth&auml;lt Variablen der Form <b>{VARIABLENNAME}</b>, die dann von <i>Form E-Mail</i> durch entsprechende Daten ersetzt werden.</p>\r
 <h2><a name="templates" id="templates">Templates anpassen</a></h2>\r
 \r
 <p>Die Anpassung der Ausgaben von <i>Form E-Mail</i> erfolgt &uuml;ber Templates (englisch f&uuml;r &quot;Vorlagen&quot;). Jede der Templates enth&auml;lt Variablen der Form <b>{VARIABLENNAME}</b>, die dann von <i>Form E-Mail</i> durch entsprechende Daten ersetzt werden.</p>\r


@@ -535,7 +580,7 @@ Zus&auml;tzlich ist es m&ouml;glich, einen Bereich, der nur angezeigt werden sol
 \r
 <hr width="80%" noshade="noshade" />\r
 \r
 \r
 <hr width="80%" noshade="noshade" />\r
 \r

-<p style="font-size:8pt">&copy;&nbsp;2002-2011 Patrick Canterino</p>\r
+<p style="font-size:8pt">&copy;&nbsp;2002-2012 Patrick Canterino</p>\r

 \r
 <table border="0" cellspacing="0" style="font-size:8pt">\r
 <tr>\r
 \r
 <table border="0" cellspacing="0" style="font-size:8pt">\r
 <tr>\r