superForm.cgi and html

To be able to successfully use superForm.cgi there are some required html elements that deserve your attention.

superForm.cgi requires two elements to be included in your html: one for sending an email with the form data and another which says who has sent the email.

to-email and nicknames

There are two choices of elements that define who the form data should be sent to:

If you want the form data to be sent to one person you use the "to-email" element.
e.g., <input type="hidden" name="to-email" value="username@yourdomain">

If you want the form data to be sent to muliple people (max of 5) you use the "to-nickname" element.
e.g., <input type="hidden" name="to-nickname" value="nickname">

For more information on configuring nicknames please go to http://info.connect.com.au/docs/hosting/vws/advanced/forms.html

from-email

Our mail server has been configured to observe certain rules for limiting SPAM. One of these SPAM filters requires that anyone sending an email via our mail server must include a valid sender's email address.

When superForm.cgi attempts to send your form data on to you, it looks for the "from-email" element to retrieve the sender's email address.
e.g., <input type="hidden" name="from-email" value="webmaster@yourdomain.com.au">
or <input type="hidden" name="from-email">

The first example "always" allows the form to work as the "from-email" address is "hard coded" into the html.

This is the preferred configuration as the form will still be mailed to you regardless of any mistyped email address that a visitor makes when entering their details in any other "email" field on your form.

The second example relys on the input of a valid email address into this data field for the form to work..
We suggest that if you choose this example that you make that field a mandatory one.
e.g., <input type="hidden" name="from-email-MANDATORY" value="true">

Remember: If a visitor to your page types in an invalid email address the form will fail.

One "trap" html developer's fall into when using superForm.cgi is that they will "hard code" the "from-email" element into their html document, but will also create a data field with a second "from-email" element for their prospective customer's to type in their email address.

When this happens, superForm.cgi will append both email addresses together and form one large email address which will be rejected by our mail server.

You must have only one "from-email" element in your document.