 
 
|
NMS FormMail
NMS FormMail
will parse the results of any web form and send them to the specified user.
This script has many formatting and operational options, most of which can
be specified through the form, meaning you don't need any programming knowledge
or multiple scripts for multiple forms. This also makes FormMail the perfect
system-wide solution for allowing form-based user feedback without the risks
of giving your hosts freedom of CGI access.
Installing FormMail
To install the formmail.pl
script and its README
file on your Virtual Server,
Telnet or SSH to your Virtual Server and untar the FormMail tar
file onto your Virtual Server:
This will install the two files, formmail.pl
and formmail.README.txt,
into your ~/www/cgi-bin directory.
Using FormMail
- 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, please see the README
document for a complete presentation of the supported fields.
For example, the HTML source for your form may look like this:
<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,username,phone">
Please Enter Your Name:<br>
<input name="realname" size="40">
<p>
Please Enter Your Email Address:<Br>
<input name="username" size="40">
<p>
Please Enter Your Phone Number:<Br>
<input name="phone" size="40">
<p>
. . . <input type="submit" value="Submit"> <input type="reset"
value="Reset">
</form>
- Set the referer* information such that
only your server will have privileges to use the formmail.pl script.
Near the top of the formmail.pl script you will find the following line:
@referers =
('yourdomain.com','YOUR.IP.ADDR.ESS');
Substitute your domain name and Virtual Server IP address for the values
YOUR-DOMAIN.NAME and
YOUR.IP.ADDR.ESS respectively.
- Indicate the path to perl:
#!/usr/bin/perl
-wT
- Indicate the path to sendmail:
/usr/sbin/sendmail
-oi -t
Tips
One way to modify the formmail.pl script
is have it "autorespond" to the client filling out the form. You can do
this by simply uncommenting out the call to "autorespond" located near the
top of the script. The autorespond function is placed at the end of the
file and can be modified to suit your needs.
*In the context of web servers, this is not
a misspelling of "referrer". While the meaning is the same, it
should be spelled "referer" when in use with web servers. |
|
