Welcome to EZ Form Mailer Version 1.0 by 3rd Coast Technologies, LLC

	Copyright 1997, 3rd Coast Technologies, LLC

		http://www.3rdcoasttechnologies.com
		support@3rdcoasttechnologies.com

	This CGI script takes the data entered in an HTML form 
	and sends it via e-mail to the specified location.

	EZ Form Mailer is available for anyone to use or modify for no charge.
	All we ask is that you leave this copyright notice in the script
	and readme.txt file.  If someone asks where you got the script, 
	refer them to 3rd Coast Technologies.

	Selling or distributing this program without prior written approval
	is forbidden.  

This readme file will guide you thru the steps required to configure and install 
EZ Form Mailer on your web site.  

Table of Contents
------------------------

	Section 1		How to configure the ezformml.cgi script.
	Section 2		How to set up your HTML Form to work with EZ Form Mailer.
	Section 3		How to install ezformml.cgi on your server.

Section 1 - How to configure the ezformml.cgi script
---------------------------------------------------------------------

1.	Open ezformml.cgi in Notepad or another editor.	
	(We recommend Programmers File Editor which is available for free download
	at http://www.cnet.com)

	If you are using Notepad or another word processing program, be sure to save the
	file as TEXT ONLY when you are done.   	

2.	The first line of the script, as shown below, points to the location of the perl interpreter. 
	If you are not sure this is correct, check with your webmaster or Internet Service Provider (ISP).
	Enter the correct path preceeded by '#!' in the first line of the script.  	   
	
		   #!/usr/local/bin/perl

3.	Determine the location of the sendmail program on your server.  If you are not sure where it is, 
	check with your webmaster or Internet Service Provider (ISP). Enter the correct path in the 
	$SENDMAIL variable as shown below.
 
		$SENDMAIL = '/usr/lib/sendmail';

4.	Enter the URL of the web site that will be using EZ Form Mailer in @AUTHURLS variable.
	Be sure and enter all variations of the name.

		 @AUTHURLS = ('www.yourcompany.com','yourcompany.com');

5. 	Enter values for the following variables or optionally their values can be entered 
	with hidden fieds in the HTML Form.

	a.  Enter the email address where the form data will be sent.

		$TO = 'you@yourcompany.com';

	b.  Enter the text that will be used for the subject of the email.

		$SUBJECT  = 'Form Data';

	c.  The full URL of the page to be displayed to the user 
      	     after they submit the form.

		$REDIRECT = 'http://www.yourname.com/confirm.htm';

	d.  Define the sort type for the form output.
         	     Options are 'alphabetical', 'field', or 'none'.

		$SORT_TYPE = 'field';

	e.  If the $SORT_TYPE is 'field', enter the field names in the desired sequence.

		@SORT_FIELDS = ('Field 1', 'Field 2', 'Field 3', 'Field 4', 'Field 5');

	When changing any of these values, be sure to include the single
	quote marks around the values and the semi colon at the end of 
	each statement.

6.	You are done making changes to the ezformml.cgi script. 
	Remember to save the file as TEXT Only!


Section 2 - How to set up your HTML Form to work with EZ Form Mailer
--------------------------------------------------------------------------------------------------

1.	Set the action= in the FORM HTML tag to point to ezformml.cgi as shown below.
	 
		<form action="../cgi-bin/ezformml.cgi" method="POST"
		name="EZFormMailer">

2.	The following form fields are required.  They should be text fields so that the
	user can enter them. The 'name=' values must be entered exactly as shown. 
	The 'size=' value can change,  depending on the design of your form.

	This is where the user enters their email address	
		<input type="text" size="35"  name="email"> 

	This is where the user enters their name
		<input type="text" size="35"  name="Name"> 

3.	The following optional fields can be either text fields for the user to enter or
	hidden fields that the user cannot see.  All fields entered through the form in this
	way will override the values set in the exformml.cgi script in step 5 above.

	a.  Enter the email address where the form data will be sent.

		<input type="text" size="35"  name="to_email">
	        OR
		<input type="hidden" name="to_email" value="you@yourcompany.com">

	b.  Enter the text that will be used for the subject of the email.

		<input type="text" size="35"  name="subject">
	        OR
		<input type="hidden" name="subject" value="Form Data">

	c.  The full URL of the page to be displayed to the user 
      	     after they submit the form.

		Text Not Recommended
	        OR
		<input type="hidden" name="redirect" value="http://www.yourname.com/confirm.htm">
	
	d.  Define the sort type for the form output.
         	     Options are 'alphabetical', 'field', or 'none'.

		Text Not Recommended
	        OR
		<input type="hidden" name="sort_type" value="field">
	

	e.  If the $SORT_TYPE is 'field', enter the field names in the desired sequence.

		Text Not Recommended
	        OR
		<input type="hidden" name="sort_fields" value="Field1,Field2,Field3,Field4,Field5">

4.	Copy (FTP) your completed HTML Form to your web server.


Section 3 - How to install ezformml.cgi on your server
------------------------------------------------------------------------

1. 	Copy (FTP) ezformml.cgi into your cgi-bin directory.
	Contact your webmaster or Internet Service Provider if you do not have
	access to the cgi-bin directory.

2.	Change the mode of file ezformml.cgi.
   	It should be made executable and readable by world.
	On the command line enter:   chmod 0755 ezformml.cgi

	If you do not have access to the command line on your server,  you may 
	be able to enter the chmod command through your FTP program.
	Cute FTP (Shareware available at www.cnet.com) is one FTP program
	that allows you to do this. 

3.	Thats it!  You can now process data from your HTML Forms and
	e-mail it yourself or any other valid email address.


____________________________________________________________________________