##################################################################################### ## ## ## THANK YOU TO LYNN L. FOR UPDATING THIS README FILE!! ## ## ## ## FILE: readme_V1_9.txt ## ## ## ## BizMailForm Version 1.9 ## ## © Copyright 2000-2003 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 bizmail.cgi ..........(1A-II) Editing plain.mes ..........(1A-III) Editing html.mes ..........(1A-IV) Personalizing followup messages ..........(1A-V) Editing error.html ......(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, plain.mes, html.mes, bizmail.html, success.html and (success.cgi -OPTIONAL-). bizmail.dat is a blank file that does not need to be edited. This is the data file where all form posts will be stored. =========================== (1A) Check bizmail.cgi Path to Perl. =========================== 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 =========================== (1A-I) Set the variable values in bizmail.cgi as follows. =========================== *** For added privacy and security the $sendto and $cc_to reply emails are set in the actual bizmail.cgi script. 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 with the number associated with the email address in the bizmail.cgi file. 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. (2 IS THE 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 "SMTP". Enter the path to send mail on your server. Example: $smtp = "smtp.host.com"; ------------------------------ $reply_from_name The $reply_from_name variable refers to the from name that will apear on auto response email and the form data email. Example: (IF YOUR NAME IS "John Doe") $reply_from_name = "John Doe"; ------------------------------ $sendto{""} Simply enter all the posible email address's you want to receive your form data to. The "sendto" selected will also be the reply email address, if you use send reply. MAKE sure that when entering this variable to remember the \ before the @ sign. Example Config: $sendto{"1"} = "mail1\@yourdomain.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)## $sendto{"2"} = "mail2\@yourdomain.com"; $sendto{"3"} = "mail3\@yourdomain.com"; $sendto{"4"} = "mail4\@yourdomain.com"; $sendto{"5"} = "mail5\@yourdomain.com"; Example: if you want to send your form data results to mail1@yourdomain.com: Then on your HTML form page you would insert the below 'field'with the value of 1 (as shown below): -OR- if you want to send your form data results to mail2@yourdomain.com: Then on your HTML form page you would insert the below 'field' with the value of 2 (as shown below): Etc.... ...GOING FURTHER If you have mutliple forms and you want to use multiple email address's you want to Send the form data results to simply add aditional variables as shown below. You could add more fields if you have more email address's you want to send data to. So for example if you have 10 the config should look something like the below: $sendto{"1"} = "mail1\@yourdomain.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)## $sendto{"2"} = "mail2\@yourdomain.com"; $sendto{"3"} = "mail3\@yourdomain.com"; $sendto{"4"} = "mail4\@yourdomain.com"; $sendto{"5"} = "mail5\@yourdomain.com"; $sendto{"6"} = "mail6\@yourdomain.com"; $sendto{"7"} = "mail7\@yourdomain.com"; $sendto{"8"} = "mail8\@yourdomain.com"; $sendto{"9"} = "mail9\@yourdomain.com"; $sendto{"10"} = "mail10\@yourdomain.com"; ------------------------------ $cc_to{""} This variable is configured and implemented almost exactly like the 'sendto'. Simply enter all the posible email address's you may want to receive a carbon copy email with the form data to. MAKE sure that when entering this variable to remember the \ before the @ sign. Example Config: $cc_to{"1"} = "ccto1\@yourdomain.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)## $cc_to{"2"} = "ccto2\@yourdomain.com"; $cc_to{"3"} = "ccto3\@yourdomain.com"; $cc_to{"4"} = "ccto4\@yourdomain.com"; $cc_to{"5"} = "ccto5\@yourdomain.com"; Example: if you want to carbon copy your form data results to ccto1@yourdomain.com: Then format the send to field as follows: -OR- if you want to carbon copy your form data results to ccto2@yourdomain.com: Then format the send to field as follows: Etc.... GOING FURTHER If you have mutliple forms and you want to use multiple email address's you want to Carbon Copy the form data results to simply add aditional variables as shown below. So for example if you have 10 the config should look something like the below: $cc_to{"1"} = "ccto1\@yourdomain.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)## $cc_to{"2"} = "ccto2\@yourdomain.com"; $cc_to{"3"} = "ccto3\@yourdomain.com"; $cc_to{"4"} = "ccto4\@yourdomain.com"; $cc_to{"5"} = "ccto5\@yourdomain.com"; $cc_to{"6"} = "ccto6\@yourdomain.com"; $cc_to{"7"} = "ccto7\@yourdomain.com"; $cc_to{"8"} = "ccto8\@yourdomain.com"; $cc_to{"9"} = "ccto9\@yourdomain.com"; $cc_to{"10"} = "ccto10\@yourdomain.com"; ------------------------------ $datafile{""} Simply enter all the posible datafiles you want to send form data to. Example Config: $datafile{"1"} = "bizmail.dat"; $datafile{"2"} = "secondfile.dat"; $datafile{"3"} = "etc.dat"; Example: if you want to use bizmail.dat as your data file: Then format the "datafile" field on the form as follows: -OR- if you want to use secondfile.dat as your data file: Then format the "datafile" field on the form as follows: Note, you can have as many datafile entries as you would like in bizmail.cgi ====================================== 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 set $send_attachement = "1"; To not send attachment with autoresponse set (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 # 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"); =========================== (1A-I) Edit plain.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 plain.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 html.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 html.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). =========================== (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 the messages are {FIELD_NAME} These tags are case sensitive. Example: {firstname} - would be the personalization tag for this field ------------------------------------------------ {FIRSTNAME} - IN THIS EXAMPLE WOULD NOT WORK ------------------------------------------------ (If Joe is entered in the field ) {firstname}, thanks for filling out the form. WOULD READ: Joe, thanks for filling out the form. ANOTHER EXAMPLE: Personalization field would = {First_Name} Personalization field would = {email} Personalization field would = {PHONE} ETC.... =========================== (1A-IV) Editing error.html =========================== The error.html page allows you to personalize all the error pages that Biz Mail Form has. You would simply enter regular html into this file and it will apear on the error page. Custom Fields contained in error.html <%TITLE%> the "%TITLE%" TAG is configured to the apropriate error page title. ALREADY FORMATED WITH END TITLE TAG! <%ERROR%> DO NOT EDIT OR DELETE THE <%ERROR%> TAG. THE <%ERROR%> TAG WILL OUTPUT THE ERROR MESSAGE FROM bizmail.cgi <%HIT_BROWSER_BACK_BUTTON%> The above tag prints the error message: Hit your browsers back button and resubmit the form. Simply delete this field if you want to replace it with your own custom error message. This page can be given the look and feel of your main web site, so it looks as if they have never left it. =========================== (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) ===========================
-OR- -OR- etc... 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 formv9.html as an example form to use to submit requests. =========================== (1C) CONFIGURING YOUR OWN SUCCESS PAGE. This is the confirmation page that will appear in the prospects browser after they press the submit button successfully. =========================== You can use a more advanced success page, with a seperate module built into Biz Mail Form. To use this module read the success_readme.txt which will walk you through setup of the success pages. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + If you are not implementing the above success page follow the below instructions. Note these + + Instructions are different since you are taking a different aproach. + +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ If you don't want anything to advanced simply create a html success page and upload to your server like a traditional html page. From there you would use the below tag to access it. =========================== (2) UPLOAD FILES & SET PERMISSIONS =========================== UPLOAD: bizmail.cgi, smtp.cgi, sendmail.cgi, error.cgi, bizmail.dat, error.html plain.mes, and html.mes **TO YOUR cgi-bin DIRECTORY** Chmod bizmail.dat & plain.mes and html.mes to 777. Chmod bizmail.cgi, smtp.cgi, sendmail.cgi, & error.cgi to 755. NOTE: If using the success module, and have read the success_README.txt. UPLOAD: success.cgi and success.html (FOUND IN THE "success cgi-bin" folder of the zip file) AND UPLOAD THEM TO YOUR cgi-bin as well. They should be located in the same directory as bizmail.cgi. Chmod success.cgi to 755. Chmod success.html to 644. 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 as directed above, upload to your HTML directory and chmod to 644. example: formv9.html *** DO NOT UPLOAD YOUR HTML FORM 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 OR WEB HOST 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 # ###############################################