NMS FormMail

NMS FormMail is a CGI program designed to generate E-Mail based on the input from an HTML form.

Installation

To install the NMS FormMail on your Virtual Private Server, connect to your server via SSH or Telnet and run the following command:

% vinstall formmail

This command installs two files, FormMail.pl and README, into your ~/www/cgi-bin directory.

Usage

Create a form that you would like the contents mailed to some address. The form should include the following field (at the very least):

• recipient = specifies who mail is sent to

Other optional fields can also be used to enhance the operation of FormMail for you site, for example:

• subject = specify the subject included in e-mail sent back to you

• email = allow the user to specify a return e-mail address

• realname = allow the user to input their real name

• redirect = URL of page to redirect to instead of echoing form input

• required = list of field names that are required input (comma delimited)

Several other fields are supported. See the README file for a complete presentation of the supported fields.

The following is an example of how your form could be designed:

<form method="POST" action="/cgi-bin/formmail.pl">
  <input type="hidden" name="recipient" value="order@yourdomain.com">
  <input type="hidden" name="subject" value="Order Request">
  <input type="hidden" name="required" value="realname,email,phone">
  
  <h3>Please Enter Your Name:</h3>
  
  <input name="realname" size="40">
  
  <h3>Please Enter Your Email Address:</h3>
  
  <input name="email" size="40">
  
  <h3>Please Enter Your Phone Number:</h3>
  
  <input name="phone" size="40">
.
.
.
  <input type="submit" value="Submit">
  <input type="reset" value="Reset">
</form>