#####################################################################################
##                                                                                 ##
##          THANK YOU TO LYNN L. FOR UPDATING THIS README FILE!!                   ##
##                                                                                 ##
##  FILE: readme.txt                                                               ##
##                                                                                 ##
##  BizMailForm                                         Version 1.5                ##
##  © Copyright 2000-2002 Seth Michael Knorr            mail@sethknorr.com         ##
##                                                                                 ##
##                     http://www.bizmailform.com/                                 ##
##      Please contact me with any bugs found, or any bug fixes.                   ##
##                                                                                 ##
#####################################################################################
##                                                                                 ##
##  There is no email support provided for this script,                            ##
##  the only support can be found at                                               ##
##  our web site: http://www.bizmailform.com/                                      ##
##                                                                                 ##
##                                                                                 ##
##                                                                                 ##
##  ANY PERSON(S) MAY USE AND MODIFY THESE SCRIPT(S)                               ##
##  FREE OF CHARGE FOR EITHER BUSINESS                                             ##
##  OR PERSONAL, HOWEVER AT ALL TIMES HEADERS                                      ##
##  AND COPYRIGHT MUST ALWAYS REMAIN IN TACT.                                      ##
##                                                                                 ##
##  REDISTRIBUTION FOR PROFIT IS PROHIBITED                                        ## 
##  WITH OUT THE CONSENT OF SETH KNORR.                                            ##
##                                                                                 ##
##  By using this code you agree to indemnify Seth M. Knorr                        ##
##  from any liability that might arise from its use.                              ##  
##                                                                                 ##
##                                                                                 ##
##  More business building system can be found at:                                 ##
##  http://www.freedomtoolbox.com/                                                 ##
##                                                                                 ##
#####################################################################################
##                                                                                 ##
##  This script is FREE, however if you use the script and                         ##
##  find it useful, I would appreciate you rating it.                              ##
##                                                                                 ##
##  TO RATE IT SIMPLY DOUBLE CLICK OPEN THE rateit.html FILE.                      ##
##                                                                                 ##
#####################################################################################


                           ===========================
                                     S E T U P 
                           ===========================          

TABLE OF CONTENTS:

(1) CONFIGURING THE FILES

......(1A) bizmail.cgi settings
..........(1A-I) Editing plainbizmail.mes
..........(1A-II) Editing htmlbizmail.mes
..........(1A-III) Personalizing followup messages
......(1B) Creating your forms html page or configuring the bizmail.html Template File
......(1C) success.html settings

(2) UPLOADING FILES & SETTING PERMISSIONS
(includes reference list of CHMOD permission equivalents)                                     
==========================================================

                           ===========================
                           (1)  CONFIGURATION SETTINGS
                           ===========================


The only files you need to edit are 
bizmail.cgi, plainbizmail.mes, htmlbizmail.mes, bizmail.html and success.html.

bizmail.dat and subject.mes are blank files that do not need to be edited.

                           ===========================
		(1A) Set the variable values in bizmail.cgi as follows. 
                           ===========================

Firstly make sure the path to perl is correct. 
(THIS IS LOCATED ON THE VERY FIRST LINE OF THE bizmail.cgi script.)
By default it is set to:   #!/usr/bin/perl

*** You have the option for added privacy and security to set the variables 
    for the $sendto and $cc_to emails In the actual bizmail.cgi.

Biz Mail Form lets your form data be sent to email address's in the actual script, 
preventing un-authorized person(s) from using your script to post their own forms. 
(such as spamers) 

This also provides the script user with added privacy, by preventing visitors from 
seeing your email address.

(Note: That you can specify the send to and cc to emails in the form if you would 
like but is optional. This is explained below, with the setup of the bizmail.html page.)
------------------------------
$delete_dups

