Access Toledo -- Generic FormMail.pl Usage Guide

Access Toledo
Generic FormMail.pl Usage

Hosted by
Access Toledo

The intent of this page is to provide you with the instructions to implement the Access Toledo generic form mailer. This mailer is based on the Perl script FormMail.pl. All web hosting customers of Access Toledo are entitled to use the form mailer.

The parameters for using this mailer are listed below. The required parameters are listed first.

<FORM>
You need to set the form statment in you HTML page as follows:

Variables - Required

The following variables are required and must be specified. ** NOTE ** -- The variable names are case specific and must be spelled exactly.

<INPUT type="hidden" name="recipient" value="emailname@yourdomain.com">

Replace emailname@yourdomain.com with the intended recipient email address (e.g. webmaster@buckeye-access.com)

<INPUT type="hidden" name="SMTP" value="mail.yourdomain.com">

Replace mail.yourdomain.com with the SMTP server name (e.g. mail.buckeye-access.com)

<INPUT type="hidden" name="subject" value="Contact Form from web site">

This can be any meaningful text that will be the subject of the email.

<INPUT type="text" name="email">
- OR -
<INPUT type="hidden" name="email" value="webmaster@yourdomain.com">

This value identifies the sender's email address. This will typically be an input field on the form (so you can reply back to the sender), but could be hardcoded as a hidden field.

Variables - Optional

The following variables are optional and can be used as needed. ** NOTE ** -- The variable names are case specific and must be spelled exactly.

<INPUT type="hidden" name="required" value="formfield1,formfield2,etc.">

Use this variable to specify the names of required fields. For example, if we have want to make sure that something is entered for the form fields name,email,Street Address & Home Phone, we would enter "name,email,Street Address,Home Phone". The names used here must match the names as entered on the <INPUT> tag(s).

<INPUT type="hidden" name="redirect" value="http://www.yourdomain.com/thankyou.html">

This can be used to display a page after successfully sending the form. This would typically be used to thank the user for completing the form.

<INPUT TYPE="hidden" SIZE="0" NAME="title" VALUE="My Feedback Form">

This can be used to specify the title of the email that is sent to the recipient.

Example
<FORM METHOD="post" ACTION="http://hosted.buckeye-access.com/cgi-bin/FormMail.pl">
<INPUT type="hidden" name="recipient" value="webmaster@buckeye-access.com">
<INPUT type="hidden" name="SMTP" value="mail.buckeye-access.com">
<INPUT type="hidden" name="subject" value="Contact Form from The MetroNet">
<INPUT type="hidden" name="required" value="name,zip,email">
<INPUT type="hidden" name="redirect" value="http://www.yourdomain.com/thankyou.html">
<INPUT TYPE="hidden" SIZE="0" NAME="title" VALUE="The MetroNet sample form mailer response">
<table>
    <tr>
        <td align="right" width="200">Name:</td>
        <td><input type="text" name="name" size="40">
</td>
    </tr>
    <tr>
        <td align="right" width="200">Address 1:</td>
        <td><input type="text" name="Street Address" size="40">
</td>
    </tr>
    <tr>
        <td align="right" width="200">Address 2:</td>
        <td><input type="text" name="Street Address2" size="40">
</td>
    </tr>
    <tr>
        <td align="right" width="200">City:</td>
        <td><input type="text" name="city" size="40">
</td>
    </tr>
    <tr>
        <td align="right" width="200">State:</td>
        <td>
            <input type="text" name="state" size="4">
                
            Zip: <input type="text" name="zip" size="10">
        </td>
    </tr>
    <tr>
        <td align="right" width="200">Email Address:</td>
        <td><input type="text" name="email" size=40>
</td>
    </tr>
    <tr>
        <td align="right" width="200">Do you use Access Toledo?:</td>
        <td>
            <input type="radio" name="Use AT" value="Yes" checked>Yes
                
            <input type="radio" name="Use AT" value="No">No
        </td>
    </tr>
    <tr>
        <td align="right" width="200">How many times a week?:</td>
        <td><select name="TimesPerWeek">
            <option value="1">1</option>
            <option value="2">2</option>
            <option value="3">3</option>
            <option value="4">4 or more</option>
            </select>
        </td>
    </tr>
</table>
<br>
<input name="Submit" type="submit" value="Send this form">
     <input name="Clear" type="reset" value="Clear this form and let me start again" >
</form>

The above source code generates the following HTML form: