Santa Clara University

Web Publishing @ SCU

CommonSpot Elements

Content Well: E-mail Form

This element creates a simple form to collect and send an message to an e-mail address of your choosing. 

You will need to supply at least two Custom ColdFusion parameters :

  • Sender: one of your form's fields must be a text field for the sender's email address, named "from" - this form field will be used in the e-mail message's Reply-to field.
  • Recipient: enter "to=[e-mail address]" for the recipient. For multiple recipients, separate e-mail address with a semi-colon.
  • Optional Settings:
    subject=[example: Questions and Comments]
    If provided, will replace the default subject line in the e-mail message 'Web Site Feedback Message'
    color=[red,gold,beige]
    label=[example: Contact Us]
    If provided a "feature" style will be applied to the form.
Additional Options:

The email form fields can be modified in a number of ways by supplying custom parameters. The label that displays next to the form field, the name of the form element, the values that the form element includes, and the type of element can all be modified.  Form fields can be designated as required fields by adding an asterix (*) to the end of the form element's label.  You can add up to 20 form fields, simply by adding a block of form element parameters.  A block of form parameters looks like this:

01_label=[text to display next to form field] [* if required]
01_field=[single word that describes the form field]
01_type=[options are text,textarea,select,checkbox, or radio]
01_value=[supply values for select, checkbox, or radio fields]
01_description=[help text to be displayed below the form field]

In the following example, the form parameters are:

to=webmaster@scu.edu
subject=Web Site Feedback
responseText=Thank you for your comments.
color=red
label=Contact Us

01_label=Your name*
01_field=name
01_type=text
01_value=
01_description=

02_label=Your email address*
02_field=from
02_type=text
02_value=
02_description=

03_label=Subject
03_field=subject
03_type=select
03_value=comment,feedback,question
03_description=

04_label=Message*
04_field=message
04_type=textarea
04_value=
04_description=

05_label=SCU affiliation
05_field=affiliation
05_type=checkbox
05_value=student,faculty,staff,alumni
05_description=Select more than one affiliation if applicable.

06_label=Reply requested
06_field=reply
06_type=radio
06_value=yes,no
06_description=

example
Printer-friendly format