Form to Email Messenger fem.cgi

Version: 0.21
Date: 2000-05-21
Author: Colin R. R. Johnson <cjohnson@candjsolutionsl.com>
Web Page: http://www.candjsolutions.com/download/index.shtml
Copyright: Colin R. R. Johnson, 2001. Released under the GPL.
Language: Perl 5
Requires: CGI module.

For changes from fem 0.1 see changelog-fem

Features:
* Ability to set your own field order in the email
* Ability to have the fields sorted alphabetically in the email
* Can send to one or more email addresses
* Blocks forms submitted from domains that are not specified.


Installation:
1: Put fem.cgi in your cgi directory.
2: Edit fem.cgi as follows:
   a) change the location of sendmail to reflect its location on your server
   b) modify @REFERERS to represent the domains from which you will be calling
      fem.cgi
   c) Optional: Change $EVIL_REFERER to a non zero value.
                This will send calls from an unauthorized domain to be sent
				back to the initiating page :-) 

Usage: <FORM action="fem.cgi" method="post">
(All field names are case sensitive)

Required field:

recipient      # email address(es) to send the form results to.
                 separate multiple email addresses with commas.
                 eg: cjohnson@candjsolutions.com, sales@candjsolutions.com

Optional fields:

required       # Comma separated list of required fields.
order          # Comma separated list of fields to be sent in the email.
                  The fields will be sent in the order listed in this field.
sort           # Any value other than zero, or blank will sort the fields
                  alphabetically in the email.
redirect       # web page to redirect the user to after the form has been
                  filled out with all of the required fields
redirect_error # *NEW* Page to direct the user to if they haven't filled in
                   all of the required fields

email          # It is a good idea to get the email address of the person
                 filling out the form. This field will be used to create
                 the From: header in the email.

narrative	   # If this is non-zero, then the fields will be output at the end
                 of the email in a consective order separated by spaces.


To-Do / In Progress:
* Ability to have the fields attached by means of a text file with
  a field separator that can be specified on the form.
* Ability to CC the form results by email to the person submitting the form.
* Ability to use a custom results page, specified by a hidden field,
  which will show the values submitted.