|
|
E-Mail Forms - htmail
Overview
htmail is a generic script that is made available as a standard feature
for HoloWWW sites. Using the script as an ACTION of a FORM on
your site, you can gather information from a visitor and have that
information sent in an e-mail message that contains all the values set in
the form.
The htmail FORM Tag
In your HTML document, specify the FORM as follows:
<FORM METHOD=POST ACTION="/htbin/htmail">
-- stuff here --
</FORM>
The "stuff here" would be the tags that make up the form. Any
tag which would be allowed inside of the <BODY> container of an HTML
document is allowable inside a form: headings, paragraphs, lists, tables,
images, links, etc. Certain tags, however, are allowed to exist only inside
a form.
The example below shows the use of various types of
input tags.
[Back to Top]
FORM Fields
The form may contain any number of fields, and you can name them whatever
you like. The list below details how htmail will handle these
particular fields. The names of fields that begin with "HTMail-" are
specifically used by htmail and are shown below with mixed case;
they are not case sensitive, however.
Required Fields
- To
- The e-mail address to send the message to. This is usually (but not always)
a hidden field in the form. It should be a full Internet e-mail address
in the form: "user@domain"
[Back to Top]
Optional Fields
- HTMail-NextURL (also "NextURL")
- If this field is specified, this is the next page that will be displayed.
A complete URL is required (i.e. http://domain/etc/...).
Note: If this field is used, no error or debug messages can be
displayed.
- HTMail-Debug
- Causes htmail to display a debugging message instead of actually sending
e-mail.
- HTMail-Require-From
- A valid "From" address is required. If one is not initially input, it
will be requested.
- HTMail-Verify-From
(Highly recommended!)
- Each requestor will be asked to verify their "From" address.
Note: If using this option, there is no need to also use the
"HTMail-Require-From" flag.
- From
- The value of this field is placed in the header of your message
in the "From" field. If not specified, a best guess will be attempted.
If that fails, demo@holonet.net will typically be used.
- RFC822-anything
- The value of this field is placed in the header of your message.
Note:The htmail script set the values of the fields for items
such as: To, From, Subject, Cc, Reply-To, or Errors-To to
RFC822-itemname. Thus, when used, the values of these fields will be
placed in the message header by default.
[Back to Top]
Example FORM
[Back to Top]
Example FORM Source Code
<![CDATA[
<FORM METHOD=POST ACTION="/htbin/htmail">
<INPUT TYPE=HIDDEN NAME="form_name" VALUE="htmail test form">
<INPUT TYPE=HIDDEN NAME="To" VALUE="support@holonet.net">
<INPUT TYPE=HIDDEN NAME="RFC822-Precedence" VALUE="bulk">
<TABLE WIDTH=550 BORDER>
<TR><TD ALIGN="CENTER"><b>Sample Form using htmail</b></TD></TR>
<TR><TD>
Flags:<BR>
<INPUT TYPE=CHECKBOX NAME="HTMail-debug" CHECKED>Debug (please
leave this on)<BR>
<INPUT TYPE=CHECKBOX NAME="HTMail-require-from">Require From<BR>
<INPUT TYPE=CHECKBOX NAME="HTMail-verify-from" CHECKED>Verify
From
<P>
</TD></TR>
<TR><TD>
<TABLE WIDTH=550>
<TR><TD COLSPAN=2>
Salutation:
<INPUT TYPE="radio" NAME="salutation" VALUE="Ms.">Ms.
<INPUT TYPE="radio" NAME="salutation" VALUE="Mr.">Mr.
<INPUT TYPE="radio" NAME="salutation" VALUE="None">None
</TD></TR>
<TR><TD>First Name: <INPUT TYPE="text" NAME="rfc822-first_name"
MAXLENGTH=20 SIZE=20></TD>
<TD>Last Name: <INPUT TYPE="text" NAME="rfc822-last_name"
MAXLENGTH=20 SIZE=20></TD></TR>
<TR><TD COLSPAN=2 ALIGN=CENTER>
E-Mail Address: <INPUT TYPE="text" NAME="reply-to" MAXLENGTH=35
SIZE=35> </TD></TR>
<TR><TD COLSPAN=2>
How did you find out about HoloNet?</TD></TR>
<TR><TD ALIGN=RIGHT><SELECT NAME="where">
<OPTION >Friend
<OPTION >Web Browsing
<OPTION >Search Engine (Please Specify)
<OPTION SELECTED>Other (Please Specify)
</SELECT></TD>
<TD ALIGN=LEFT><INPUT TYPE=TEXT NAME="where_specify"
VALUE=""></TD></TR>
<TR><TD COLSPAN=2>Comments:<TEXTAREA name="comments" ROWS=2 COLS=60>
</TEXTAREA></TD></TR>
<TR><TD COLSPAN=2>
What next? <BR>
<INPUT TYPE=RADIO
NAME=NextURL VALUE="http://www.holonet.net/holonet/support/holowww/
htmail-done.html">
<B>NextURL</B> "on". (If specified, debugging message will not
be displayed.)
<BR>
<INPUT TYPE=RADIO
NAME=NextURL VALUE="" CHECKED> Default -- This is what is
displayed by default if <B>NextURL</B> is <I>not</I>
specified.
</TABLE>
<TR><TD COLSPAN=2 ALIGN=CENTER>
<INPUT TYPE="submit" VALUE="Send Mail!">
<INPUT TYPE="reset" value=" Clear-Form">
</TD></TR>
</TABLE>
</FORM>
]]>
[Back to Top]
Example E-mail Sent
Return-Path: bdclown@circus.com
Received: from altmail.holonet.net (root@colossus.holonet.net
[198.207.169.10]) by holonet.net with ESMTP
id PAA28069; Thu, 24 Jun 1999 15:21:23 -0700
From: bdclown@circus.com
Received: from yori.holonet.net (demo@yori.holonet.net
[157.151.95.212]) by altmail.holonet.net with ESMTP
id PAA14940; Thu, 24 Jun 1999 15:21:15 -0700 (PDT)
Received: (from demo@localhost) by yori.holonet.net (8.8.8/8.7.3)
id PAA18206; T hu, 24 Jun 1999 15:22:47 -0700 (PDT)
Date: Thu, 24 Jun 1999 15:22:47 -0700 (PDT)
Message-Id: <199906242222.PAA18206@yori.holonet.net>
X-Authentication-Warning: yori.holonet.net: demo set sender to
bdclown@circus.co m using -f
Received: from 198.207.169.49 [198.207.169.49] by www.xxxxxxx.
holowww.com via HTTP
X-url: /
holonet/support/holowww/htmail-test
To: support@holonet.net
Precedence: bulk
Preference: both
form_name: htmail test form
salutation: None
first_name: bozo
last_name: de clown
e_mail: bdclown@circus.com
where: Web Browsing
where_specify:
comments: htmail is cool!
[Back to Top]
|
