FormMail - Usage

This is FormMail V1.5

All formfields are available in any Template using '@' as pre-/postfix around the name. eg. If you have a Field named "test" in your Form and
you would like to print it in the response Email, write @TEST@ at the position where you want it to appear
NOTE: Fieldnames must be in UPPERCASE between the 2 '@'s
FormMail handles GET and POST requests the same way.

To control the behavior or FormMail there exists some special Fields. These Fields are prefixed with a single Underscore '_' and are as follows:

_From Contains the senders Email address. Optional. Only required if a response Email should be sent back to the submitter of the Form.

_To Contains the receivers Email address. Mandatory.

_Subject Optional Subject text to appear at the reciver.

_Importance Optional importance of the mail. Possible values are:

2 High

1 Normal

0 Low

Other values are changed to normal.

_MailTemplate Name of a local (local to the web server) file which contains a template (stylings etc.) for the mail which should be sent

_ResponseMailTemplate local file with template for the response mail

_ResponsePageTemplate local file with template for the response html page if this file starts with http:// then a redirect to this url is done (but no field translation inside the remote file is done)
NOTE: fields can also be sent in case of a redirection. see mail.htm for an example
NOTE: all templates are optional if no template for a type is given then in case of the MailTemplate a standard email containing all fields of the form in the format name = value is sent. in the case of ResponseMailTemplate and ResponsePageTemplate a a standard text
"Thanks for filling in this form." is sent
NOTE: all templates are local VIRTUAL paths to access local physical paths set the IIS metabase variable "AspEnableParentPaths" to true for the virtual directory in which FormMail resides

_ErrorPageTemplate local file with template for the error html page if this file starts with http:// then a redirect to this url is done (but no field translation inside the remote file is done)

a few special fields are availabel. special fields should not occure as standard fields in webformulars. these fields are prefixed with
a double underscore '_' and are as follows:

@__ALL@ Inserts all available fields in the form: name = value

@__DATE@ Inserts the actual local formated date

@__TIME@ Inserts the actual local formated time

@__REMOTE_ADDR@ IP Address of the client (Browser)

@__REMOTE_HOST@ DNS name of the client (Browser) - if available

@__REMOTE_USER@ Inserts the username if form is password protected - if available

@__SERVER_NAME@ DNS name of of the Web server where FormMail is running

@__HTTP_REFERER@ Inserts the referer

@__MISSING@ if required form fields are specified using RequiredFields then this field contains errornous fields (which are mandatory but the user has filled it in

@__ALL@	Inserts all available fields in the form: name = value
@__DATE@	Inserts the actual local formated date
@__TIME@	Inserts the actual local formated time
@__REMOTE_ADDR@	IP Address of the client (Browser)
@__REMOTE_HOST@	DNS name of the client (Browser) - if available
@__REMOTE_USER@	Inserts the username if form is password protected - if available
@__SERVER_NAME@	DNS name of of the Web server where FormMail is running
@__HTTP_REFERER@	Inserts the referer
@__MISSING@	if required form fields are specified using RequiredFields then this field contains errornous fields (which are mandatory but the user has filled it in