 |
|
|
|
|
|
|
|
|
 |
 |
 |
|
|||||
 |
 |
 |
 |
 |
 |
 |
|
|
|
|
|
|||||||
 |
|
|||||||
Form Handler (FormMail)
FormMail is a universal WWW form to E-mail gateway (written in Cold Fusion Script). There is only one required form input tag which must be specified in order for this script to work with your existing forms. Other hidden configuration fields can also be used to enhance the operation of FormMail on your site.
Form Configuration
The action of your form needs to point towards the script at <http://www.american.edu/technology/formmail/formmail.cfm>, and the method must be POST in capital letters. FormMail offers ways to code your form to tailor the resulting HTML page or to have a redirect after the 'SUBMIT' button is clicked. Below is a list of form fields you can use and how to implement them.
|
Required Form Fields |
|
|
Field:
|
emailto |
|
Description:
|
This form field allows you to specify to whom you wish for your form results to be mailed. Most likely you will want to configure this option as a hidden form field with a value equal to that of your e-mail address. |
|
Syntax:
|
<input type=hidden name="emailto" value="userid@american.edu"> |
|
|
|
|
Field:
|
emailfrom |
|
Description:
|
This form field will allow the user to specify their return e-mail address. If you want to be able to return e-mail to your user, I strongly suggest that you include this form field and allow them to fill it in. This will be put into the From: field of the message you receive.. |
|
Syntax:
|
<input type=text name="emailfrom"> |
|
|
|
|
Optional Form Fields |
|
| Field: | subject |
| Description: | The subject field will allow you to specify the subject that you wish to appear in the e-mail that is sent to you after this form has been filled out. |
| Syntax: | If you wish to
choose what the subject is: <input type=hidden name="subject" value="Your Subject"> To allow the
user to choose a subject: |
|
|
|
| Field: | realname |
| Description: | The realname form field will allow the user to input their real name. This field is useful for identification purposes and will also be put into the From: line of your message header. |
| Syntax: | <input type=text name="realname"> |
|
|
|
| Field: | redirect |
| Description: | If you wish to redirect the user to a different URL, rather than having them see the default response to the fill-out form, you can use this hidden variable to send them to a pre-made HTML page. |
| Syntax: | To choose the
URL they will end up at: <input type=hidden name="redirect" value="http://your.host.com/to/file.html"> To allow them
to specify a URL they wish to travel to once the form is filled
out: |
|
|
|
| Field: | title |
| Description: | This form field allows you to specify the title and header that will appear on the resulting page if you do not specify a redirect URL. |
| Syntax: | If you wanted a title of 'Feedback Form Results':
<input type=hidden name="title" value="Feedback Form Results"> |
|
|
|
| Field: | return_url |
| Description: | This field allows you to specify a URL that will appear, as return_link_title, on the following report page. This field will not be used if you have the redirect field set, but it is useful if you allow the user to receive the report on the following page, but want to offer them a way to get back to your main page. |
| Syntax: | <input type=hidden name="return_url" value="http://www.american.edu/guidelines "> |
|
|
|
| Field: | return_title |
| Description: |
This is the title that will be used to link the user back to the page you specify with return_url. The two fields will be shown on the resulting form page as: |
| Syntax: | <input type=hidden name="return_title" value="American University Web Guidelines"> |
|
|
|
| Field: | bgcolor |
| Description: |
This form field allow you to specify a bgcolor for the form results page in much the way you specify a background image. This field should not be set if the redirect field is. |
| Syntax: | For a background
color of White:
<input type=hidden name="bgcolor" value="#FFFFFF"> |
|
|
|
| Field: | text_color |
| Description: |
This field works in the same way as bgcolor, except that it will change the color of your text. |
| Syntax: | For a text color of Black:
<input type=hidden name="text_color" value="#000000"> |
|
|
|
| Field: | text_font |
| Description: | This form field allow you to specify a font for the form results page. This field should not be set if the redirect field is used. |
| Syntax: | For a font of
Arial:
<input type=hidden name="text_font" value="Arial, Helvetica, sans-serif"> |
|
|
|
| Field: | text_size |
| Description: | This form field allow you to specify a font size for the form results page. This field should not be set if the redirect field is used. |
| Syntax: | For a font of
2:
<input type=hidden name="text_size" value="2"> |
|
|
|
| Field: | link_color |
| Description: | Changes the color of links on the resulting page. Works in the same way as text_color. Should not be defined if redirect is. |
| Syntax: | For a link color
of Red:
<input type=hidden name="link_color" value="#FF0000"> |
|
|
|
| Field: | vlink_color |
| Description: | Changes the color of visited links on the resulting page. Works exactly the same as link_color. Should not be set if redirect is. |
| Syntax: | For a visited
link color of Blue:
<input type=hidden name="vlink_color" value="#0000FF"> |
|
|
|
| Field: | alink_color |
| Description: | Changes the color of active links on the resulting page. Works exactly the same as link_color. Should not be set if redirect is. |
| Syntax: | For a active
link color of Blue:
<input type=hidden name="alink_color" value="#0000FF"> |
 |
ALL RIGHTS RESERVED. All trademarks mentioned herein belong to their respective owners. | |
 |
|
Maintained by:
webops@american.edu
Last Update: November 17, 2006