cgifile – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

cgiemail, cgiecho, cgifile - CGI-Form-zu-Mail-Konvertierungstools

Das cgiemail Benutzer Guide

Diese Anleitung hilft Ihnen beim Schreiben eines WWW-Formulars, das Ihnen eine E-Mail-Nachricht sendet. Die
folgende Schritte sind erforderlich:

· Erstellen Sie eine E-Mail-Vorlage.

· Setzen Sie einen Link zur Vorlage auf Ihrer Seite.

· Entscheiden Sie, ob ein mailto:-Link ausreicht.

· Erstellen Sie das HTML-Formular.

· Erstellen Sie erweiterte HTML-Formulare.

· Stellen Sie sicher, dass die AKTION richtig ist.

· Testen Sie Ihre Form mit cgiecho.

· Gehen Sie mit cgiemail live.

· Debuggen, wenn Sie keine E-Mails erhalten

Die folgenden Schritte sind optional.

· Text zur Erfolgsseite hinzufügen.

· Verwenden Sie eine alternative Erfolgsseite.

· Machen Sie einige Eingaben erforderlich.

· Formatierung für einige Eingaben angeben.

· Verwenden Sie CGI-Umgebungsvariablen.

Erstellen an Email Vorlage.
Bevor Sie beginnen, E-Mail-Nachrichten über das Web zu empfangen, sollten Sie entscheiden, welche
Nachrichten aussehen sollten. Erstellen Sie eine ASCII-Datei, eine sogenannte E-Mail-Vorlage, die aussieht wie
etwas wie das:

Bis: [E-Mail geschützt] KOPFZEILEN
Betreff: Fragen drei
Leerzeile
Wie heissen Sie? [dein Name]
Was ist deine Suche? [Quest] KÖRPER
Was ist deine Lieblingsfarbe? [Farbe]

In gewisser Hinsicht ist diese Vorlage frei. Personen, die Ihnen E-Mails senden möchten, können herunterladen
diese Vorlage aus, füllen Sie sie aus und senden Sie sie per Post zu. Es wird jedoch auch die Vorlage verwendet
durch das cgiemail-Programm, also bevor Sie die Datei auf Ihren WWW-Server hochladen, achten Sie darauf, dass
befolgen Sie diese Richtlinien:

· Wo immer Sie möchten, dass der Benutzer Ihres Formulars Informationen liefert, verwenden Sie ein einziges Wort
in eckigen Klammern ohne Leerzeichen, zB Ihr Name: [Ihr Name]. Nicht [Setze deinen Namen ein
Hier].

· Stellen Sie sicher, dass die Adresse im Feld An: korrekt ist.

· Entfernen Sie Leerzeilen zwischen den Kopfzeilen.

· Entfernen Sie Leerzeilen vor den Kopfzeilen.

· Stellen Sie sicher, dass alle Ihre Kopfzeilen gültig sind. Das erste Zeichen in der Zeile muss a . sein
Buchstabe. Die meisten Informationen sollten im Nachrichtentext enthalten sein; erfinde dich nicht selbst
Überschriften.

· Stellen Sie sicher, dass sich zwischen den Kopfzeilen und dem Text eine Leerzeile befindet.

· Stellen Sie sicher, dass Sie es als ASCII-Text speichern. Wenn Sie beispielsweise Microsoft Word verwenden, verwenden Sie
"Speichern unter" und wählen Sie "Nur Text mit Zeilenumbrüchen".

· Wenn Sie die Datei auf einem Mac erstellt haben, stellen Sie sicher, dass Sie sie als Text hochladen, dh übersetzte CRs.
(Unix-Computer haben andere Codes, die das Ende einer Zeile kennzeichnen als Macs, also haben Sie
Datei könnte für den Unix-Computer wie eine lange Zeile aussehen.)

Innerhalb dieser Richtlinien gibt es viel Flexibilität. Sie können Bcc:, X-Face: oder alle eingeben
andere Überschrift in den Überschriften. Sie können Dinge wie Cc: [Ihr Name] in die Kopfzeilen einfügen. Sei
kreativ. Geben Sie dort einfach nichts ein, was Ihr Webmaster nicht sehen soll.
denn dort landen unzustellbare Nachrichten.

Laden Sie nun Ihre E-Mail-Vorlage auf den WWW-Server hoch und sehen Sie sie mit Ihrem
WWW-Browser.

setzen a Link zu Vorlage on Ihre
Hier ist ein Beispiel:

Möchten Sie die Brücke überqueren? Laden Sie mein Formular "Fragen drei" herunter und senden Sie es an
<[E-Mail geschützt] >.

Auch nachdem Sie Ihr WWW-Formular erstellt haben, möchten Sie diesen Link zum Vergrößern belassen
Zugänglichkeit für Benutzer mit Behinderungen.

Beschließt, if a mailto: Link werden wir zu tun.
Schon jetzt haben Sie ohne kompliziertes HTML eine Möglichkeit für Leute im WWW, Sie zu senden
die gewünschten Informationen. Bevor Sie sich die Mühe machen, ein HTML-Formular zu erstellen, entscheiden Sie, ob
es lohnt sich wirklich. Formulare im WWW haben insbesondere zwei Nachteile:

· Sie werden viele frivole E-Mails von Leuten bekommen, die nur ``im Internet surfen''.

· Die E-Mail-Adresse des Benutzers wird manuell eingegeben und wird häufig falsch eingegeben, sodass Sie
keine Möglichkeit zu antworten. Bei mailto:-Links ist das weniger problematisch.

Erstellen HTML Form.
Wenn Sie sich entschieden haben, ein HTML-Formular zu erstellen, müssen Sie den Leuten die Möglichkeit geben, ein
E-Mail-Addresse. Mit dem mailto:-Link würde ihr Mailer die From:-Adresse für . liefern
Sie. Aber jetzt müssen Sie am Anfang Ihrer E-Mail-Vorlage eine Zeile wie folgt hinzufügen:

Aus der Email]

Hier ist ein Beispiel-HTML-Formular.

Ihre E-Mail-Adresse: ____________________

Dein Name: ____________________

Ihre Suche: ____________________

Deine Lieblingsfarbe: ____________________

E-Mail senden (In diesem Beispiel werden keine E-Mails gesendet.)

Dies ist die HTML-Quelle:

<FORM METHOD="POST"
AKTION="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Ihre E-Mail-Adresse:
Dein Name:
Ihre Suche:
Ihre Lieblingsfarbe:



Dies ist ein sehr einfaches Beispiel. Beachten Sie, dass der NAME jedes Eingangs dem entspricht, was Sie
zuvor in die E-Mail-Vorlage eingefügt. In diesem Beispiel sind dies E-Mail, Ihr Name, Quest,
und Farbe. Dies ist das Schlüsselkonzept bei der Verwendung von cgiemail. Achten Sie darauf, dass sie genau die
gleich; wenn Sie NAME="colour" in Ihr HTML-Formular und [color] setzen (achten Sie auf die Schreibweise
Differenz) in Ihrer E-Mail-Vorlage, wird die Eingabe nicht in der E-Mail angezeigt.

Erstellen mehr advanced HTML Formen.
Um zu erfahren, wie Sie kompliziertere Formulare erstellen, lesen Sie den NCSA-Leitfaden. Alle ihre Beispielformen
können in cgiemail-Formulare umgewandelt werden, indem lediglich die AKTION geändert wird. Im Gegensatz zu anderen Formen-zu-
E-Mail-Programmen müssen Sie keine versteckten Eingaben mit speziellen Namen verwenden.

Alle Arten von Eingaben (Radiobuttons usw.) funktionieren auf die gleiche Weise. Jeder Eingang benötigt einen NAMEN, und
dieser Name muss in Ihrer E-Mail-Vorlage in eckigen Klammern stehen. So einfach ist das. Zu
Weitere Ideen finden Sie auf der cgiemail-Beispielseite.

Marke sicher AKTION is korrigieren.
Der schwierigste Teil des HTML-Formulars besteht darin, die AKTION richtig einzustellen. Beginnen Sie mit dem
URL Ihrer E-Mail-Vorlage, dann teilen Sie sie in zwei Teile auf, zB

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ /\ /
`--- Teil 1 ---' ` -------- Teil 2 ----------'

