Formmail is one way you can add a web based form to your site that your visitors can fill out to send you information. Formmail's job is to take the information entered by your visitors and send it to you in an email message. In addition, it is also capable of generating its own confirmation page that the user will see after they submit their information. If you are using a web authoring program to create your site, it's likely it already has support for creating forms. However, your form will need to know how to post to the script and contain at least one hidden field that tells the script where to email the information to. If you are not using a web authoring program, or your web authoring program does not support forms, you can learn more about how to create forms using HTML using a tutorial like the one found here. (If the NCSA tutorial looks like too much reading, jump down towards the end of their tutorial and take a look at their example forms.)
Using the formmail.cgi Script
To use the formmail.cgi script with a form you have created, you must modify your <FORM> tag to POST the results of the form to the formmail.cgi script as follows:
<FORM ACTION="/cgi-tools/formmail.cgi" METHOD="POST">
There is only one required field on your form, which is the recipient. In most cases, you'll want to make this a hidden field that specifies the email address that the form results will be emailed to:
<input type="hidden" name="recipient" value="email@example.com">
Replace firstname.lastname@example.org with the email address you the form results will be sent to.
Advanced formmail.cgi features
Our version of formmail.cgi has been modified to close security holes existing in the public domain version. In order to accomplish this, an "in between" screen is displayed that blocks the automated scripts that spammers use to send spam through formmail.cgi. You can remove this "in between" screen by adding one additional field to your form:
<input type="hidden" name="recipientfile" value="/home/username/recipientfile.txt">
The value of this field must be set to the full server path and filename of a file that contains the email addresses that should receive the form results.
In addition to this feature, all the standard formmail.cgi features are also supported.