This browser does not support basic Web standards, preventing the display of our site's intended design. May we suggest that you upgrade your browser?

Adobe Dreamweaver CS3

Forms: Hidden Optional Form Fields

In addition to the five required hidden form fields, there are optional form fields available with the UWEC Forms Processing Script. These optional fields are not visible to the user, and allow form developers to redirect users to a certain URL, require that users fill in certain form fields, or obtain information from users' environment variables, such as what web browser they were using when they visited the page.

The UWEC forms scripts have the ability to send form results to multiple recipients more easily, send automatic courtesy messages, and store the form results in a data file that can be imported into a Word table, Excel spreadsheet, Access database table, or other data processing program.

NOTE: For more information about working with optional form fields, please refer to Optional Visible Form Fields, Courtesy Reply Message, Capturing the Data, and Formatting the Results Page.

return to topDefining the Hidden Optional Form Fields

This section briefly defines the optional hidden form fields. The next section, Inserting the Optional Hidden Form Fields, gives instructions and examples of values to be used. The optional hidden form fields can be divided into the following categories:

Requiring completion of fields
The required and missing_fields_redirect fields can be used to force completion of specific fields. The missing_fields_redirect can pull up a developer-designed error page. 

Redefine the "Results" Page
Instead of displaying the default results page, you can redirect the user to a page of your choosing, perhaps a thank you page.

Generating an Environment Report 
The env_report hidden form field gives a form developer access to environment variables, which can provide additional information about users, such as what web browser they were using or what domain (e.g., uwec.edu) they were coming from. The form developer will receive this information in the email that contains the form information. The names of the environment variables must be entered as the value of this hidden form field.

Sharing the Results
Use the cc and bcc field to share the form results with multiple people.

Generate a Custom Email Reply
Use the courtesy reply fields to customize an email that is automatically sent to the user who completed the form. Fields include:
courtesy_reply
courtesy_reply_texta
courtesy_reply_textb
courtesy_who_we_are
courtesy_our_url
courtesy_our_email

Capture Results to a Data File
Reduce the data entry and capture the results to a file with the following fields:
append_db
db_fields
db_delimiter

 

return to topOptional Hidden Form Fields: Values

Before inserting the optional hidden form fields into your form, you must first know the values to be used. The following table illustrates each hidden form field's name and value.

NOTE: Field names are case sensitive, so be careful that values here match the field names used in the visible form fields.

General

required
The value is the name(s) of any form field(s) a form developer would like to be required, separated by commas if more than one form field will be required.
EXAMPLE: email,realname

redirect
The value is the URL of the page you want to redirect the user to.
NOTE: You must use the absolute URL.
EXAMPLE: http://www.uwec.edu/yourdirectory/yourpage.htm

missing_fields_redirect
The value is the URL of the web page users are redirected to when they have not filled in required fields.
NOTE: You must use the absolute URL.
EXAMPLE: http://www.uwec.edu/yourdirectory/yourpage.htm

env_report
The value is the name(s) of the environment variable(s) you would like to use, separated by commas if you use more than one.


Names of Environment Variables

REMOTE_HOST
Sends the hostname of the user
EXAMPLE: uwec.edu

REMOTE_ADDR
Sends the Internet Protocol (IP) address, the unique number of the user's computer on a network or the Internet
EXAMPLE: 137.28.143.226

HTTP_USER_AGENT
Sends the type of browser the user is running

 

Sharing the Results

cc
The value is the email address of the person you would like a carbon copy to go to.
EXAMPLE: username@uwec.edu

bcc
The value is the email address of the person you would like a blind carbon copy to go to. A blind carbon copy prevents email recipients from viewing each other's email address.
EXAMPLE: username@uwec.edu

 

Generate a Custom Email Reply

Below are the fields for the courtesy email reply options.

courtesy_reply
The value entered is the word 'yes'.

courtesy_reply_texta
The value entered is the first line of your courtesy reply text.
EXAMPLE: Thank you for taking the time...

courtesy_reply_textb
The value entered is the second line of your courtesy reply text.
EXAMPLE: Call us if you need anything...

courtesy_who_we_are
The value entered is how you would like to be identified.
HINT:A second line can be displayed by having another field with the name:'courtesy_who_we_are2'.
EXAMPLE: LTS Web Dev

courtesy_our_url
The value entered is a URL which will be inserted in the footer of the automated reply.
EXAMPLE: http://www.uwec.edu/yourdir/

courtesy_our_email
If you want to put your mailto address in the footer of the reply, enter that value here.
EXAMPLE: web@uwec.edu

 

return to topInserting the Hidden Optional Form Fields

To insert a hidden optional form field, use the following instructions. For information about hidden optional form fields, refer back to Defining Hidden Optional Form Fields and Optional Form Fields: Values.

  1. Open the file that contains your form or create your form

  2. Place your cursor within the form boundary where you would like to insert the hidden form field

  3. From the Insert menu, select Form » Hidden Field
    OR
    From the Forms bar, click HIDDEN FIELDHidden Field button
    The hidden field will appear.

  4. Select the hidden field by clicking it onceHidden Field icon
    The HiddenField properties pane appears.
    HiddenField properties pane

  5. In the HiddenField text box, type the name for the hidden field

  6. In the Value text box, type the appropriate value for the hidden field

  7. Repeat steps 2-6 until you have entered all the needed hidden form fields

Excellence. Our Measure. Our Motto. Our Goal.