Dann setzen Sie den Skriptnamen in die Mitte. Normalerweise ist dies ``/cgi-bin/cgiecho'', aber es
hängt davon ab, wie Ihr Server konfiguriert ist. Auf web.mit.edu ist es zufällig
``/bin/cgiecho'', also sieht meine AKTION so aus:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- Teil 1 ---' Skriptname ` -------- Teil 2 ----------'

Der Einfachheit halber können Sie Teil 1 weglassen, aber Sie müssen ihn hinzufügen, wenn Sie Ihr testen möchten
als lokale Datei formatieren. Wenn Sie nicht wissen, was das bedeutet, können Sie Teil 1 einfach weglassen.

MIT DER INTELLIGENTEN SCHADENKALKULATION VON Ihre unten stehende Formular mit cgiecho.
Laden Sie Ihr Formular in Ihren bevorzugten WWW-Browser, füllen Sie die Eingaben aus und senden Sie es ab. Du
sollte sehen, wie das verarbeitete Formular aussieht. Wenn stattdessen ein Fehler mit einer Zahl angezeigt wird
nahe 500 ist Ihre AKTION wahrscheinlich falsch eingestellt. Gehen Sie zurück zum vorherigen Schritt.

Wenn einige Ihrer Eingaben nicht im verarbeiteten Formular angezeigt werden, stellen Sie sicher, dass
die Eingaben haben im HTML-Formular genau die gleichen Namen wie in der ASCII-Vorlage. Z.B
NAME="yourname" im HTML-Formular und [yourname] in der E-Mail-Vorlage.

Go leben mit cgiemail.
Ändern Sie nun cgiecho in cgiemail in der ACTION Ihres HTML-Formulars. Versuch es. Du solltest
eine E-Mail-Nachricht mit dem bearbeiteten Formular erhalten. Wenn Sie eine Erfolgsseite erhalten, aber nicht
Mail empfangen, liegt ein Problem mit Ihrer Vorlagendatei vor. Geh zurück und vergewissere dich, dass du
die Anweisungen in Schritt 1 korrekt befolgt.

Wenn es funktioniert, herzlichen Glückwunsch!

9. Debuggen, wenn Sie keine E-Mails erhalten

Normalerweise werden E-Mails asynchron gesendet, d. h. sie werden in eine Warteschlange eingereiht, um an a . gesendet zu werden
bequeme Zeit. Asynchrone Mail wird effizienter und zuverlässiger versendet, hat aber die
Nachteil, dass Probleme nur durch Rücksendung einer Fehlermeldung an den . gemeldet werden können
Absender. Für das Mailsystem scheint der Absender der Mail der Webserver zu sein, also
die Fehlermeldung kommt nicht bei dir an.

Wenn Sie keine E-Mails erhalten, können Sie die synchrone E-Mail-Zustellung vorübergehend verwenden, indem Sie . erstellen
eine versteckte Eingabe namens cgiemail-mailopt und einen Wert, der "sync" enthält, zB



Hinweis: Für Version 1.1 wird dies nicht funktionieren. Bitten Sie Ihren Webmaster, eine neuere Version zu installieren.
Einige Mailer haben eine nicht standardmäßige Erweiterung, die Bounces an eine Adresse in einem Errors-
To: Header zusätzlich zum Webserver. Einige Fehler machen jedoch diese Kopfzeile
unlesbar, daher gibt es keine Möglichkeit, absolut sicher zu gehen, dass der Bounce an Sie geht.

Optional: Speichern Text zu Erfolg
Wenn eine E-Mail gesendet wird, wird eine Seite mit dem Titel ``Erfolg'' mit dem Text der E-Mail-Nachricht angezeigt.
Sie können eine versteckte Variable namens ``Addendum'' verwenden, um Ihren eigenen Text hinzuzufügen. Hier ist ein einfaches
Beispiel:



Wenn Sie bereit sind, davon auszugehen, dass die Leser Ihres Formulars aktuelle Browser-Software verwenden
wie Lynx 2.6 oder Netscape 3.0, dann können Sie HTML-Markup in diese Variable einfügen, indem Sie den
entsprechende Charakterentitäten. Zum Beispiel, wenn Sie hinzufügen möchten

