]> git.p6c8.net - form-email.git/blobdiff - readme.htm
Die Option "optional" bei den indiv. Formularfeldern durch "required" ersetzt.
[form-email.git] / readme.htm
index cf59179fd335caaa4079c638534c725632ef0f88..da63c71dcf29b4c9cc27acc68f737da26e4ad3b1 100644 (file)
@@ -4,7 +4,7 @@
 \r
 <html xmlns="http://www.w3.org/1999/xhtml">\r
 <head>\r
 \r
 <html xmlns="http://www.w3.org/1999/xhtml">\r
 <head>\r
-<title>ReadMe f&uuml;r Form E-Mail&nbsp;3.4.1</title>\r
+<title>ReadMe f&uuml;r Form E-Mail&nbsp;3.5</title>\r
 <meta name="author" content="Patrick Canterino" />\r
 <style type="text/css">\r
 <!--\r
 <meta name="author" content="Patrick Canterino" />\r
 <style type="text/css">\r
 <!--\r
@@ -87,12 +87,13 @@ ul
 </head>\r
 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#0000FF" alink="#0000FF">\r
 \r
 </head>\r
 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#0000FF" alink="#0000FF">\r
 \r
-<h1><a name="top" id="top">ReadMe f&uuml;r Form E-Mail&nbsp;3.4.1</a></h1>\r
+<h1><a name="top" id="top">ReadMe f&uuml;r Form E-Mail&nbsp;3.5</a></h1>\r
 \r
 <p>\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
 \r
 <p>\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
@@ -131,7 +132,7 @@ Weiterhin ist noch ein Feld namens <i>recipient</i> m&ouml;glich. Dieses Feld en
 \r
 <p>Wenn Sie Captchas (zuf&auml;llige Zeichenfolgen, die der Benutzer vor dem Absenden des Formulars eingeben muss, um Spambots auszuschlie&szlig;en) benutzen wollen (siehe unten), m&uuml;ssen Sie im Formular die Datei <i>captcha.php</i> als Bild einbinden (<code>&lt;img&gt;</code>-Tag). Bedenken Sie, dass Sie diese Datei auch in den <a href="#templates">Templates</a> einbinden m&uuml;ssen!</p>\r
 \r
 \r
 <p>Wenn Sie Captchas (zuf&auml;llige Zeichenfolgen, die der Benutzer vor dem Absenden des Formulars eingeben muss, um Spambots auszuschlie&szlig;en) benutzen wollen (siehe unten), m&uuml;ssen Sie im Formular die Datei <i>captcha.php</i> als Bild einbinden (<code>&lt;img&gt;</code>-Tag). Bedenken Sie, dass Sie diese Datei auch in den <a href="#templates">Templates</a> einbinden m&uuml;ssen!</p>\r
 \r
-<p>Das Formular muss noch die Daten an die Datei <i>mailer.php</i> (oder wie Sie die Datei genannt haben) senden. Ob Sie daf&uuml;r <tt>GET</tt> oder <tt>POST</tt> verwenden, ist egal (es sei denn, Sie haben <i>Form E-Mail</i> so eingestellt, dass es nur <tt>POST</tt> erlaubt).</p>\r
+<p>Das Formular muss dann noch mit <tt>POST</tt> die Daten an die Datei <i>mailer.php</i> (oder wie Sie die Datei genannt haben) senden.</p>\r
 \r
 <p>Ein beispielhaftes Formular finden Sie in der Datei <a href="formular.htm" target="_blank"><i>formular.htm</i></a>.</p>\r
 \r
 \r
 <p>Ein beispielhaftes Formular finden Sie in der Datei <a href="formular.htm" target="_blank"><i>formular.htm</i></a>.</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
@@ -262,10 +259,6 @@ Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 <td><b>Beschreibung</b></td>\r
 </tr>\r
 <tr>\r
 <td><b>Beschreibung</b></td>\r
 </tr>\r
 <tr>\r
-<td><code>$only_post</code></td>\r
-<td>Wenn &gt; 0, kann <i>Form E-Mail</i> nur mit der HTTP-Zugriffsmethode <tt>POST</tt> aufgerufen werden</td>\r
-</tr>\r
-<tr>\r
 <td><code>$check_referer</code></td>\r
 <td>Wenn &gt; 0, &uuml;berpr&uuml;ft <i>Form E-Mail</i> die Host-Angabe im HTTP-Referer. Das ist n&uuml;tzlich, wenn Sie verhindern wollen, dass irgendjemand Ihr Script f&uuml;r sich ausnutzt.</td>\r
 </tr>\r
 <td><code>$check_referer</code></td>\r
 <td>Wenn &gt; 0, &uuml;berpr&uuml;ft <i>Form E-Mail</i> die Host-Angabe im HTTP-Referer. Das ist n&uuml;tzlich, wenn Sie verhindern wollen, dass irgendjemand Ihr Script f&uuml;r sich ausnutzt.</td>\r
 </tr>\r
@@ -445,6 +438,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

patrick-canterino.de