Konfiguration

Für die Konfiguration des Form-Mailers stehen Ihnen die folgenden Formularfelder zur Verfügung:

Formularfelder für die Grundkonfiguration:

• recipient
• realname
• email
• subject
• required
• Submit

Standard-Antwortseite anpassen:

• title
• return_link_url
• return_link_title
• background
• bgcolor
• text color
• link_color
• vlink_color

Eigene Antwortseiten verwenden:

• redirect
• missing_fields_redirect

Spamschutz-Seite konfigurieren:

• captcha_title
• captcha_text
• Spamschutz-Seite deaktivieren / aktivieren

E-Mail konfigurieren:

• sort
• env_report
• print_config
• print_blank_fields
  
  

Beispielformular

Am Ende dieser Seite finden Sie außerdem den HTML-Code eines Beispielformulars, das Sie per Copy & Paste einfach in den Quellcode Ihrer Seite übernehmen können:

Zum Beispielformular

Formularfelder für die Grundkonfiguration

Feld: recipient

Beschreibung: Über das Feld "recipient" (Empfänger) können Sie angeben, an welche E-Mail-Adresse das abgesendete Formular versendet werden soll. Mehrere Empfängeradressen können durch Komma getrennt eingegeben werden.

Syntax:

 

<input type=hidden name="recipient" value="IHRE EMAILADRESSE">

Feld: realname

Beschreibung: Über das Feld "realname" können Sie Absendern des Formulars die Eingabe ihres Namens ermöglichen. Dieses Feld ist zur Identifikation des Absenders gedacht und wird ebenfalls in der From-Zeile erscheinen.

Syntax:

 

<input type="hidden" name="realname" value="Name">

Feld: email

Beschreibung: Über das Feld "email" hat ein Absender des Kontakformulars die Möglichkeit, seine E-Mail-Adresse anzugeben.

Syntax:

 

<input type="hidden" name="email" value="E-Mail">

Feld: subject

Beschreibung: Über das Feld "subject" haben Absender des Kontaktformulars die Möglichkeit, einen Betreff für die E-Mail zu vergeben.

Syntax:

 

<input type="hidden" name="subject" value="Betreff">

Feld: required

Beschreibung: Ermöglicht die Definition von Feldern, welche vom Absender des Formulars unbedingt auszufüllen sind. Beim Versuch, das Formular ohne Ausfüllen aller definierten Pflichtfelder zu versenden, erscheint eine entsprechende Fehlermeldung.

Um hierbei eine eigene Fehlerseite anzeigen zu lassen, verwenden Sie bitte das Feld "missing_fields_redirect"

Syntax:

 

<input type="hidden" name="required" value="Feld1,Feld2,Feld3,etc">

 

Bitte ersetzen Sie hier "Feld1,Feld2,Feld3,etc" durch die Namen der Felder, welche in Ihrem Formular vom Absender unbedingt ausgefüllt werden müssen.

Feld: Submit
Attribut: value

Beschreibung: Über das Feld "Submit" ist der Button für das Absenden des Formulars in das Formular eingebunden. Das Attribut "value" legt dabei den Text für die Beschriftung des Buttons fest. Ändern Sie den Text bei "value", falls Sie die Beschriftung des Buttons ändern möchten.

Syntax:

 

<input type="submit" value="Absenden" name="Submit">

Standard-Antwortseite anpassen

Feld: title

Beschreibung: Sofern Sie keine eigene Antwortseite bereitstellen möchten, so können Sie über das Feld "title" einen Titel für die standardmäßig angezeigte Antwortseite definieren.

Syntax:

 

<input type="hidden" name="" value="">

 

Wenn Sie beispielsweise den Titel "Formularfeedback" vergeben möchten, so verwenden Sie bitte folgende Syntax:

 

<input type=hidden name="title" value="Feedback Formularergebnisse">

Feld: return_link_url

Beschreibung: Dieses Feld erlaubt die Festlegung einer URL, die als Link auf der standardmäßig angezeigten Ergebnisseite erscheint und dem Anwender die Möglichkeit gibt, beispielsweise zur Homepage zurückzukehren. Wenn Sie das Feld 'redirect' verwenden, so benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="return_link_url" value="http://ihre-domain/datei.html">

Feld: return_link_title

Beschreibung: Über dieses Feld können Sie den angezeigten Text für den über das Feld "return_link_url" festgelegten Link definieren.

Syntax:

 

<input type="hidden" name="return_link_title" value="Feedbacklink-Text">

 

Bitte ersetzen Sie hierbei "Feedbacklink-Text" durch den von Ihnen gewünschten Text.

