X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/bd86302330d2811e018689abce0c4b640bf0b89a..dc796cb93a9ecbe5b7d9c3e0edaf51df9a8de9e9:/readme.htm diff --git a/readme.htm b/readme.htm index d56bcc2..801fdc3 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; @@ -130,6 +138,8 @@ Auf diese Weise müssen Sie zum Beispiel nicht überall auf Ihrer Homepa
Sie können außerdem noch ein Feld namens subject anlegen. Hier kann ein Betreff für die Mail eingegeben werden. Wenn Sie auf dieses Feld verzichten, erhalten die E-Mails automatisch den in $default_subject
definierten Betreff (s.u.).
Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld enthält einen Alias-Empfänger. Wie das funktioniert, können Sie bei der Beschreibung der Einstellung $aliases
lesen.
Zusätzlich können Sie die vorgegebenen Formularfelder mit individuellen ergänzen.
+Wenn Sie Captchas (zufällige Zeichenfolgen, die der Benutzer vor dem Absenden des Formulars eingeben muss, um Spambots auszuschließen) benutzen wollen (siehe unten), müssen Sie im Formular die Datei captcha.php als Bild einbinden (<img>
-Tag). Bedenken Sie, dass Sie diese Datei auch in den Templates einbinden müssen!
Das Formular muss dann noch mit POST die Daten an die Datei mailer.php (oder wie Sie die Datei genannt haben) senden.
@@ -142,7 +152,7 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld enGeben Sie zwischen den einfachen Anführungszeichen die Adresse an, an die die Mail gehen soll. Wenn die Mail an mehrere Empfänger gehen soll, so trennen Sie die einzelnen E-Mail-Adressen ganz einfach durch Semikolons.
-Das war es im Grunde genommen. Aber Form E-Mail lässt sich noch weiter konfigurieren. Mehr dazu finden Sie in den nächsten beiden Abschnitten.
+Sie haben nun Form E-Mail für die Standard-Nutzung konfiguriert. Form E-Mail lässt sich jedoch noch feiner konfigurieren. Mehr dazu finden Sie in den nächsten Abschnitten.
@@ -163,8 +173,8 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld en$aliases
$mailto
.array('info' => 'info@IhreDomain.xyz', 'support' => 'support@IhreDomain.xyz',
- 'alle' => 'info@IhreDomain.xyz; support@IhreDomain.xyz')
array('info' => 'info@example.com', 'support' => 'support@example.com',
+ 'alle' => 'info@example.com; support@example.com')
@@ -204,10 +214,6 @@ Beachten Sie bitte, dass bei neueren PHP-Versionen, trotz deutscher Spracheinste
Achtung: Benutzen Sie hier nach Mö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.
$no_tld
$allowed_envs
array('HTTP_USER_AGENT','REMOTE_ADDR')
array('HTTP_USER_AGENT','REMOTE_ADDR')
$referer_ok
Mails speichern
+ +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. |
+
Captchas
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 |
$err_only_post |
+Form E-Mail darf nur mit POST aufgerufen werden | +
$err_referer_not_ok |
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'] |
+Geben Sie hier an, wie lang der vom Benutzer eingebene Wert mindestens sein muss | +
$user_fields['beruf']['max'] |
+Geben Sie hier an, wie lang der vom Benutzer eingebene Wert höchstens sein darf | +
$user_fields['beruf']['required'] |
+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. | +
$user_fields['beruf']['regex'] |
+Geben Sie hier einen Perl-kompatiblen regulären Ausdruck zur Prüfung des Wertes ein. Der Ausdruck wird direkt an preg_match() weitergegeben. |
+
$user_fields['beruf']['check'] |
+Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert geprüft werden soll. | +
Weiterhin müssen Sie noch diverse Fehlermeldungen definieren (als Unter-Array). Das Definieren dieser Fehlermeldungen ist Pflicht (Sie müssen jedoch nur die Fehlermeldungen zu den Dingen definieren, die auch wirklich geprüft werden).
+ +Einstellung | +Beschreibung | +
$user_fields['beruf']['errors']['too_short'] |
+Der vom Benutzer eingegebene Wert ist nicht lang genug | +
$user_fields['beruf']['errors']['too_long'] |
+Der vom Benutzer eingegebene Wert ist zu lang | +
$user_fields['beruf']['errors']['not_set'] |
+Das Formularfeld ist ein Pflichtfeld und es wurde nicht ausgefüllt. | +
$user_fields['beruf']['errors']['match_fail'] |
+Die Überprüfung des Wertes durch den regulären Ausdruck ist fehlgeschlagen. | +
$user_fields['beruf']['errors']['check_fail'] |
+Die Überprüfung des Wertes durch die PHP-Funktion ist fehlgeschlagen. | +
Zusätzlich sind noch die folgenden Einstellungen möglich:
+ +Einstellung | +Beschreibung | +
$user_fields['beruf']['prepare'] |
+Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Prüfungen noch verändern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Großbuchstaben umwandelt). | +
$user_fields['beruf']['tpl_var'] |
+Geben Sie hier die Template-Variable an, die in den Templates durch den Wert des Formularfeldes ersetzt werden soll. Wenn Sie hier nichts angeben, wird ein Standardwert verwendet (im Fall des Formularfeldes beruf wäre das dann USER_beruf ). |
+
Sie müssen die individuellen Formularfelder nun noch in Ihrem Mail-Formular und in den Templates ergänzen.
+tpl_var
angegeben) verwenden.$allowed_envs
.
@@ -505,6 +641,8 @@ Der eingegebene Mail-Text
tpl_var
angegeben) verwenden.
tpl_var
angegeben) verwenden.{ELSE}
-Teil ist optional):{IF CAPTCHA}Captchas sind aktiviert{ELSE}Captchas sind nicht aktiviert{ENDIF}
@@ -539,7 +679,7 @@ Zusätzlich ist es möglich, einen Bereich, der nur angezeigt werden sol
© 2002-2011 Patrick Canterino
+© 2002-2012 Patrick Canterino