HTML FORM SETUP


Description: To process the form you will need specific fields. A list of all predefined fields is below.

Predefined Function Form Fields

<form method="post"> <input name="subject"> <input name="success_page"> <input name="error_page"> <input name="required"> <input name="required_desc"> <input name="send_to"> <input name="cc_to"> <input name="bcc_to"> <input name="sort"> <input name="sendreply"> <input name="reply_subject"> <input name="email"> <input name="outputfile"> <input name="datafile"> <input name="data_format"> <input name="text_qualifier"> <input name="check_duplicate"> <input name="field_descriptions">

---

<form method="post">

(1B) Creating your HTML forms page or configuring the form.html example form page.
(This is the form page your visitors will see and fill out on your site)

START FORM WITH THE LINE BELOW. 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


^ TOP ^

---

<input name="subject">


"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">


^ TOP ^

---

<input name="success_page">

"success_page" IS THE WEB SITE THE FORM POSTER WILL BE SENT TO AFTER SUCCESSFULLY COMPLETING THE FORM
LEAVE FIELD BLANK, OR LEAVE FIELD OUT OF FORM TO USE THE bizmail.cgi DEFAULT SUCCESS PAGE.

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

There is a eparate success.cgi module that can be used.
There are two modules; one powered by MySQL and one that is powered by the flat file database.


^ TOP ^

---

<input name="error_page">



^ TOP ^

---

<input name="required">

"required" ARE ALL THE FIELDS YOU WANT TO FORCE TO BE FILLED IN.
the value="" should contain a list of all required fields separated by a comma.

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


^ TOP ^

---

<input name="required_desc">

"required_desc" ARE ALL THE DESCRIPTIONS OF THE FIELDS YOU WANT TO FORCE TO BE FILLED IN. This works in conjunction with the hidden field "required". For every entry in the "required" hidden field there should be an associated corresponding entry in the "required_desc" hidden field.

the value="" should contain a list of all required descriptions separated by a comma.

The purpose of this field deals with the “required error” page that may come up in bizmail.cgi. Instead of just printing the field “name” that is missing, you can print the description of that field that may contain spaces. Therefore, you get red of the ugly underscores.

THIS FIELD IS OPTIONAL

FOR EXAMPLE IF THIS IS YOUR "required" HIDDEN FIELD BELOW:
<input type="hidden" name="required" value="email,firstname,nextrequiredfield,etc">

THEN YOUR "required_desc" HIDDEN FIELD SHOULD LOOK LIKE THIS:
<input type="hidden" name="required" value="Email,First Name,Next Required Field,Etc">


^ TOP ^

---

<input name="send_to">

"send_to" refers to the $sendto{"1"}, $sendto{"2"} etc... variables which are configured in
bizmail.cgi. What this means in laymen's terms if the send to section of your bizmail.cgi file looks like:

$sendto{"1"} = "you\@yahoo.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)##
$sendto{"2"} = "you\@hotmail.com";


THEN USING <input name="send_to" type=hidden value="1">
WOULD SEND DATA TO "you@yahoo.com"

IF USING <input name="send_to" type=hidden value="2">
WOULD SEND DATA TO "you@hotmail.com"

ETC...

For the number that is chosen, that same configured number in bizmail.cgi is where form submission will be sent for that particular form. This is also used as the reply email address in the auto-response email sent to the form poster.
THIS FIELD MUST BE INCLUDED IN THE FORM FOR ANY EMAIL WHATSOEVER TO BE SENT

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


^ TOP ^

---

<input name="cc_to">

"cc_to" refers to the $cc_to{"1"}, $cc_to{"2"} etc... variables which are configured in bizmail.cgi. Quite simply, this means that if the “send to” section of your bizmail.cgi file looks like:

$cc_to{"1"} = "ccto\@yahoo.com"; ## (REMEMBER THE \ BEFORE THE @ SIGN)##
$cc_to{"2"} = "ccto\@hotmail.com";

THEN USING <input name="cc_to" type=hidden value="1">
WOULD SEND DATA TO "ccto@yahoo.com"

IF USING <input name="cc_to" type=hidden value="2">
WOULD SEND DATA TO "ccto@hotmail.com"

ETC...

The number that is chosen will have that same corresponding number in bizmail.cgi, determining where the form submission will be carbon copied for that particular form. This field is only needed or used if you want the form data carbon copied to a second email address. If you don't want form data carbon copied to a second email just leave this field out of the form.

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


^ TOP ^

---

<input name="bcc_to">

The full readme for this using this field can be found here.

^ TOP ^

---

<input name="sort">

"sort" is another optional field and SHOULD ONLY BE IN THE FORM if you want to sort the field order in the results email you will receive. You can also leave fields out of the form by not including them in this field. If using this option, enter all the form fields you want to be added to the results email starting with the first you want to appear and ending with the last you want to appear and separate each field with a comma.
Example: value="email,firstname,lastname,phone"

NOTE: The date and ipaddress will automatically be added to the top of every form and does not need to be configured in the sort field. SEEN EXAMPLE BELOW.

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


^ TOP ^

---

<input name="sendreply">

SET "sendreply" = "1"; IF YOU WANT TO SEND THE FORM POSTER THE AUTO-RESPONSE EMAIL
SET "sendreply" = "0"; IF YOU DON'T WANT TO SEND THE FORM POSTER THE AUTO-RESPONSE EMAIL
IF "sendreply" = "1"; THE name="email" field must be included in your form

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


^ TOP ^

---

<input name="reply_subject">

"reply_subject" IS THE AUTO RESPONSE MESSAGE SUBJECT LINE. IF YOU SET THE ABOVE VARIABLE "sendreply" TO 0, THE BELOW FIELD IS OF NO CONSEQUENCE TO YOUR FORM

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

For example, if you want the subject to contain the form poster’s first name and you have the form field <input name="firstname" type=text> to gather the person’s first name, then you would personalize the subject line with {firstname}. See example:
<input type="hidden" name="reply_subject" value="RE: {firstname} Your recent inquiry.">

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


^ TOP ^

---

<input name="email">

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="">

name="email" is CASE SENSITIVE. name="EMAIL" will not work!!!


^ TOP ^

---

<input name="outputfile">

THE “FORM FIELDS” FOUND BELOW ARE NOT NECESSARY, BUT DO ADD MORE VERSATILITY.

"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. You can specify certain fields. If using this option, enter all the FORM fields you want to be added to the file and separate them with a comma.
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.
See the examples below.

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

^ TOP ^

---

<input name="datafile">

"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. For example, to write to the 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 and CHMOD to 777.

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

-OR-

<input type="hidden" name="datafile" value="2">

-OR-

<input type="hidden" name="datafile" value="3">

etc...

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



^ TOP ^

---

<input name="data_format">

"data_format" is the text separator of the form fields for the data file.
Example: if value="," is entered the data will be sent to the data file as:
email,firstname,lastname,phone,etc - If you want tab delimited format, simply put your cursor between the "" and hit the tab key. This will print data in the format: email firstname lastname phone etc
You can choose whatever 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)


^ TOP ^

---

<input name="text_qualifier">

"text_qualifier" is a data format option. Set to 1 if you want there to be a double quote (") "text qualifier". Example (If you chose the , data_format and set text_qualifier to 1) data would appear as: "email","firstname","lastname","phone","etc" IN THE DATA FILE

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


^ TOP ^

---

<input name="check_duplicate">



^ TOP ^

---

<input name="field_descriptions">



^ TOP ^