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

diff --git a/readme.htm b/readme.htm
index 676e478..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;
@@ -93,6 +101,7 @@ ul
 <a href="#wasistfeml">Was ist <i>Form E-Mail</i>?</a><br />
 <a href="#einrichten">Einrichten von <i>Form E-Mail</i></a><br />
 <a href="#einstellungen">Einstellungen</a><br />
+<a href="#individuell">Individuelle Formularfelder</a><br />
 <a href="#templates">Templates anpassen</a>
 </p>
 
@@ -180,7 +189,7 @@ Die Aliase werden mit Hilfe eines assoziativen PHP-Arrays definiert. Da es wohl
 </tr>
 <tr>
 <td><code>$friendly_sender</code></td>
-<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 />
+<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 />
 Bitte setzen Sie diese Option nur auf 0, wenn es wirklich sein muss!</td>
 </tr>
 <tr>
@@ -203,10 +212,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>
 </tr>
 <tr>
-<td><code>$no_tld</code></td>
-<td>Setzen Sie diese Option auf 1, wenn der Absender auch E-Mail-Adressen ohne Top-Level-Domain angeben darf.</td>
-</tr>
-<tr>
 <td><code>$allowed_envs</code></td>
 <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 />
 Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
@@ -272,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">
@@ -385,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>
@@ -397,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>
@@ -441,6 +487,59 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 
 <p class="upanddown"><a href="#top">Nach oben</a></p>
 
+<h2><a name="individuell" id="individuell">Individuelle Formularfelder</a></h2>
+
+<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>
 
 <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>
@@ -535,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']`