| recipient
|
The email address to which the form submission should
be sent. If you would like it copied to
more than one recipient then you can separate multiple
email addresses with commas, for example:
<input type="hidden"
name="recipient" value="you@your.domain,me@your.domain">
THIS
IS A REQUIRED FIELD! |
| subject |
The
subject line for the email. For example:
<input type="hidden"
name="subject" value="From
the feedback form"> |
| redirect
|
If
this value is present it should be a URL, and the user
will be redirected there after a successful form submission.
For example:
<input
type="hidden" name="redirect" value="http://www.your.domain/foo.html">
If you don't specify a redirect URL then instead of
redirecting formmail will generate a success page telling
the user that their submission was successful. |
| bgcolor
|
The
background color for the success page. |
| background |
The
URL of the background image for the success page. |
| text_color |
The
text color for the success page. |
| link_color |
The
link color for the success page. |
| vlink_color |
The
vlink color for the success page. |
| alink_color |
The alink color for the success page. |
| title |
The
title for the success page. |
| return_link_url |
The
target URL for a link at the end of the success page.
This is normally used to provide a link from the success
page back to your main page or back to the page with
the form on. For example:
<input type="hidden"
name="return_link_url" value="/home.html">
|
| return_link_title |
The
label for the return link. For example:
<input type="hidden"
name="return_link_title" value="Back
to my home page"> |
| sort |
This
sets the order in which the submitted form inputs will
appear in the email and on the success page. It can
be the string 'alphabetic' for alphabetic order, or
the string "order:" followed by a comma separated
list of the input names, for example:
<input type="hidden"
name="sort" value="order:name,email,age,comments">
If
"order:" is used you must supply the names
of all of the fields that you want to be in the body
of the mail message. |
| print_config |
This
is mainly used for debugging, and if set it causes formmail
to include a dump of the specified configuration settings
in the email. For example:
<input type="hidden"
name="print_config" value="title,sort">
... will include whatever values you set for 'title'
and 'sort' (if any) in the email. |
| required |
This
is a list of fields that the user must fill in before
they submit the form. If they leave any of these fields
blank then they will be sent back to the form to try
again. For example:
<input type="hidden"
name="required" value="name,comments"> |
| missing_fields_redirect |
If
this is set, it must be a URL, and the user will be redirected
there if any of the fields listed in 'required' are left
blank. Use this if you want finer control over the the
error that the user see's if they miss out a field. |
| print_blank_fields |
If
this is set then fields that the user left blank will
be included in the email. Normally, blank fields are
suppressed to save space.
As
well as all these hidden inputs, there are a couple
of non-hidden inputs which get special treatment: |
| email |
If
one of the things you're asking the user to fill in is
their email address and you call that input 'email', formmail
will use it as the address part of the sender's email
address in the email. |
| realname |
If
one of the things you're asking the user to fill in is
their full name and you call that input 'realname', formmail
will use it as the name part of the sender's email address
in the email. |