|
CommerceStreet.com's FormMail.asp is an easy to use form handler providing
features commonly associated with Perl script handlers. It works equally well
with or without FrontPage. It is in your /cgi-sys/ directory. This is a virtual
system directory which you will not see with ftp or FrontPage. FormMail.asp
offers features not available in the standard Microsoft FrontPage form handler,
and is easier to use than Perl form handlers such as FormMail.pl.
FormMail.asp is configured with hidden form fields, as opposed to hard coding
parameters in Perl scripts. The advantages include (1) using the same form
handler for different forms with different results, (2) not having to edit Perl
scripts, and (3) forms can be processed based on a respondent's form selections.
CommerceStreet.com offers three versions of FormMail.asp, for three different
applications.
FormMail.asp reads the form fields out of the referring form and
emails the form field names and results to the addresses specified.
FormMailText.asp merges form results into text format files and emails
the form results as formatted text emails.
FormMailHtml.asp merges form results into html format files and emails
the form results as html formatted emails.
All three form handlers can merge the form results into an html results page
and send that page to the respondent's browser after the form is processed.
Using FormMail.asp
To use FormMail.asp, simply post your form to
- /cgi-sys/FormMail.asp
- /cgi-sys/FormMailText.asp or
- /cgi-sys/FormMailHtml.asp
You can not see the cgi-sys directory with ftp or FrontPage. It is a system
wide directory that all web sites can access. Do not put your domain name in
front of the /cgi-sys/, these scripts can only be run from a local web site on a
CommerceStreet.com server.
You control the form processor's behavior with form fields.
Standard Form Fields
These form fields are optional and are used if provided.
| Name |
Full name of form respondent |
| FName - LName |
First and last name of form respondent, these
values will over-ride the 'Name' field above. |
| EMail |
Email address of form respondent |
Hidden Form Fields
Field names in red are mandatory. These field values are normally defined in
hidden form fields, but can be specified with drop down menus or radio buttons
to process forms based on form selections.
| FormMailTo |
Email address to send form results to |
| FormMailSubject |
Subject line for email |
| FormMailMessageTo |
Who to send form results to, values are:
"FORMMAILTO" - results sent only to "FormMailTo" address above,
"BOTH" - results sent to "FormMailTo" address and "EMail" address.
Default value if not specified is FormMailTo address only. |
| FormMailShowBlanks |
Show blank fields in the emailed results,
values are:
"NO" - do not show blank fields,
"YES" - do show blank fields.
Default value is NO if not specified. |
| FormMailTimeStamp |
Add Date and Time stamp to emailed results,
values are:
"NO" and "YES", default value is NO if not specified. |
| FormMailNextPage |
Standard confirmation page. If defined, form
respondent is sent to this page after form is processed. |
| FormMailResultPage |
Form Merge confirmation page. If defined, form
results are merged into this page and form respondent is sent to it after
form is processed.
** Important Note: This page is written to the browser from the cgi-sys
directory. All image links and hyper links must must be fully qualified from
the web site root. |
Form Merge Confirmation Page
You can create a confirmation page that merges form information into your page.
Simply create an html (or asp) page and place your form field names in merge
brackets like this: <!FieldName>. That is, place <! before the form field name
and > after it. Do not put spaces between the merge marks and the form field
names. Place <!timestamp> anywhere you would like the system date and time
placed. You do not need to define this field in your form, the system defines it
for you.
** Important Note: This page is written to the browser from the cgi-sys
directory. All image links and hyper links must must be fully qualified from the
web site root.
List-Server Subscription Form Fields
You can subscribe your form respondent to a list-serv mailing list by defining
these fields. Normally, the FormMailList field would be set to SUBSCRIBE by the
respondent checking a "subscribe me" box.
| FormMailList |
Set to "SUBSCRIBE" to subscribe respondent to
list-server list |
| FormMailListDomain |
Domain name of list server. |
| FormMailListName |
List name on list server |
Sample Usage of FormMail.asp
You can use these sample forms to see how the FormMail-asp form handlers work,
and as samples to create your own forms:
FormMail.asp Sample
Compatibility with FrontPage and Dreamweaver
FormMail.asp is completely compatible with Microsoft FrontPage,
Macromedia Dreamweaver and all other web site authoring software.
|