Vielen Dank!

dann wäre das HTML-Markup

Dankeschön!

Das heißt, Sie benötigen Folgendes in Ihrem Formular:

<INPUT TYPE="hidden" NAME="addendum"
VALUE="<em>Danke!</em>">

Beachten Sie, dass diese Funktion nicht nur schwer zu schreiben ist, sondern auch bei älteren Benutzern nicht funktioniert
Browser-Software.

Optional: Verwenden Sie die an wechseln Erfolg
Wenn Ihnen die Standardseite, die beim erfolgreichen Senden der E-Mail angezeigt wird, nicht gefällt, können Sie
Geben Sie eine alternative URL an, indem Sie eine versteckte Variable namens ``Erfolg'' in Ihrem HTML-Formular verwenden,
z.B

<INPUT TYPE="versteckt" NAME="Erfolg" VALUE="http://web.mit.edu/">

Hinweis: Beginnen Sie Ihre URL mit / oder mit http://. Andernfalls leitet cgiemail Ihren Browser weiter
zu einem zweiten Aufruf von cgiemail, was zu dem Fehler Keine Variablenersetzungen führt.

Ab Version 1.3 gibt es keine Möglichkeit, diese alternative Erfolgsseite mit Informationen zu versehen
der Benutzer in das Formular eingegeben. Diese Funktion wird wahrscheinlich in einer zukünftigen Version hinzugefügt.

Optional: Marke einige Eingänge erforderlich.
Wenn Sie Formulare, bei denen bestimmte Eingaben leer gelassen wurden, automatisch ablehnen möchten, fügen Sie das
Präfix ``erforderlich-'' vor dem Namen der Eingabe sowohl in Ihrem HTML-Formular als auch in Ihrer E-Mail
Vorlage. Hier ist ein Beispiel:

Im HTML-Formular:

Dein Name:

In der E-Mail-Vorlage

Ihr Name: [Pflichtfeld-Ihr Name]

Optional: Angeben Formatierung für einige Eingänge.
Wenn in Ihrer E-Mail-Vorlage der Text in eckigen Klammern mit % beginnt, wird cgiemail
verwenden Sie die printf () Funktion in C auf den Feldnamen nach dem Komma. Wenn Sie nicht vertraut sind
mit dieser Funktion, schauen Sie in einem Buch zu C nach. Wenn Sie damit vertraut sind, beachten Sie bitte diese
zwei unterschiede:

· Das erste Zeichen in der Formatzeichenfolge muss % sein.

· Zeichen wie \n und \t müssen literal sein. Wenn Sie einen Zeilenumbruch möchten, müssen Sie ein
Newline kurz vor dem Komma, auch wenn das seltsam aussieht. Zum Beispiel, wenn
Godzilla's Pizza wollte einen Belag pro Zeile auflisten, sie würden die folgenden einfügen
ihre E-Mail-Vorlage:

[%S
,Belag]

Optional: Verwenden Sie die CGI Umwelt Variablen.
Diese Funktion kann funktionieren oder nicht, je nachdem, ob Ihr Webmaster sie aktiviert hat oder nicht.
beim Konfigurieren von cgiemail.

Zusätzlich zu Formulareingaben kann Ihre E-Mail-Vorlage CGI-Umgebungsvariablen enthalten
indem Sie dem Variablennamen einfach ein Dollarzeichen voranstellen. Zum Beispiel,

[$HTTP_USER_AGENT]

wird den Namen des Browsers und/oder des Gateways des Benutzers in Ihre E-Mail-Nachricht einfügen. Um zu
respektieren Sie die Privatsphäre, Ihr HTML-Formular sollte die Benutzer vor allen Informationen über warnen
die in die E-Mail aufgenommen werden, zB HTTP_USER_AGENT, REMOTE_ADDR.

Verwaltung
Vorgelagerter Kontakt: cgiemail[E-Mail geschützt] >

Debian-Betreuer: Anibal Monsalve Salazar[E-Mail geschützt] >

Vollständige Informationen zum Erstellen, Installieren und Verwenden von cgiemail finden Sie im WWW:

http://web.mit.edu/wwwdev/cgiemail/

Verwenden Sie cgifile online über die Dienste von onworks.net