Welcome to the Summersault Knowledgebase. Here you will find a variety of helpful information about how to best use your hosting account with us. If you don't see the answer to your question, please submit a technical support request and we'll do our best to help!
Setting Up Your Account
How can I allow someone to send me mail through my website (web to e-mail form)?
Summersault offers a an easy-to-configure webform-to-email script called FormMail which is pre-installed and available to our hosting clients free of use.
- Configure the "ACTION" field in your FORM tag to be
http://summersault.com/cgi-local/formmail.cgi
Specify GET or POST as your METHOD within your form. - Follow the steps to configure your FORM through the FormMail readme below.
- Make sure that the "recipient" field contains an e-mail address that is hosted by Summersault.
Note: some of this information may not apply if you are using Summersault's new control-panel based hosting plans (setup after June 2007). Learn more about this change.
FormMail Readme
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 'feedback@your.domain' when someone submits the form:
<
form method="post" action="http://your.domain/cgi-bin/FormMail.pl">
<input type="hidden" name="recipient" value="feedback@your.domain" />
<input type="text" name="feedback" /><br />
Please enter your comments<br />
<input type="submit" />
<
/form>
See how the hidden 'recipient' input in the example above told formmail who to send the mail 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:
| recipient | The email address to which the form submission should be sent. If you would like it copied to more than one recipient then you can separate multiple email addresses with commas, for example: <input type="hidden" name="recipient" value="you@your.domain,me@your.domain" /> |
|||
| subject | The subject line for the email. For example: <input type="hidden" name="subject" |
|||
| redirect | If this value is present it should be a URL, and the user will be redirected there after a successful form submission. For example: <input type="hidden" name="redirect" value="http://www.yourdomain.com/foo.html" /> Be sure the redirect value is a complete URL that includes your domain name. 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. |
|||
| bgcolor | The background color for the success page. | |||
| background | The URL of the background image for the success page. | |||
| text_color | The text color for the success page. | |||
| link_color | The link color for the success page. | |||
| vlink_color | The vlink color for the success page. | |||
| alink_color | The alink color for the success page. | |||
| title | The title for the success page. | |||
| return_link_url | 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: <input type="hidden" name="return_link_url" value="/home.html" /> |
|||
| return_link_title | The label for the return link. For example: <input type="hidden" name="return_link_title" value="Back to my home page" /> |
|||
| sort | 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: <input type="hidden" name="sort" value="order:name,email,age,comments" /> 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. |
|||
| print_config | This is mainly used for debugging, and if set it causes formmail to include a dump of the specified configuration settings in the email. For example: <input type="hidden" name="print_config" value="title,sort" /> ... will include whatever values you set for 'title' and 'sort' (if any) in the email. |
|||
| required | 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" /> |
|||
| missing_fields_redirect | 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. Be sure the redirect value is a complete URL that includes your domain name. | |||
| env_report | This is a list of the CGI environment variables
that should be included in the email. This is
useful for recording things like the IP address
of the user in the email. The environment variables that you may
use are:
|
|||
| print_blank_fields | If this is set then fields that the user left blank will be included in the email. Normally, blank fields are suppressed to save space. | |||
| As well as all these hidden inputs, there are a couple of non-hidden inputs which get special treatment: | ||||
| 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. Note the spelling must be 'email', not 'e-mail'. | ||||
| realname | 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. | |||
Click here for more information
If you still have questions or need assistance, please submit a technical support request.
Last update: 2007-06-11 09:38
Author: Summersault Support
printer-friendly version
Send to a friend
Show this as PDF file
export as XML-File
You cannot comment on this entry
powered by phpMyFAQ 1.5.0 RC3