Feld: background

Beschreibung: Ermöglicht das Einbinden eines Hintergrundbilds in die Standard-Antwortseite. Bei Verwenden einer eigenen Antwortseite über das Feld "redirect" benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="background" value="http://ihre-domain/ihr-hintergrundbild">

Feld: bgcolor

Beschreibung: Ermöglicht die Definition einer Hintergrundfarbe für die Antwortseite. Sofern Sie eine eigene Antwortseite über das Feld "redirect" verwenden, benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="bgcolor" value="#FF0000">

 

Durch "#FF0000" legen wir die Farbe Rot als Hintergrundfarbe fest. Sie können hier natürlich die Werte Ihrer Wunschfarbe eingeben.

Feld: text_color

Beschreibung: Ermöglicht die Definition der Textfarbe für die Antwortseite. Sofern Sie eine eigene Antwortseite über das Feld "redirect" verwenden, benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="text_color" value="#000000">

 

Durch "#000000" legen wir die Farbe Schwarz als Textfarbe fest. Sie können hier natürlich die Werte Ihrer Wunschfarbe eingeben.

Feld: link_color

Beschreibung: Ermöglicht die Definition der Textfarbe für Links auf der Antwortseite. Sofern Sie eine eigene Antwortseite über das Feld "redirect" verwenden, benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="link_color" value="#000000">

 

Durch "#000000" legen wir die Farbe Schwarz als Linktfarbe fest. Sie können hier natürlich die Werte Ihrer Wunschfarbe eingeben.

Feld: vlink_color

Beschreibung: Ermöglicht die Definition der Textfarbe für bereits besuchte Links auf der Antwortseite. Sofern Sie eine eigene Antwortseite über das Feld "redirect" verwenden, benötigen Sie dieses Feld nicht.

Syntax:

 

<input type="hidden" name="vlink_color" value="#000000">

 

Durch "#000000" legen wir die Farbe Schwarz als Farbe von besuchten Links fest. Sie können hier natürlich die Werte Ihrer Wunschfarbe eingeben.

Eigene Antwortseiten verwenden

Feld: redirect

Beschreibung: Wenn Sie möchten, dass Absender des Formulars nicht zur standardmäßig vorgegebenen Antwortseite, sondern zu Ihrer eigenen Antwortseite weitergeleitet werden sollen, so können Sie dies über das Feld "redirect" festlegen.

Syntax:

 

<input type="hidden" name="redirect" value="http://ihre-domain/ihre-antwortseite.html">

Feld: missing_fields_redirect

Beschreibung: Dieses Formularfeld ermöglicht die Angabe einer Fehlerseite, welche angezeigt wird, falls nicht alle benötigten Felder des Formulars ausgefüllt wurden. Sie können so die automatisch vom Skript erstellte Fehlerseite durch eine eigene ersetzen.

Über das Feld "required" können Sie festlegen, welche Felder in Ihrem Formular ausgefüllt werden müssen.

Syntax:

 

<input type="hidden" name="missing_fields_redirect" value="http://www.ihre-domain/ihre-fehlerseite.html">

Spamschutz-Seite konfigurieren

Feld: captcha_title

Beschreibung: Über das Feld "captcha_title" können Sie einen individuellen Titel für die Spamschutz-Seite hinterlegen. Wenn das Feld nicht vorhanden ist, wird die Standardüberschrift angezeigt.

Syntax:

 

<input type="hidden" name="captcha_title" value="Ihre Überschrift">

Feld: captcha_text

Beschreibung: Über das Feld "captcha_text" können Sie für den Text, der auf der Spamschutz-Seite oberhalb des Captchas angezeigt wird, einen individuellen Text hinterlegen. Ist das Feld nicht vorhanden, wird der Standardtext angezeigt.

Syntax:

 

<input type="hidden" name="captcha_text" value="Ihr Text">

Spamschutz-Seite deaktivieren / aktivieren

Wie Sie die Spamschutz-Seite deaktivieren erfahren Sie in den FAQ zum Kontaktformular bei der Frage "Wie kann ich die Seite "Spam Protection" für das Kontaktformular deaktivieren bzw. aktivieren?".

E-Mail konfigurieren

Feld: sort

Beschreibung: Über das Feld "sort" können Sie festlegen, in welcher Reihenfolge die Formularfelder in der an Sie gesendeten E-Mail erscheinen sollen. Sie können hierbei zwischen alphabetischer und einer selbstdefinierten Reihenfolge wählen. Wenn Sie dieses Feld nicht definieren, werden die Felder in der Reihenfolge ausgegeben, in welcher der Browser die Daten über das Formular an das Skript sendet.

