X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/5607d82fb5d5e1680e5d9d72876875f831450b62..dc796cb93a9ecbe5b7d9c3e0edaf51df9a8de9e9:/readme.htm diff --git a/readme.htm b/readme.htm index 4a643df..801fdc3 100644 --- a/readme.htm +++ b/readme.htm @@ -138,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.

@@ -150,7 +152,7 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld en

Geben 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.

Nach oben

@@ -171,8 +173,8 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld en $aliases Hier können Sie eine Alias-Namen für Empfänger angeben. Soll einem Alias mehrere Empfänger zugeordnet werden, gilt dasselbe wie für $mailto.
Die Aliase werden mit Hilfe eines assoziativen PHP-Arrays definiert. Da es wohl einige gibt, die von so etwas keine Ahnung haben und ich es nicht gut erklären kann, hier ein Beispiel:

-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') @@ -272,7 +274,7 @@ Beispiel: array('HTTP_USER_AGENT','REMOTE_ADDR') $referer_ok -Geben Sie hier die Hosts an, von denen Form E-Mail aus aufgerufen werden darf (zum Beispiel www.IhreDomain.xyz). Trennen Sie mehrere Hosts durch Semikolons.
+Geben Sie hier die Hosts an, von denen Form E-Mail aus aufgerufen werden darf (zum Beispiel www.example.com). Trennen Sie mehrere Hosts durch Semikolons.
Achtung: Mit einer Referer-Prüfung kann man zwar unbedarfte Anwender abschrecken, aber wirklich zuverlässig ist diese Methode nicht, da sich der Referer fälschen lässt oder auch komplett fehlen kann. @@ -527,7 +529,7 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede -

Weiterhin müssen Sie noch diverse Fehlermeldungen definieren (als Unter-Array). Das Definieren dieser Fehlermeldungen ist Pflicht.

+

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).

@@ -552,11 +554,11 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede - +
$user_fields['beruf']['errors']['check_fail']Die Überprüfung des Wertes durch eine PHP-Funktion ist fehlgeschlagen.Die Überprüfung des Wertes durch die PHP-Funktion ist fehlgeschlagen.
-

Zusätzlich sind noch die folgenden Einstellungen möglich.

+

Zusätzlich sind noch die folgenden Einstellungen möglich:

@@ -569,10 +571,12 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede - +
$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).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.

+

Nach oben

Templates anpassen

@@ -601,7 +605,6 @@ Die Fehlermeldung mail.txt Legt das Aussehen der Mail fest - -Zusätzlich können Sie hier durch Variablen, die mit ENV_ beginnen, Server-Umgebungsvariablen im Text einfügen (siehe auch Konfigurationsvariable $allowed_envs.
+Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden.

-!!!TODO: Individuelle Formularfelder!!! +Zusätzlich können Sie hier durch Variablen, die mit ENV_ beginnen, Server-Umgebungsvariablen im Text einfügen (siehe auch Konfigurationsvariable $allowed_envs. sent.htm Wird angezeigt, wenn die Mail erfolgreich versendet wurde - -!!!TODO: Individuelle Formularfelder!!! + +Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden. user_error.htm Wird angezeigt, wenn der Benutzer einen Fehler gemacht hat, der sich aber noch beheben lässt (zum Beispiel wenn ein Formularfeld nicht ausgefüllt wurde) - -Zusätzlich ist es möglich, einen Bereich, der nur angezeigt werden soll, wenn Captchas aktiviert sind, anzuzeigen, indem Sie diesen in folgenden Block einschließen (der {ELSE}-Teil ist optional):
+Weiterhin können Sie hier die definierten Variablen der individuellen Formularfelder (das, was Sie in tpl_var angegeben) verwenden.

-{IF CAPTCHA}Captchas sind aktiviert{ELSE}Captchas sind nicht aktiviert{ENDIF}
+Zusätzlich ist es möglich, einen Bereich, der nur angezeigt werden soll, wenn Captchas aktiviert sind, anzuzeigen, indem Sie diesen in folgenden Block einschließen (der {ELSE}-Teil ist optional):

-!!!TODO: Individuelle Formularfelder!!! +{IF CAPTCHA}Captchas sind aktiviert{ELSE}Captchas sind nicht aktiviert{ENDIF}