Forms to Email

Introduction

This page has basic instructions on formatting a webpage form to be processed by Soupermail. Forms made using this method will be automatically e-mailed to the address of your choice. The creation of forms themselves are not covered in this document. You must use Dreamweaver to create forms right now, while we work out a few issues with the way Collage handles forms.

Instructions

You need to generate two documents; a Form page (somename-form.php) and a Thanks page (somename-thanks.php), and save them in your directory on the webserver.

You'll also need to send some configuration information to the webmaster, using the form at the bottom of this page. This information resides on a separate server, and keeps your form secure, so that it can't be mis-used. Your form will not work without a configuration file! so be sure to fill out this form.

The two basic elements that must be included in your form are:

<form method="post" action="http://web2.colum.edu/cgi-bin/soupermail.pl"> <input type="hidden" name="SoupermailConf" value="/souperconf/somename.con">

The second line specifies your configuration file - replace "somename" with a unique, identifying name for your form, and be sure to include that information in the form below.

Note: the server is now "web2.colum.edu" not "online.colum.edu."

Besides those two snippets of code the rest of the form is up to you - though it's a good idea to add a field with the name "Email", which will appear in the "From:" field in the final message.

Additional information on Soupermail configuration and features can be found at soupermail.sourceforge.net

Please fill out this form completely - all fields are required.

Your Name:
Your Email:
Location of form:	(the URL of the form you are creating, i.e. "http://www.colum.edu/students/ticketorder-form.php")
Configuration file name:	(e.g. "ticketorderform.con")
Form Recipient:	(email address that will receive the form data)
Form Subject:	(Subect line for the email)
Thanks page URL:	(Page that will display after form has been successfully filled out, i.e. "http://www.colum.edu/students/ticketorder-thanks.php)
Alphabetical Field Sorting:	yes no "No" will send your form data in the same order in which it appears on your form. "Yes" will alphabetize the form data, based on the name of each field.
The following information is not required, but may be useful.
Required Fields:	(List the field names of any fields that must be filled out on your form. Separate each field with a comma - "field1, field2, field3")
Failure Page:	(This is the page that will display if your visitor fails to fill out a required field, e.g. "http://www.colum.edu/students/ticketorder-failed.php")
	(you know this is only for Columbia College Webpages, don't you?)