Syntax:

• Alphabetische Reihenfolge:

  <input type="hidden" name="sort" value="alphabetic">

• Eigene Reihenfolge:

  <input type="hidden" name="sort" value="order:Feld1,Feld2,Feld3,etc"> 

  Bitte ersetzen Sie hierbei "Feld1,Feld2,Feld3,etc" durch die Angabe Ihrer Felder.

Feld: env_report

Beschreibung: Ermöglicht die Angabe von Umgebungsvariablen, deren Inhalt mit einer E-Mail mitgeschickt werden soll. Dies ist nützlich, wenn Sie beispielsweise wissen möchten, welchen Browser der Absender benutzt oder von welcher Seite er kommt.

Einige sinnvollen Variablen sind z.B.:

• REMOTE_HOST - Hostname des Absenders
• REMOTE_ADDR - IP des Absenders
• HTTP_USER_AGENT - Browser des Absenders

Auf der folgenden Seite finden Sie eine Liste mit weiteren Umgebungsvariablen: The CGI Resource Index: Documentation: Environment Variables

Syntax:

 

<input type="hidden" name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT">

 

Bitte ersetzen Sie "Variable1,Variable2,etc" durch die Eingabe Ihrer gewünschten Umgebungsvariablen. Wenn Sie beispielsweise Hostname und Browser des Absenders wissen möchten, so verwenden Sie bitte folgende Syntax:

 

<input type=hidden name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT">

Feld: print_config

Beschreibung: print_config erlaubt Ihnen die Ausgabe von Konfigurationsvariablen in einer E-Mail. Normalerweise werden diese Variablen (email, subject usw.) direkt in den Kopfteil der Nachricht geschrieben und nicht gesondert in der Nachricht selbst ausgegeben. Mit print_config können Sie dies jedoch erzwingen.

Syntax:

 

<input type="hidden" name="print_config" value="email,subject">

 

In diesem Beispiel werden die Variablen "email" und "subject" ausgegeben, Sie können hier natürlich auch weitere Variablen angeben.

Feld: print_blank_fields

Beschreibung: Mit "print_blank_fields" können Sie sich die Inhalte aller Felder ausgeben lassen, ganz gleich ob diese vom Absender ausgefüllt wurden oder nicht.

Syntax:

 

<input type="hidden" name="print_blank_fields" value="1">

Beispielformular

Nachfolgend sehen Sie den HTML-Code eines Beispielformulars, den Sie einfach per "Copy&Paste" in den Quellcode Ihrer Kontaktseite einbauen können. Ersetzen Sie den Wert "EMAIL" in der zweiten Zeile durch die E-Mail-Adresse, an die abgesendete Formulare geschickt werden sollen.

Bitte beachten Sie, dass diese E-Mail-Adresse zusätzlich in Ihrem Kundenmenü als erlaubte Empfänger-Adresse definiert werden muss. Diese Konfiguration können Sie über den Menüpunkt "Kontaktformular konfigurieren" vornehmen.

<form action="/system-cgi/formmail.pl" method="post">
<input type="hidden" name="recipient" value="EMAIL">
<input type="hidden" name="subject" value="Kontaktformular">
<input type="hidden" name="required" 
value="Vorname,Name,Strasse,PLZ,Ort,Land,email">

<label for="Vorname">Vorname</label>
<input type="text" id="Vorname" name="Vorname" size="30"><br>

<label for="Name">Name</label>
<input type="text" id="Name" name="Name" size="30"><br>

<label for="Strasse">Strasse</label>
<input type="text" id="Strasse" name="Strasse" size="30"><br>

<label for="PLZ">PLZ</label>
<input type="text" id="PLZ" name="PLZ" size="5"><br>

<label for="Ort">Ort</label>
<input type="text" id="Ort" name="Ort" size="30"><br>

<label for="Land">Land</label>
<input type="text" id="Land" name="Land" size="30"><br>

<label for="Telefon">Telefon</label>
<input type="text" id="Telefon" name="Telefon" size="30"><br>

<label for="Fax">Fax</label>
<input type="text" id="Fax" name="Fax" size="30"><br>

<label for="email">E-Mail</label>
<input type="text" id="email" name="email" size="30"><br>

<label for="nachricht">Ihre Nachricht</label>
<textarea name="Ihre Nachricht" id="nachricht" rows="8" cols="35"></textarea>

<input type="SUBMIT" name="Submit" value="Senden">

<input type="RESET" name="Reset" value="Löschen">
</form>