The following fields can be defined for formmail.pl; only the recipient field is required. However to customise both the emails and the returned page, you may want to look at some of the other options.
form tag (required!)
You need to have a form on your page for formmail.pl to work. The method of the form can be either GET or POST (we recommend POST) and the action should be:
<form action="http://cgi.atari.org/formmail.pl" method="POST">
recipient (required)
This field specifies the destination e-mail address for the form contents. Example:
<INPUT TYPE="hidden" NAME="recipient" VALUE="address@atari.org">
subject
This field specifies the Subject line of the e-mail message you receive. If not given, the default Subject is WWW Form Submission. Example:
<INPUT TYPE="hidden" NAME="subject" VALUE="Some Atari Subject">
You can also allow the user to specify the Subject by including a text field on your form:
<INPUT TYPE="text" NAME="subject">
email
This field specifies the return e-mail address of the user submitting the form. If supplied, this should be a field filled in by the user. The e-mail will be generated so that your mailer's reply function should go to this address; if not supplied the default is nobody@atari.org. Example:
<INPUT TYPE="text" NAME="email">
realname
This field specifies the real name of the user submitting the form. If supplied, this should be a field filled in by the user. The e-mail will be generated with this name in the headers. Example:
<INPUT TYPE="text" NAME="realname">
redirect
This field specifies the URL to which the user should be automatically redirected after successful delivery of the form. If this is not specified, a default response will be generated by the script. Example:
<INPUT TYPE="hidden" NAME="redirect" VALUE="http://atari.org/whatever.html">
required
This field allows you to specify that certain fields in the form are "required"; that is, that they may not be empty when the form is submitted. If any of the specified fields are empty, the user will receive a warning, and the form will not be submitted. Example:
<INPUT TYPE="hidden" NAME="required" VALUE="email,subject">
env_report
This field specifies a list of environment variables that should be submitted along with the form contents. This is useful for recording, for example, the IP address of the user submitting the form. Useful environment variables to record include: REMOTE_ADDR - The IP address of the users host. HTTP_USER_AGENT - The name and version of the users browser. Example:
<INPUT TYPE="hidden" NAME="env_report" VALUE="REMOTE_HOST,HTTP_USER_AGENT">
sort
This field specifies how the fields submitted from the form should be sorted in the outgoing e-mail message. By default, the fields are not in any particular sort order (results are dependent on the user's browser). You may specify "alphabetic" for straight alphabetic sorting or you may specify the exact order with "order:". Examples:
<INPUT TYPE="hidden" NAME="sort" VALUE="alphabetic">
<INPUT TYPE="hidden" NAME="sort" VALUE="order:name,email,phone">
print_config
This field specifies that the formmail.pl control fields, normally removed from the body of the outgoing message, be included for completeness. Example:
<INPUT TYPE="hidden" NAME="print_config" VALUE="email,subject">
title
This field specifies the title for the default response page that is generated by the script in absence of a redirect field. The default is "Thank You". Example:
<INPUT TYPE="hidden" NAME="title" VALUE="Form Results">
return_link_url
This field specifies a URL that will appear on the default response page that is generated by the script in absence of a redirect field. This URL can be used to allow users to return to, for example, your home page. Example:
<INPUT TYPE="hidden" NAME="return_link_url" VALUE="http://atari.org/">
return_link_title
This field specifies the text that will be used inside the link generated when return_link_url is specified. Example:
<INPUT TYPE="hidden" NAME="return_link_title" VALUE="Return to Home Page">
background
This field specifies the URL of a background image that will be used on the default response page that is generated by the script in absence of a redirect field. Example:
<INPUT TYPE="hidden" NAME="background" VALUE="http://domain.com/img/bkgr.gif">
bgcolor
This field specifies the background color that will be used on the default response page that is generated by the script in absence of a redirect field. Example (pure white):
<INPUT TYPE="hidden" NAME="bgcolor" VALUE="#FFFFFF">
text_color
This field specifies the text color that will be used on the default response page that is generated by the script in absence of a redirect field. Example (pure black):
<INPUT TYPE="hidden" NAME="text_color" VALUE="#000000">
link_color
This field specifies the unvisited link color that will be used on the default response page that is generated by the script in absence of a redirect field. Example (pure red):
<INPUT TYPE="hidden" NAME="link_color" VALUE="#FF0000">
vlink_color
This field specifies the visited link color that will be used on the default response page that is generated by the script in absence of a redirect field. Example (pure blue):
<INPUT TYPE="hidden" NAME="vlink_color" VALUE="#0000FF">
alink_color
This field specifies the active link color that will be used on the default response page that is generated by the script in absence of a redirect field. Example (pure green):
<INPUT TYPE="hidden" NAME="alink_color" VALUE="#00FF00">