2.FormMail 1.6 dt (modifiziert)

Transkript

1 2.FormMail 1.6 dt (modifiziert) 2.1 Was ist FormMail? FormMail ist ein einfaches CGI-Programm, das in einem Formular bestimmte Informationen erfaßt und diese an eine bestimmte -adresse sendet. FormMail ist ein im WWW universal verwendetes from-to- Gateway. Andere, versteckte Konfigurationsfelder können verwendet werden, um die Ausführung von FormMail auf Ihre Webseite anpassen. Das Copyright von FormMail liegt bei Matt Wright ( FormMail wurde von uns komplett übersetzt und um einige nützliche Optionen erweitert, die es erlauben die Bestätigungsseite von FormMail genauer an das Layout der eigenen Seiten anzupassen. FormMail ist für jeden der folgenden Vorgänge nützlich und sinnvoll: Wenn Sie auf Ihrer Website ein Formular einbinden, daß per von Ihrer Website aus an Sie gesendet werden soll. Wenn Sie für alle html-formulare ein einheitliches Skript verwenden möchten, das die Möglichkeit enthält, ausgefüllte Formulare per an Sie zu senden. 2.2 So installieren Sie FormMail auf dem Server Nun müssen Sie eine kleine Änderung an dem Skript vornehmen, laden Sie das Skript in einen Editor (UltraEdit32,nicht Word)und ändern Sie den folgenden Eintrag in Zeile 39: = ('IHR-DOMAIN.de',' Fügen Sie für IHR-DOMAIN bitte den jeweiligen Domainnamen ein, unter dem FormMail genutzt werden kann. Weitere Anpassungen sind nicht nötig. Mit Ihrem FTP-Programm laden Sie Ihr konfiguriertes Skript in Ihr Verzeichnis /cgi-bin/. Bitte achten Sie auf die Übertragungsart, diese sollte "Auto" oder "ASCII" bei Ihrem FTP- Programm lauten. Nach dem "upload" des Skriptes in Ihr /cgi-bin/ Verzeichnis auf dem Server müssen Sie das Skript noch mit dem Befehl "chmode" ausführbar machen. Markieren Sie das Skript in Ihrem FTP-Programm (auf dem Server) und wählen ie "chmod"und den Wert "755". Unter WS-FTP markieren Sie die Datei auf dem Server und rufen mit der rechten Maustaste chmod auf. 2.3 Formulare für die Nutzung mit FormMail konfigurieren Ihr Formular muß FormMail ausführen. Sie binden den Verweis mittels PO T oder GET (in Großbuchstaben ausgeschrieben)in Ihr Formular ein. Ab Version 1.5 bietet Ihnen FormMail verschiedene Möglichkeiten. Ihr Formular zu kodieren und festzulegen, wie die Ergebnisseite aussehen soll. Nachstehend finden Sie eine Liste von Formularfeldern, die Sie verwenden können sowie entsprechende Anleitungen, wie Sie diese Felder in Ihr Formular einbinden. Beispiel: <form action=" method="post"> <input type=hidden name="recipient" value=" @ihr-domain.de"> <input size=40 name="ihr Name" maxlength="200"> </form> Ersetzen Sie bitte @ihr-domain.de durch Ihre gültige -adresse.

2 2.4 Notwendige Formularfelder: Es gibt lediglich ein Formularfeld, das Sie in Ihr FormMail-Formular einfügen müssen,damit es korrekt ausgeführt werden kann. Es ist das Feld recipient (Empfänger). Feld:Recipient Beschreibung: Festlegung, an wen die Formular-Ergebnisse gesendet werden sollen. Wahrscheinlich möchten Sie diese Option als verstecktes Feld mit Ihrer eigenen -adresse konfigurieren. Dies tun Sie mittels dem Befehl value=ihre -adresse Syntax:<input type=hidden name="recipient" 2.5 Optionale Formularfelder: Feld:subject Beschreibung:Das Feld subject fürgt eine Betreffszeile in Ihr Formular ein. Falls Sie kein Betreffsfeld einfügen, gibt das Skript die Vorgabe, daß in der , die Sie dann erhalten,als Betreff "WWW Form Submission." erscheint. Syntax: Für den Fall, daß Sie selbst festlegen möchten, wie das Subject lauten soll: <input type=hidden name="subject" value="your Subject"> Für den Fall, daß Sie es dem Nutzer überlassen möchten, was er als Betreff eingibt: <input type=text name="subject"> Feld : Beschreibung: In diesem Feld kann der Absender seine -adresse (Antwort-Adresse) eingeben. Wenn Sie gegebenenfalls auf s, die Sie erhalten, antworten möchten, empfehlen wir Ihnen auf jeden Fall, dieses Feld in Ihr Formular mit einzubinden. Wenn Sie möchten, daß der Absender auf jeden Fall eine gültige -adresse angibt, um das Formular abschicken zu können, können Sie das Feld um die Funktion Eingabe erforderlich erweitern. Die tun Sie, indem Sie zu dem -feld die Feldfunktion "required" hinzufügen. Syntax:<input type=text name=" "> Feld:Realname Beschreibung: In dem Formular- Feld realname können die Nutzer ihren vollständigen Namen einfügen. Das Feld ist nützlich für Identifikations-Zwecke und erscheint dann in der Titelzeile des Formulars. Syntax:<input type=text name="realname"> Feld:Redirect Beschreibung: Wenn Sie das Formular so einrichten möchten, daß der Sendebericht /die Bestätigung für den Nutzer auf einer neuen Webseite angezeigt wird, so können Sie diese versteckte Variable verwenden. Syntax:Um die URL zu wählen,unter der der Bestätigungstext angezeigt werden soll, geben Sie folgendes ein: <input type=hidden name="redirect" value=" Um Nutzer die zu überlassen,welche URL Sie nach absenden des Formularswählen,geben Sie ein: <input type=text name="redirect">

3 Feld:Required Beschreibung: Sie können festlegen, daß bestimmte Formular- Felder zwingend ausgefüllt werden müssen, um das Formular absenden zu können.geben Sie in diesem Feld alle Pflicht-Felder an. Wenn die erforderlichen Felder nicht ausgefüllt werden, wird der Nutzer automatisch darauf hingewiesen, daß eine Eingabe zwingend ist und zum Formular zurück geleitet, um die Eingaben vorzunehmen. Wie Sie eine selbst definierte Fehlermeldung erzeugen,lesen Sie bitte unter 'missing_fields_redirect'. Syntax: Um zu gewährleisten,daß Nutzer beispielsweise jeweils das -und Telefonfeld ausfüllen,würden Sie folgende Syntax verwenden: <input type=hidden name="required" value=" ,phone"> Feld: env_report Beschreibung: Dieses Feld gibt Ihnen die Möglichkeit, mehr über das Umfeld des Absenders einer zu erfahren, bspw. den verwendeten Browser,d ie Domain und ähnliche Angaben. Die folgende Liste gibt Ihnen eine Reihe an zulässigen und möglicherweise sinnvollen Komponenten an: REMOTE_HOST - Sendet den Namen des Hosts, der die Anfrage stellt. REMOTE_ADDR - Sendet die IP-Adresse des Hosts, der die Anfrage stellt. REMOTE_USER - Wenn der Server die Authentifikation des Nutzers zuläßt und ein geschütztes Skript verwendet, erhalten Sie über diesen Befehl den entsprechenden User-Namen. *Bitte beachten Sie, daß dies nicht üblich ist* HTTP_USER_AGENT Gibt den für die Anfrage verwendeten Browser an. Es gibt noch weitere Variablen. Wir wollten Ihnen hiermit einen kurzen Einblick in die wichtigsten und am ehesten nützlichen Variablen geben. Für weitere Informationen über Umfeld-Variablen besuchen Sie bitte die Webseite unter folgender URL: Syntax: Wenn Sie Name und verwendeten Browser des anfragenden Hosts erfahren möchten, geben Sie bitte folgende Befehlszeile in Ihr Formular ein: <input type=hidden name="env_report" value="remote_host,http_user_agent"> Feld:sort Beschreibung: Mit sort können ie die Reihenfolge festlegen, in der die Komponenten in der durch FormMail erzeugten erscheinen sollen.sie können beispielsweile alphabetisch sortieren lassen, oder andere Kriterien für den Sortiervorgang festlegen. Wenn Sie das Feld übergehen, entspricht die Reihenfolge ganz einfach der Reihenfolge, in der der Browser die Informationen an das Skript sendet (in der Regel ist das die Reihenfolge der Formularfelder, so wie sie im Formular nacheinander erscheinen).um einen Sortiervorgang festzulegen, fügen Sie bitte den Ausdruck "order:" als ersten Wert in der u.g. Syntax ein, gefolgt von den Feldnamen in der Reihenfolge, wie Sie aufgelistet werden sollen (jeweils durch das Kommazeichen getrennt).version 1.6 ermöglicht Ihnen noch ein wenig mehr Flexibiltät beim Auflisten der Felder, insofern als daß Sie Leerzeichen und Bindestriche in den Feldern verwenden können, ohne daß dadurch der Sortiervorgang beeinträchtigt wird. Dies ist bspw. dann nützlich, wenn Sie sehr viele Formularfelder verwenden und eine Leerzeile einfügen möchten, um die Übersicht zu behalten.

4 Syntax: Alphabetisches Sortieren: <input type=hidden name="sort" value="alphabetic"> benutzerdefineirtes Sortieren: <input type=hidden name="sort" value="order:name1,name2,etc..."> Feld:Print_config Beschreibung: Durch Print_config können Sie festlegen, welche der Konfigurationsvariablen von FormMail in der -nachricht erscheinen sollen. Wenn Sie Print_config auslassen, erscheint keines der Konfigurationsfelder in der ,da die wichtigen Formularfelder (wie ,ubject usw.) im Header der Nachricht enthalten sind. Dennoch haben Nutzer schon nach dieser Option gefragt,damit sie diese Felder in den Textkörper der Nachricht einfügen können. Die Konfigurationsfelder, die Sie gerne abgedruckt haben möchten, legen Sie in der Eingabe-Syntax bitte als Attribute von value fest,jeweils durch ein Komma getrennt. Syntax:<input type=hidden name="print_config" value=" ,subject"> Feld: print_blank_fields Beschreibung:Mittels print_blank_fields können Sie festlegen,daß alle Formular-Felder in der HTML-Antwortseite abgedruckt werden,unabhängig davon,ob sie ausgefüllt wurden oder nicht.ansonsten werden nur diejenigen Felder angezeigt,die auch ausgefüllt wurden. Syntax: Wenn Sie alle Felder, auch die unausgefüllten, abgedruckt haben möchten, geben Sie bitte ein: <input type=hidden name="print_blank_fields" value="1"> Feld: Title Beschreibung: Mit diesem Formularfeld können Sie Titel und Header festlegen, die in der Antwortseite erscheinen sollen, für den Fall, daß Sie keine redirect URL angegeben haben. Syntax: Zur Festlegung eines Titels, bspw.'feedback Form Results',geben Sie bitte ein: <input type=hidden name="title" value="feedback Form Results"> Feld: return_link_url Beschreibung: Dieses Feld erlaubt es Ihnen, eine URL festzulegen,die als return_link_title im Sendebericht erscheint. Wenn Sie bereits das redirect -Feld eingesetzt haben, können Sie dieses Feld nicht verwenden.allerdings ist es dennoch nützlich, wenn Sie es den Nutzern ermöglichen wollen, den Sendebericht auf der nächsten Seite zu empfangen, von der aus sie dann wieder zurück zu Ihrer Startseite gelangen. Syntax:<input type=hidden name="return_link_url" value=" Feld: return_link_title Beschreibung: Dieses Feld verwenden Sie,um die Nutzer per Link zu einer bestimmten Seite, die Sie mittels return_link_url festlegen zurückzuleiten.die beiden Felder werden auf der Ergebnisseite als return_link_title angezeigt. Syntax:<input type=hidden name="return_link_title" value="back to Main Page">

5 Feld: missing_fields_redirect Beschreibung:Mit diesem Formular-Feld können Sie eine URL festlegen, um Nutzer zum Ausgangsformular zurückzuleiten,wenn nicht alle erforderlichen Felder ausgefüllt wurden. so erzeugen Sie eine formale Fehlermeldungsseite, anstelle einer bloßen technischen Fehlermeldung. Syntax:<input type=hidden name="missing_fields_redirect" value=" Feld: Background Beschreibung Mit diesem Formularfeld können Sie eine Hintergrund-Grafik einfügen, die erscheint, wenn Sie das redirected-feld nicht verwenden. Die Grafik erscheint dann als Hintergrund der Ergebnisseite des Formulars. Syntax:<input type=hidden name="background" value=" Feld: bgcolor Beschreibung: Dieses Feld ermöglicht Ihnen, eine Hintergrundfarbe für die Ergebnisseite des Formulars festzulegen. In der Regel wird jedoch eine Hintergrundgrafik verwendet. Sie können das bgcolor -Feld nur verwenden, falls Sie nicht bereits das redirect -Feld einsetzen. Syntax: Beispielsweise für die Hintergrundfarbe weiß geben Sie ein: <input type=hidden name="bgcolor" value="#ffffff"> Feld: text_color Beschreibung Dieses Feld funktioniert analog zu bgcolor, nur daß nun die Farbe des Textes angepaßt wird. Syntax: Für einen Text in der Farbe schwarz würden Sie eingeben: <input type=hidden name="text_color" value="#000000"> Feld: link_color Beschreibung Mittels link_color ändern ie die Farbe der Links auf der Ergebnisseite analog zu text_color. Beachten Sie bitte auch hier, daß Sie link_color nur verwenden, wenn Sie nicht bereits redirect verwenden. Syntax:Um für einen Link die Farbe rot zu verwenden,würden Sie eingeben: <input type=hidden name="link_color" value="#ff0000">

6 Feld: vlink_color Beschreibung: Mit vlink_color ändern Sie die Farbe bereits besuchter Links auf der Ergebnisseite. Sie verwenden vlink_color ganz genau so wie link_color und auch hier wieder nur dann, wenn nicht bereits redirect eingesetzt wird. Syntax: Um einen bereits besuchten Link blau darzustellen, würden Sie eingeben: <input type=hidden name="vlink_color" value="#0000ff"> Feld:alink_color Beschreibung: Mit alink_color passen ie analog zu link_color und unter der Voraussetzung, daß nicht bereits redirect verwendet wird, die Farbe eines aktiven Links auf der Ergebnisseite an. Syntax: Um einen aktiven Link blau darzustellen, würden Sie eingeben: <input type=hidden name="alink_color" value="#0000ff">