|
Required
Form Fields: The required tag must
be included in any FormMail based form otherwise the form will not function
properly. The required tags include ACTION
TAG and RECIPIENT
TAG.
Action Tag:
Must include this tag at the start of the form. Answers the question what
type of action to take and method of handling data.
Your form must have this tag enter http://usfweb.stfrancis.edu/forms/bformmail.cgi
exactly as shown.
HTML FORMAT
<form method="post" action="http://usfweb.stfrancis.edu/forms/bformmail.cgi">
Method is Post
Field: recipient
There is only one form field that you must
have in your form, for FormMail to work correctly. This is the recipient
field.
Description:
This form field allows you to specify to
whom you wish for your form results to be mailed. Most likely you will
want to configure this option as a hidden form field with a value equal
to that of your e-mail address.
Syntax:
<input type=hidden
name="recipient" value="email@your.host.com">
Example:
<input type=hidden
name="recipient" value="gkickul@stfrancis.edu">
The following tags are optional but you should
make sure you include the subject and redirect tag
Field: subject
Description:
The subject field will allow you to specify
the subject that you wish to appear in the e-mail that is sent to you after
this form has been filled out. If you do not have this option turned on,
then the script will default to a message subject: WWW Form Submission.
Note:
There are several methods of setting the
subject variable and the best method depending on the form's function or
purpose.
Method 1: Subject is set and you do not want
to change it.
This is the most common method of setting
the form subject. You have developed a form and the subject of the form
will not change. Then set the form subject through a hidden field.
Syntax:
<input type=hidden name="subject" value="Your
Subject">
Example:
<input type=hidden name="subject" value="Student
Grade Request">
Method 2: Subject is changeable so that you
can direct form information
There are time that you might wish to use
the flexibility and power of GroupWise to direct form information to specific
areas and people. For example when online students are submitting evaluation
forms CID using GroupWise does the following with each form submission:
-
Sends an email thank you indicating the receipt
of the form.
-
Redirects the email to the appropriate online
program/college.
-
Sends a copy of the form to a semester folder
contain all evaluation forms.
In this case the subject line changes depending
on the student and course. To accomplish this complicated form we set up
an input field within the form with a name of subject. Then as the student
clicks on the specific course the value of the subject is set to the course.
Syntax:
<input type="radio" name="subject" value="string">
Example:
<input type="radio" name="subject" value="Business
Policy 495A"
Field: email
Description:
This form field will allow the user to specify
their return e-mail address. If you want to be able to return e-mail to
your user, I strongly suggest that you include this form field and allow
them to fill it in. This will be put into 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 'required' field.
Syntax:
<input type=text name="email">
Example:
<input type=text name="email">
Field: realname
Description:
The realname form field will allow the user
to input their real name. This field is useful for identification purposes
and will also be put into the From: line of your message header.
Syntax:
<input type=text name="realname">
Field: redirect
Description:
If you wish to redirect the user to a different
URL, rather than having them see the default response to the fill-out form,
you can use this hidden variable to send them to a pre-made HTML page.
Syntax:
To choose the URL they will end up at:
<input type=hidden name="redirect"
value="http://your.host.com/to/file.html">
Example:
<input type=hidden name="redirect"
value="http://www.stfrancis.edu/cid/thankyou.htm"
Field: required
Description: You can require that certain
fields in your form to be filled in before the user can successfully submit
the form. Simply 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 of what they need to 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, so that you can reach them once
you have received the mail, use a syntax like:
<input type=hidden name="required" value="email,phone">
Field: sort
Description:
This field allows you to choose the order
in which you wish for your variables to appear in the e-mail that FormMail
generates. You can choose to have the field sorted alphabetically 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 simply default to the order in
which the browsers sends the information to the script (which is usually
the exact same order as they appeared 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 e-mail 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, name3,etc...">
Field: print_config
Description:
print_config allows you to specify which
of the config variables you would like to have printed in your e-mail message.
By default, no config fields are printed to your e-mail. This is because
the important form fields, like email, subject, etc. are included in the
header of the message. However some users have asked for this option so
they can have these fields printed in the body of the message. The config
fields that you wish to have printed should be in the value attribute of
your input tag separated by commas.
Syntax:
If you want to print the email and subject
fields in the body of your message, you would place the following form
tag:
<input type=hidden name="print_config"
value="email,subject">
Field: print_blank_fields
Description:
print_blank_fields allows you to request
that all form fields are printed in the return HTML, regardless of whether
or not they were filled in. FormMail defaults to turning this off, so that
unused form fields aren't e-mailed.
Syntax:
If you want to print all blank fields:
<input type=hidden name="print_blank_fields"
value="1">
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://your.host.com/error.html">
|
