Back to Tutorials
for your On-Line Order and Feedback Forms  

What is FormMail?
FormMail is a simple to use, generic HTML form which emails the results of any form to the specified recipient. Unlike other form scripts, FormMail poses no security risk for the server and can be used for almost any kind of feedback form required - orders, enquiries, statistic gathering etc.

FormMail is installed on our server so all you have to do is point the Form Action command to:
http://www.hwy.com.au/cgi-bin/formmail.pl
This only applies to Highway members' websites, ie. www.hwy.com.au/~username
However, if you have a Domain and it is hosted by Highway, the Form Action should point to:
http://yourdomainname.com.au/cgi-sys/FormMail.cgi

The easiest way to make a form for yourself would be to copy the source code of the form below, then amend it accordingly. To view the source code (HTML) of this page in Internet Explorer, simply RIGHT mouse click on the page and select 'View Source'. Copy the code, starting at:
<form action="http://www.hwy.com.au/cgi-bin/formmail.pl" method="Post">
all the way down to the very last line:
</BODY></HTML>
Then paste it into your webpage using the "Paste as HTML" option.
Remember to change the Recipient details to that of your own email address. You can choose to either amend the existing Text and Hidden fields or delete them if not required. For Necessary & Optional Form Fields, see below.
EXAMPLE OF A FORMMAIL FORM

Email address:
Full name:
Country:
Comments:
   

NECESSARY FORM FIELDS

There is only one form field that you absolutely MUST have in your form for FormMail to work correctly. This is the recipient field.

Field: recipient
Description: This form field allows you to specify to whom the form results are to be mailed. We suggest that this option is configured as a hidden form field with a value equal to that of your email address.  
Syntax: <input type=hidden name="recipient" value="username@hwy.com.au">
* If required, you can include multiple recipients by separating the values with commas.
<input type=hidden name="recipient" value="username@hwy.com.au, username2@hwy.com.au">

OPTIONAL FORM FIELDS

Field: email
Description: This allows the user to specify their return email address which will then appear in the From: field of the email you receive. If you do not include this field, you won't be able to reply to the form sender. To ensure that the sender uses a valid email syntax, add this field name to the required field.
Syntax: <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: subject
Description: The subject field allows you to specify the subject title that appears in the email that is sent to you after this form has been filled out. If you choose not to use this option, then the script will default to a message subject: WWW Form Submission.
Syntax: <input type=hidden name="subject" value="Order Form ">
NB: You can change "Order Form" to whatever you'd like it to read, eg. Booking Form, Online Order Submission etc.
Field: required
Description: This forces 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 on the form, 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.
Syntax: <input type=hidden name="required" value="email,realname,phone">
*This value is forcing the email, realname & phone fields to be completed otherwise the form cannot be submitted.
Field: title
Description: This form field allows you to specify the title and header that will appear on the resulting page which the user will see after the form has been submitted.
Syntax:<input type=hidden name="title" value="Feedback Form Results">
Use the above if you wanted a title of "Feedback Form Results" , or for a more personalised title, how about:
<input type=hidden name="title" value="Thank you. Your request has been submitted and we will be in touch shortly.">
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 Thank-you page.
Syntax: <input type=hidden name="redirect" value="http://your.domainname.com/thankyou.htm">
NB: This will override the "title" field above as the user will no longer see the default page after the form has been submitted.

[top]