NEW FUNCTION! For people generating leads! Using the $delete_dups variable you can
specify if you want to delete all duplicate leads posted on the form and data sent
to the data file. If $delete_dups is set to 1 all dups will be deleted.              
To leave duplicate posts set $delete_dups to 2. (DEFAULT - MOST COMMON CHOICE        

Example: if you DO NOT want to delete duplicate posts (DEFAULT & MOST COMMON):
$delete_dups = "2";

OR - To delete all duplicates:
$delete_dups = "1";

NOTE: A duplicate is determined by the email field.

------------------------------
$useLib

$useLib defines the method of sending the email auto response and email form info.  

Example: To send mail via SENDMAIL (Most Common):
$useLib = "sendmail";

OR - To send mail via SMTP server:
$useLib = "smtp";
------------------------------
$mailprog 

Used if you're using SENDMAIL.
Enter the path to send mail on your server.
Example: 
$mailprog = "/usr/lib/sendmail";
------------------------------
$smtp

This is only used if you're not using SENDMAIL.
Enter the path to send mail on your server.
Example:       
$smtp = "smtp.host.com";  
------------------------------
$cfg_email_onform

**NEW ADDED SECURITY FEATURE**
The variable $cfg_email_onform if set to 1 alows you to specify the sendto and 
CC to email address's on your html form. If set to 2 you may ONLY specify the sendto 
and CC To in bizmail.cgi, with the $sendto and $cc_to variables in the bizmail.cgi file

If you want to be able to specify the send to and cc to email address's
in the html form:
Example:
$cfg_email_onform = "1";

If you want the ONLY send to and cc to email address's 
to be used are the ones specified in the bizmail.cgi script:
Example:
$cfg_email_onform = "1";
------------------------------
$sendto
Enter the email address you want to receive your form data to. This is also the reply 
email address, if you use send reply. MAKE sure that when entering this variable to 
remember the \ before the @ sign.

Example: if you want it to go to mail@yourdomain.com:
$sendto = "mail\@yourdomain.com";

NOTE: if using the form field:
<input name="send_to" type=hidden> 
the above variable is not used.
------------------------------
$cc_to 

Optional variable used to carbon copy form data to a second email address. If you do 
not want to use this feature, make sure you leave the value blank. ALSO make sure 
that when entering this variable to remember the \ before the @ sign. 

Example: if you want it to go to mail2@yourdomain.com:

$cc_to = "mail2\@yourdomain.com";
OR
Example: if you don't want to carbon copy the data:
$cc_to = "";

NOTE: if using the form field: 
<input name="cc_to" type=hidden> 
the above variable is not used.

======================================
OPTIONAL FIELDS THAT CAN BE CONFIGURED IN BIZMAIL.CGI
======================================
$send_attachement

$send_attachement specifys if you want to send an attachment with the auto response.

to send attachment with autoresponse,
Example:
$send_attachement = "1"; 

To not send attachment with autoresponse,   (DEFAULT)
$send_attachement = "2";

IF USING A FILE ATTACHMENT YOU MUST CONFIGURE THE BELOW THREE VARIABLES BELOW

$attachment_nm = "file.txt";  ## file name of attachement ##

$att_path = "/path/to/$attachment_nm";  ## Path to file attachement##

$att_format = ".txt";  ## File attachement extension, or file type (basicaly .exstension ) ##

--------------------------------------
$setokurl

to use @okurls to verify the url the form is submitted by set $setokurl to 1 and 
set $setokurl to 0 if you do not want to use @okurls to verfiy form submission URL.
Example:
$setokurl = "0"; # WOULD NOT REQUIRE URL VALIDATION #
$setokurl = "1"; # WOULD REQUIRE URL VALIDATION #

This is a good idea if you are using hidden form fields for the send_to and cc_to.
This prevents spamers from using your form on there web site.
Only web address's entered below will be allowed to process the form 
if $setokurl is set to 1.


@okurls = ("http://www.yourdomain.com", "http://yourdomain.com", "34.344.344.344");

-------------------------------

$setokemails
$setokemails VARIABLE IS ONLY USEFULL IF YOU USE 
FORM FIELDS <input name="send_to" type="hidden"> and/or
<input name="cc_to" type="hidden">
in your submission form.


To use @okemails to verify the emails the form is submitted by set $setokemails to 1 
or set $setokemails to 0 if you do not want to use @okemails.
Example:
$setokemails = "0"; # WOULD NOT REQUIRE EMAIL VALIDATION #
$setokemails = "1"; # WOULD REQUIRE EMAIL VALIDATION #

This is a good idea if you are using hidden form fields for the send_to and cc_to. 
This prevents spamers from using your form on their web site. Only email address's 
entered below will be allowed to receive the form data if $setokemails is set to 1.

        @okemails = ("mail\@yourdomain.com", "mail2\@yourdomain.com");



                           ===========================
		     (1A-I) Edit plainbizmail.mes as follows.
                           ===========================

This is the reply that your prospect will receive automatically after they complete 
the form IF they choose plain text as their format for receiving messages.

Edit plainbizmail.mes, and replace the current text in the file with the message you 
want to be sent as the plain text reply message. No HTML tags will work in this file.

You can personalize this message. 
You can read more on personalization fields below 
in the personalization reame section (1A-III).


                           ===========================
		      (1A-II) Edit htmlbizmail.mes as follows
                           ===========================
This is the reply that your prospect will receive automatically after they complete 
the form IF they choose html as their format for receiving messages.

Edit htmlbizmail.mes, and replace the current text in the file with the HTML message 
you want to be sent as a reply message.

You can personalize this message. 
Read below about personalizing this message.

                            ===========================
(1A-III) P E R S O N A L I Z A T I O N   O F    Y O U R    A U T O - R E S P O N S E 
                            ===========================

You can personalize the automated response or autoresponder message your prospect 
sees. You can personalize the html and plain text auto reply message as well as the auto 
reply subject. For every field used in the form there is a joined personalization field.

What ever the field name is, the personalization tags used in messages is {FIELD_NAME}
These tags are case sensitive.

Example: <input type="text" name="firstname"> 
{firstname}   - would be the personalization tag for this field
------------------------------------------------
{FIRSTNAME}   - IN THIS EXAMPLE WOULD NOT WORK
------------------------------------------------
(If Joe is entered in this field)

{firstname}, thanks for filling out the form.

WOULD READ:
Joe, thanks for filling out the form.

ANOTHER EXAMPLE:
<input type="text" name="First_Name"> Personalization field would = {First_Name}
<input type="text" name="email"> Personalization field would = {email}
<input type="text" name="PHONE"> Personalization field would = {PHONE}
ETC....


                           ===========================
                      (1B) Creating your forms html page 
                           or configuring the bizmail.html Template File
	     (This is the page your visitors will see and fill out on your site)
                           ===========================

<!----- START FORM WITH THE BELOW LINE, THIS CALLS THE SCRIPT IN YOUR CGI-BIN ---->

<form method="post" action="/cgi-bin/bizmail.cgi">
<!----- OR ----->
<form method="post" action="http://www.yourdomain.com/cgi-bin/bizmail.cgi">
<!--- Replace: http://www.yourdomain.com/cgi-bin/bizmail.cgi with the url to bizmail.cgi --->


<!--- "subject" IS THE SUBJECT LINE YOU WILL SEE WHEN YOU RECEIVE THE FORM DATA ON YOUR EMAIL---->

<input type="hidden" name="subject" value="BizMailForm FORM DATA">


<!--- "success_page" IS WEB SITE THE PERSON WILL BE SENT TO AFTER SUCCESSFULLY COMPLETING THE FORM --->
<!--- LEAVE FIELD BLANK, OR LEAVE FIELD OUT OF FORM TO USE THE bizmail.cgi SUCCESS PAGE. --->

<input type="hidden" name="success_page" value="http://www.yoursuccesspage.com/success.html">


<!-----  "required" ARE ALL THE FIELDS YOU WANT TO FORCE TO BE FILLED IN.  ---->

<input type="hidden" name="required" value="email,firstname,nextrequiredfield,etc">


<!----- SET "sendreply" TO 1 IF YOU WANT TO SEND PROSPECT AUTO RESPONSE---->
<!----- SET "sendreply" TO 0 IF YOU DON'T WANT TO SEND PROSPECT AUTO RESPONSE---->
<!----- IF "sendreply" IS SET TO 1 THE "email" field must be included in your form---->

<input type="hidden" name="sendreply" value="1"> 


<!----- THE "email" FIELD IS A REQUIRED FIELD IF YOU ARE USING SENDREPLY --->
<!----- THIS IS WHERE THE AUTORESPONSE MESSAGE WILL GO ---->
<input type="text" name="email" value=""> 


<!-----  "reply_subject" IS THE AUTO RESPONSE MESSAGE SUBJECT LINE---->
<!-----  IF YOU SET THE ABOVE VARIABLE "sendreply" TO 0 THIS 
         FIELD IS OF NO CONSIQUENCE TO YOUR FORM                  ---->

<input type="hidden" name="reply_subject" value="RE: Your recent inquiry.">

<!-- the subject can now be personalized with form data. For example if you wanted 
the subject to contain the persons first name, and you have the form field 
<input name="firstname" type=text> to gather the persons first name. then you would 
personalize the subject line with {firstname}. example:
<input type="hidden" name="reply_subject" value="RE: {firstname} Your recent inquiry."> 

You can read more on personalization fields above in the 
personalization reame section (1A-III).                              ---->

<!---- "message_format" specifys the format the auto response will be sent in. ---->

<!--- sends message in HTML format and sends the htmlbizmail.mes message. --->
<input type="hidden" name="message_format" value="html"> 


<!--- sends message in Plain Text format and sends the plainbizmail.mes message. --->
<input type="hidden" name="message_format" value="plain"> 

<!--- OR YOU CAN LET THE PERSON FILLING OUT THE FORM CHOOSE THE 
      MESSAGE FORMAT BY USING CODE BELOW:                        ----->

<select name="message_format">
<option value="plain">Plain Text </option>
<option value="html">HTML </option>
 </select>


<!--- "data_format" is the text separator of the form fields. Example if , is entered 
the data will be sent to the file as:
email,firstname,lastname,phone,etc  - If you want tab delimited format simply put 
your cursor in between the "" and hit the tab key. this will print data in the 
format: email	firstname	lastname	phone	etc
You can choose what ever character you want. 
example of other posiblities  | /  . ~ etc...                            ---->

<input type="hidden" name="data_format" value=",">  <!--- OR ---->
<input type="hidden" name="data_format" value="|">  <!--- OR ----> 
<input type="hidden" name="data_format" value="~">  <!--- OR ----> 
<input type="hidden" name="data_format" value="	">  <!--- ETC.... (USE ONLY ONE HOWEVER) ---> 



<!-- "text_qualifier" is a data format option. Set to on 1 if you want there to be 
a " text qaulifier. Example (If you chose the , data_format and set text_qualifier to 1) 
data would appear as: "email","firstname","lastname","phone","etc"              ---->
 
<input type="hidden" name="text_qualifier" value="1"> 


<!--- THE BELOW FIELDS ARE NOT NECESSARY, BUT ADD MORE VERSATILITY --->

<!-----  "send_to" if used over-writes the $send_to variable which is configured in 
bizmail.cgi. What this means in laymen's terms if you use this form field, any 
variable entered for $send_to in the bizmail.cgi is ignored. The chosen function is 
Where form submissions will be sent, and used as the reply address in the 
auto response to the person filling out the form.  ---->

<input name="send_to" type=hidden value="you@yourdomain.com">


<!-----  "cc_to" if used over rights the $cc_to variable which is configured in 
bizmail.cgi. What this means in laments terms if you use this form field, any variable 
entered for $cc_to in the bizmail.cgi is ignored. The chosen function is used if you 
want to carbon copy form information to a second email address.---->

<input type="hidden" name="cc_to" value="you2@yourdomain.com">


<!-----  "outputfile" is another optional field and only needs to be in the form if 
you don't want all fields to be added to the data file and only the fields you 
specify. If using this option, enter all the fields you want to be added to the
file and separate them with a coma. 
Example:  value="email,firstname,lastname,phone,date,ipaddress"   ----->

<!--- NOTE: To add the date field simply enter: date,
            To add the ip address field enter: ipaddress,      
AS SEEN IN EXAMPLE BELOW    ----->

<input type="hidden" name="outputfile" value="email,firstname,date,ipaddress,etc">



<!-----  "datafile" is another optional field and only needs to be in the form if 
you don't want your data to be added to the bizmail.dat file. If you want your data 
sent to another file simply enter the file name ex: to write to file datafile.dat 
enter value="datafile.dat" In this scenario you would need to create a blank file 
named datafile.dat and upload to the same directory as bizmail.dat  ----->

<input type="hidden" name="datafile" value="bizmail.dat"> 


THEN SIMPLY ADD OTHER FIELDS THAT YOU WANT THE PROSPECT TO FILL OUT, AS WELL AS ADD 
A SUBMIT BUTTON AND YOU ARE ALL SET. YOU CAN ALSO USE THE bizmail.html as an example 
form to use to submit requests. 


                           ===========================
			(1C)  CONFIGURING THE success.html FILE
			This is the confirmation page that will appear 
			in the prospects browser after they press 
			the submit button successfully.
                           ===========================

If using the success.html file, simply edit the two web address that appear in the 
script. These web address's are where the person filling out the form will be sent 
after the success.html page.

If using a success page you must enter the full URL in the hidden "success_page" field.

Example: to send to: http://www.yoursuccesspage.com/success.html

<input type="hidden" name="success_page" value="http://www.yourdomain.com/success.html">


If you choose not to use your own success page, all traffic will be sent to the 
default success page at bizmail.cgi after successfully filling out the form. If you 
use your own HTML success page, make sure to upload it to an HTML readable directory.

                           ===========================
                       (2)  UPLOAD FILES & SET PERMISSIONS
                           ===========================

Upload bizmail.cgi, bizmail.dat, subject.mes, plainbizmail.mes, and htmlbizmail.mes 
to your cgi-bin directory

Chmod bizmail.dat, subject.mes, plainbizmail.mes and htmlbizmail.mes to 777.
Chmod bizmail.cgi to 755.

Also upload the MIME folder which includes the Lite.pm script to your cgi-bin 
directory. Make sure the MIME directory is worded with all upper case letters. 
Chmod the MIME directory to 777.
Chmod Lite.pm to 777 
This script should be located at path: /cgi-bin/MIME/Lite.pm


****  UPLOADING AND CONFIGURING HTML PAGES  *******
	(These html pages do NOT go in your CGI directory)
After configuring your selected form page and success.html, as directed above, 
upload to your HTML directory and chmod to 644.

*** DO NOT UPLOAD YOUR HTML FORM PAGE OR HTML SUCCESS PAGE TO YOUR CGI-BIN. ***

		..............................................
		FOR YOUR REFERENCE:
		CHMOD 777=
			Owner: read, write, execute. 
			Group: read write, execute. 
			World: read, write, execute

		CHMOD 755=
			Owner: read, write, execute
			Group: read, --- , execute
			World: read, --- , execute

		CHMOD 644=
			Owner: read, write , ---
			Group: read, --- , ---
			World: read, --- , ---
		..............................................


FINAL NOTE: IF SETTING THE PERMISSION ABOVE DOES NOT WORK YOU CAN ALWAYS
CHMOD (SET PERMISIONS) OF ALL FILES TO 777.
ALSO - FOR WINDOWS USERS. YOU WILL NOT BE ABLE TO SET PERMISIONS IN YOUR FTP 
PROGRAM. BY DEAFAULT MOST WINDOWS SERVER ARE SET TO CHMOD ALL FILES TO 777
UPON UPLOAD. IF THIS IS NOT THE CASE YOU WILL HAVE TO CHECK WITH YOUR SERVER
ADMINISTRATOR TO MAKE SURE THAT THIS IS THE CASE. IF ALL FILES ARE CHMODED
TO 666 or 755 THIS SCRIPT WILL NOT WORK!!! IF YOU ARE ON A WINDOWS SYSTEM 
AND THIS SCRIPT IS NOT WORKING YOU WILL WANT TO THINK ABOUT GETTING A 
UNIX/LINUX HOSTING ACCOUNT.

                           ===========================
                                       D O N E ! ! ! 
                           ===========================

                            THAT'S IT YOUR DONE, 
                            IT IS VERY SIMPLE TO SET UP. 
                            FOR HELP INSTALLING GO TO: 
                            http://www.bizmailform.com/

                           ===========================

                             This script is FREE, however 
                             if you use the script and 
                             find it useful, I would 
                             appreciate you rating it.

                           TO RATE IT SIMPLY DOUBLE 
                           CLICK OPEN THE rateit.html FILE.

                           =========================
		  FOR ADDITIONAL BUSINESS BUILDING TOOLS VISIT:             
                          http://www.freedomtoolbox.com/




###############################################
#   sssss     mmm      mm   kk    kkk         #
#  ss   sss   mmmm     mm   kk   kk           #
# ss     ss   mm mm   m m   kk  k             #
# ss          mm  mm m  m   kk k              #
#  ss         mm   mm   m   kkkk              #
#    sss      mm        m   kk  k             #
#     ssss    mm        m   kk   k            #
# s      ss   mm        m   kk    k           #
# ss    ss    mm        m   kk     kk         #
#  ssssSETH   mm        m   kk      kkKNORR   #
###############################################