Konfiguration

Achtung: Wenn Sie folgende Fehlermeldung beim Aufruf des Scripts erhalten - 'Falscher oder leerer Referrer (Verweisseite)!' - dann müssen Sie in der Datei index.php in die Variable $referring_server Ihren Servernamen (also Ihre Domain mit und ohne www und am besten auch die IP-Adresse) eintragen.

Beispiel:

$referring_server = 'www.example.com, example.com, 200.77.100.166';

Bitte beachten Sie: Tragen Sie ausschließlich Domains und IP-Addressen ein. Tragen Sie keine URLS oder Pfade ein. $referring_server darf kein http:// oder Schrägstriche enthalten.

Ein weiterer Grund für die Fehlermeldung kann sein, dass das Script direkt und ohne Klick auf einen Link beziehungsweise nicht über ein Formular aufgerufen wurde.

Sie können diese Funktion ausschalten, indem Sie diese Variable leer lassen. Das kann zu Testzwecken nützlich sein.

Einstellungsmöglichkeiten in der Datei "index.php":

$script_root

Standardmäßig enthält diese Variable folgenden Wert ./. Das bedeutet, dass alle Pfade im aktuellen Script-Verzeichnis beginnen. Sie können den Pfad ändern, wenn Sie das Script an anderer Stelle Ihrer Website einbinden (include) möchten.

$language

Tragen Sie hier das Kürzel für die Sprache ein (z.B.: de oder en). Welche Sprachen verfügbar sind können Sie im Verzeichnis /languages/ herausfinden.

Die folgende Funktion soll ebenfalls die Missbrauchsmöglichkeit des Scripts durch Dritte (Spammer) einschränken. Sie können die Anzahl der gesendeten E-Mails an die IP-Adresse des Benutzers koppeln.

$ip_banlist

In dieser Variablen können Sie IP-Adressen von Servern eintragen, die Sie von der Nutzung des Formmail-Scripts ausschließen möchten. Wenn Sie diese Funktion nicht nutzen möchten, lassen Sie die Variable einfach frei.

$ip_address_count

Tragen Sie hier die Anzahl der E-Mails ein, die ein Benutzer mit derselben IP-Adresse über das Formular absenden kann. Sollte ein Benutzer diese Zahl erreichen, kann er erst nach der nächsten Einwahl in das Internet weitere E-Mails über das Formular versenden. Die Zahl 0 (Null) schaltet die Funktion ab.

Wenn Sie diese Funktion aktivieren, wird gleichzeitig die Log-Funktion eingeschaltet. Stellen Sie deshalb sicher, dass der Ordner /logfile/ und die Log-Datei (/logfile/logfile.txt) Schreibrechte besitzen (chmod 777).

$ip_address_duration

Mit dieser Option legen Sie den Zeitraum fest, für den die oben angegebene Maximalzahl der zu versendenden E-Mails gilt. Ist diese Zeitspanne abgelaufen, kann der Benutzer wieder E-Mails mit dem Formular versenden.

$show_limit_errors

Hat ein Benutzer die maximale Anzahl seiner erlaubten E-Mails erreicht oder steht seine IP-Adresse in der Bann-Liste, können Sie ihm eine Fehlermeldung anzeigen. Wenn Sie dem Benutzer keine Fehlermeldung anzeigen lassen, wird er automatisch auf die Danke-Seite weiter geleitet. Die E-Mail wird nicht versendet.

$log_messages

Damit schalten Sie die Logging-Funktion der E-Mails ein beziehungsweise aus.

Das Verzeichnis /logfiles/ und die Datei logfile.txt müssen das Dateiattribut 777 besitzen (chmod 777) - also schreibbar sein.

Im Verzeichnis /logfiles/ befindet sich eine .htaccess-Datei. Diese Datei soll den Zugriff per Browser auf die Log-Datei verhindern. Dadurch ist sichergestellt, dass nur das Script oder Sie per FTP Zugriff auf die Datei haben.

$text_wrap

Diese Variable enthält die Anzahl der Zeichen, nach der die Zeilen in der E-Mail umbrochen werden. Wird kein Wert angegeben, wird kein Zeilenumbruch eingefügt.

$show_error_messages

Bei Auslieferung des Scripts ist diese Variable standardmäßig auf yes gesetzt. Das hat zur Folge, dass Sie bei der Konfiguration des Scripts Fehlermeldungen und Hinweise zur Einrichtung des Scripts erhalten. Sobald aber das System funktioniert, können Sie die Ausgabe der Meldungen abschalten. So verwehren Sie allzu neugierigen Besuchern den Einblick in das System.

$attachment

Detaillierte Informationen zum Versenden von Anhängen finden Sie unter Anhänge.

$captcha

Detaillierte Informationen zur Aktivierung der Captcha-Funktion finden unter Captcha-Funktion.

$path['logfile']

Diese Variable enthält den Pfad zur Log-Datei für die E-Mail-Nachrichten.

$path['templates']

Diese Variable enthält den Pfad zu den Template-Dateien (HTML und Mail). Der Pfad kann relativ (./templates/ oder templates/) und absolut (z.B.: /usr/local/etc/httpd/.../formmail/templates/ oder /kunden/homepages/.../.../htdocs/formmail/templates/) angegeben werden (immer mit Schrägstrich am Ende).

$file['default_html']

Wenn Sie das Script durch den direkten Aufruf nutzen möchten, muss diese Variable den Dateinamen des HTML-Templates enthalten. Dieses Template wird dann automatisch verwendet.

$file['default_mail']

Diese Variable enthält den Dateinamen des Mail-Templates. Dieses Template wird dann automatisch verwendet, falls nichts anderes im HTML-Template definiert wurde.

$add_text

Sie können Werte, Text, Variablen oder andere Inhalte an dieser Stelle festlegen. Diese Inhalte können Sie dann mit Hilfe von entsprechenden Markierungen (Platzhalter) in geschweiften Klammern in die Templates übertragen.

Wenn Sie eigene Werte in der Variable $add_text hinzufügen, folgen Sie bitte dem Muster, dass durch die beiden Beispieleinträge deutlich gemacht wurde.

$add_text = array(
    'txt_additional' => 'Additional',
    'txt_more' => 'More'
    );

Der erste Teil eines Eintrags (z.B.: txt_additional) stellt den Namen der Platzhalter im Template dar. Wenn Sie also den Wert von txt_additional im Template anzeigen möchten, tragen Sie dort den Namen umschlossen von geschweiften Klammern ein - {txt_additional}. Der Name darf keine Leer- oder Sonderzeichen enthalten. Erlaubt ist nur der Unterstrich.