Difference between revisions of "Web Hosting Feedback Script"

From SchoolsWiki
Jump to: navigation, search
(Form Configuration)
(Sample HTML)
Line 11: Line 11:
=== Sample HTML ===
=== Sample HTML ===
<source lang="html4strict">
<source lang="html4strict">
<form method="post" action="/feedback/FormMail.pl">
<form method="post" action="/feedback/FormMail.pl">

Revision as of 14:12, 8 October 2008

Feedback Script

Schools who wish to allow users to leave feedback on their websites may use the supplied FormMail feedback script. This is as easy as copying the HTML below

NMS FormMail


NMS FormMail is a drop-in replacement for Matt Wright's FormMail script. It converts an HTML form submission to an email message.

Form Configuration

To make use of it, you need to write an HTML form that refers to the FormMail script. Here's an example which will send mail to the address you specified in your Control Panel when someone submits the form:

Sample HTML

<source lang="html4strict"> <form method="post" action="/feedback/FormMail.pl">

Your name: <input type="text" name="realname" />*
Your email address: <input type="text" name="email" />
Your feedback: <textarea name="feedback" cols="40" rows="5"></textarea>*
<input type="submit" />
       <input type="hidden" name="subject" value="Feedback from your scoilnet form" />
       <input type="hidden" name="required" value="realname,feedback" />

</form> </source>

Sample FormMail

See how the hidden 'subject' input in the example above told formmail what to set the mail subject to? This is how almost all of formmail's configuration works. Here's the full list of things you can set with hidden form inputs:

Advanced Configuration Variables


The subject line for the email. For example:

<source lang="html4strict"> <input type="hidden" name="subject" value="From the feedback form" /> </source>


If this value is present it should be a URL, and the user will be redirected there after a successful form submission. For example:

<source lang="html4strict"> <input type="hidden" name="redirect" value="http://www.your.domain/thankyou.html" /> </source>

If you don't specify a redirect URL then instead of redirecting formmail will generate a success page telling the user that their submission was successful.


The background color for the success page.


The URL of the background image for the success page.


The text color for the success page.


The link color for the success page.


The vlink color for the success page.


The alink color for the success page.


The title for the success page.


The target URL for a link at the end of the success page. This is normally used to provide a link from the success page back to your main page or back to the page with the form on. For example:

<source lang="html4strict"> <input type="hidden" name="return_link_url" value="/home.html" /> </source>


The label for the return link. For example:

<source lang="html4strict"> <input type="hidden" name="return_link_title" value="Back to my home page" /> </source>


This sets the order in which the submitted form inputs will appear in the email and on the success page. It can be the string 'alphabetic' for alphabetic order, or the string "order:" followed by a comma separated list of the input names, for example:

<source lang="html4strict"> <input type="hidden" name="sort" value="order:name,email,age,comments" /> </source>

If "order:" is used you must supply the names of all of the fields that you want to be in the body of the mail message.


This is a list of fields that the user must fill in before they submit the form. If they leave any of these fields blank then they will be sent back to the form to try again. For example:

<input type="hidden" name="required" value="name,comments" />


If this is set, it must be a URL, and the user will be redirected there if any of the fields listed in 'required' are left blank. Use this if you want finer control over the the error that the user see's if they miss out a field.


If one of the things you're asking the user to fill in is their email address and you call that input 'email', formmail will use it as the address part of the sender's email address in the email.


If one of the things you're asking the user to fill in is their full name and you call that input 'realname', formmail will use it as the name part of the sender's email address in the email.