Using WebMailer Lite

An Overview of Forms

Using WebMailer Lite with HTML forms is very easy.  Using your favorite HTML editor, create a form as you normally would.  The form's action value will need to be set to reflect the directory where the program was installed. 

For example, the form header might be: 

<FORM METHOD="POST" ACTION="http://cgi.hostingkey.com/cgi-sys/WMLite.exe">

<input name="ID" type="hidden" value="www.domain.com">
<input name="recipient" type="hidden" value="recipient@domain.com">
<input name="subject" type="hidden" value="Subject">
<input name="title" type="hidden" value="Form Title">
<input type="hidden" name="redirect" value="http://www.domain.com/successpage.html">
<input name="required" type="hidden" value="email,field1,field2,field3">
<input name="sortorder" type="hidden" value="email,field1,field2,field3">

-------------

</FORM>

Each of the settings in the previous section can then be included in most cases using the "HIDDEN" HTML input type.  The obvious exceptions would be the fields for the visitor's email address as well as the credit card fields which would be specified as the "TEXT" input type in this case.  

Please refer to an HTML reference guide for more information about creating forms.  

WebMailer Lite Form Variables

WebMailer Lite uses the contents of the actual form along with default settings from the WEBMLR.INI initialization file to determine which actions to perform once the user has submitted the form. To pass parameters to the program through a form, you will need to specify a 'NAME' and 'VALUE' for each form object.

For example, to save a person's name you would use the following tag inside the '<FORM>' tags of your form.

<INPUT TYPE="TEXT" NAME="Last_Name" VALUE="">  

<INPUT TYPE="HIDDEN" NAME="RECIPIENT" VALUE= "admin@aegeas.net">  

Once the user submits the form, WebMailer Lite will return the value of the 'Last_Name' variable in an e-mail message to admin@aegeas.net  

WebMailer Lite reserves certain values to control form processing.  By specifying the value of these variables, you can customize the behavior and output of the program. Most of these variables may be specified as the 'HIDDEN' input type . Many of the variables can also be used to retrieve information from the user within the form. In this case, the input type should be specified as "TEXT"

For example:  

To set the receipt's subject field yourself so that it is always the same, you could use the following tag within the form:  

<INPUT TYPE="HIDDEN" NAME="RECEIPT_SUBJECT" VALUE="Your receipt">   

To allow the user to enter this information, so that they can set the subject of the message which they will receive, the following tag should be used within the form:  

<INPUT TYPE="TEXT" NAME="SUBJECT" VALUE="">  

Notice the difference in the input type.