| Field: |
bcc |
| Description: |
This form field allows you to specify the email address your
form results to be Blind Carbon Copied to. Enter multiple recipients by separating
the email addresses with commas.
It is recommended that you enter this information in the script, not as a hidden
field in the form. |
| Syntax: |
<input type="hidden" name="bcc" value="emailbcc@yourdomain.com">
OR
<input type="hidden" name="recipient" value="userbcc@yourdomain.com,user2bcc@yourdomain.com"> |
|
| Field: |
cc |
| Description: |
This form field allows you to specify the email address your
form results to be Carbon Copied to. Enter multiple recipients by separating
the email addresses with commas.
It is recommended that you enter this information in the script, not as a hidden
field in the form. |
| Syntax: |
<input type="hidden" name="cc" value="emailcc@yourdomain.com">
OR
<input type="hidden" name="recipient" value="usercc@yourdomain.com,user2cc@yourdomain.com"> |
|
| Field: |
subject |
| Description: |
The subject field will allow you to specify the subject that
will appear in the email sent to you after the form is submitted. Default subject is
"Form Submission". |
| Syntax: |
<input type="hidden" name="subject" value="Your Subject">
You can also let the user enter a subject:
<input type="text" name="subject"> |
|
| Field: |
email |
| Description: |
For the user to specify their email address. This will be
used as the From: field of the message you receive. If you want to require an email
address with valid syntax, add this field name to the require field. |
| Syntax: |
<input type="text" name="email"> |
|
| Field: |
realname |
| Description: |
The realname form field provides the user the ability to
input their real name. Useful, and will also be used in the From: line of your
email message header. |
| Syntax: |
<input type="text" name="realname"> |
|
| Field: |
attachment |
| Description: |
The 'attachment' form field provides the user the ability to
upload a file to you. The file will NOT be stored on the server. It will be
sent by email only. Please note that if you use this capability, you will have
to adjust your form tag to support file uploads. Other than that, there is no
other code requirement on your part, the entire upload process is handled by PHPMailer-FE.
You also need to note that there is no restriction on file type, or on
|
| Syntax: |
<input type="text" name="realname"> |
|
| Field: |
redirect |
| Description: |
If you wish to redirect the user to your custom landing
page after they submit a form (vs having them see the default message), you
can use this in a hidden form field to send them to your custom pre-made HTML page. |
| Syntax: |
To choose the URL they will end up at:
<input type="hidden" name="redirect" value="http://www.yourdomain.com/thanx.html"> |
|
| Field: |
require |
| Description: |
You can require certain fields in your form to be filled in
before the user can submit the form. Place all field names that you want to be
mandatory into this field. If the required fields are not filled in, the user
will be notified they need to further fill in, and a link back to the form they
just submitted will be provided.
To use a customized error page, see missing_fields_redirect |
| Syntax: |
If you want to require that they fill in the email and phone fields
in your form, use syntax like:
<input type="hidden" name="required" value="email,phone"> |
|
| Field: |
env_report |
| Version: |
1.3 & Up |
| Description: |
Allows you to have system environment variables included in the
email message you receive. Useful if you wish to know what browser, domain, or any
other attributes associated with environment variables. The following is a list of
valid environment variables:
| REMOTE_HOST |
Sends the hostname of the user's ISP. |
| REMOTE_ADDR |
Sends the IP address of the remote host making the request. |
| REMOTE_USER |
If server supports authentication and script is protected,
this is the username they have logged in as. Note: not commonly used. |
| HTTP_USER_AGENT |
The browser the client is using to fill in and send
the form. |
| HTTP_REFERER |
The web page the user came from to land on your form. |
|
| Syntax: |
If you wanted to find the remote host and browser submitting
the form, you would put the following into your form:
<input type="hidden" name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT"> |
|
| Field: |
sort |
| Description: |
This field allows you to choose the order for your variables
to appear in the email that PHPMailer-FE generates. You can choose to have the
field sorted "alphabetic" or specify a set order in which you want the fields
to appear in your mail message. By leaving this field out, the order will default
to the order in which the browsers sends the information to PHPMailer-FE (usually
the same order as they appear in the form.) When sorting by a set order of fields,
you should include the phrase "order:" as the first part of your value for the sort
field, and then follow that with the field names you want to be listed in the email
message, separated by commas. |
| Syntax: |
To sort alphabetically:
<input type="hidden" name="sort" value="alphabetic">
To sort by a set field order:
<input type="hidden" name="sort" value="order:name1,name2,etc..."> |
|
| Field: |
print_blank_fields |
| Description: |
print_blank_fields requests that all form fields
are included in the email, regardless of whether or not they were filled in.
PHPMailer-FE defaults off, so that unused form fields aren't emailed. |
| Syntax: |
If you want to include all blank fields:
<input type="hidden" name="print_blank_fields" value="1"> |
|
| Field: |
title |
| Description: |
This form field allows you to specify the title and header
that will appear on the resulting page if you do not specify a redirect URL. |
| Syntax: |
If you wanted a title of 'Feedback Form Results':
<input type="hidden" name="title" value="Feedback Form Results"> |
|
| Field: |
return_link_url |
| Description: |
This field allows you to specify a URL that will appear, as
return_link_title, on
the resulting report page. This field will not be used if you have the redirect
field set, but it is useful if you allow the user to receive the report on the
following page, but want to offer them a way to get back to your main page. |
| Syntax: |
<input type="hidden" name="return_link_url" value="http://yourdomain.com/main.html"> |
|
| Field: |
return_link_title |
| Description: |
This is the title that will be used to link the user back to
the page you specify with return_link_url.
The two fields will be shown on the resulting form page as:
return_link_title |
| Syntax: |
<input type="hidden" name="return_link_title" value="Back to Main Page"> |
|
| Field: |
missing_fields_redirect |
| Description: |
This form field allows you to specify a URL that users will be
redirected to if there are fields listed in the required form field that are not filled
in. This is so you can customize an error page instead of displaying the default. |
| Syntax: |
<input type="hidden" name="missing_fields_redirect" value="http://yourdomain.com/error.html"> |
|
| Field: |
background |
| Version: |
1.3 & Up |
| Description: |
This form field allow you to specify a background image that will
appear if you do not have the redirect
field set. This image will appear as the background to the form results page. |
| Syntax: |
<input type="hidden" name="background" value="http://www.yourdomain.com/imgs/image.gif"> |
|
| Field: |
bgcolor |
| Description: |
This form field allow you to specify a bgcolor for the form
results page in much the way you specify a
background
image. This field should not be set if the
redirect
field is. |
| Syntax: |
For a background color of White:
<input type="hidden" name="bgcolor" value="#FFFFFF"> |
|
| Field: |
text_color |
| Description: |
This field works the same as
bgcolor,
except that it will change the color of your text. |
| Syntax: |
For a text color of Black:
<input type="hidden" name="text_color" value="#000000"> |
|
| Field: |
link_color |
| Version: |
1.3 & Up |
| Description: |
Changes the color of links on the resulting page. Works the same
as text_color.
Should not be defined if redirect
is ised. |
| Syntax: |
For a link color of Red:
<input type="hidden" name="link_color" value="#FF0000"> |
|
| Field: |
vlink_color |
| Description: |
Changes the color of visited links on the resulting page.
Works the same as link_color.
Should not be set if redirect
is used. |
| Syntax: |
For a visited link color of Blue:
<input type="hidden" name="vlink_color" value="#0000FF"> |
|
| Field: |
alink_color |
| Description: |
Changes the color of active links on the resulting page.
Works the same as link_color.
Should not be set if redirect
is used. |
| Syntax: |
For a active link color of Blue:
<input type="hidden" name="alink_color" value="#0000FF"> |
|
| Field: |
WorxTuringTest |
| Description: |
This is a special field. It is referred to as a Turing test or
"captcha" utility. It is a server side solution ... validation does not occur until
after the user has submitted the data. If you want to use the Turing test, insert this
in your form:
<img src="worxturing.php"><br />
Enter security code:<br />
<input name="WorxTuringTest" id="WorxTuringTest">
You can read more about the Turing test (or captcha utility) at Wikipedia.
|
|
Please enjoy PHPMailer-FE. At Worx International Inc., we have been using this software for more than
3 years.
We have built an entire Remote Forms Processing strategy and commercial service around it. It's robust, and
when used in conjunction with PHPMailer or PHPMailer-Lite, will send out attractive HTML forms.
