FormMail

The FormMail script is a universal form to an email gateway. Use this script if you want to have a form's contents emailed to you, but aren't sure how to write the code for it.

Please note: You must already have a form on your website for the FormMail script to work.

After setting the desired values for the fields, click the "Install" button to complete the operation. The results of operation will be displayed. Follow the instructions on the results page to start using the FormMail script.

The following is the description of FormMail various configuration options. To use this script only the Mandatory field must be filled out.

Mandatory field

Recipients email address: this field allows you to specify the email address you want your form results to be mailed to.

Suggested fields

Your email subject: this field allows you to specify the subject that you wish to appear in the email that is sent to you after this form has been filled out. Enter your desired subject in the "Your email subject" textbox.

Allow user enter subject: this field allows you to include a textbox in your form for users to enter a subject. Click the "Allow user enter subject" textbox to include the subject textbox.

Allow User to enter their email address: this field allows you to include a field in your form for users to enter their return email address. Click the "Allow User to enter their email address" check box to include the email textbox.

Optional fields

Redirect url: this field allows you to specify a URL to redirect the users to after they submit the form. Enter your desired URL in the "Redirect url" textbox.

Example: If you want to redirect the users to the mycar.com domain after submitting the form you should enter the following in the "Redirect url" field:

http://mycar.com

If you leave this field blank, the user will see a default message.

Required fields: this field allows you to require certain fields in your form to be filled in before the user can successfully submit the form. If the required fields are not filled in, the user will be notified of what they need to fill in and a link back to the form will be provided. Enter all field names that you want to be mandatory in the "Required fields" textbox separated by commas.

Title on result page: this field allows you to specify the title and header that will appear on the resulting page if you do not specify a redirect. Enter your desired title in the "Title on result page" textbox.

Sort order: this field allows you to choose the order in which you wish your variables to appear in the email that FormMail generates. You can sort the fields alphabetically by entering the word "alphabetic" in the "Sort order" textbox.

You can specify a set order in which you want the fields to appear in your mail message. Enter the phrase "order:" as the first part of your value in the "Sort order" textbox and then follow that with the comma separated field names you want to be listed in the email message

Example: order:name1, name2, etc...

Environment variables: this field allows you to have Environment variables included in the email message you receive after a user has filled out your form.

Print config: this field allows you to specify which of the config variables you would like to have printed in your email message. By default, no config fields are printed to your email. Enter the comma separated list of your desired config fields in the "Print config" textbox.

Print blank links: this field allows you to have all form fields printed in the return HTML, regardless of wether or not they were filled in. Click the "Print blank links" checkbox for turning this option on.

Return link url: this field allows you to specify a URL that will appear as your "Return link title", on the following report page. This field will not be used if you have the redirect field set. Enter your desired URL in the "Return link url" textbox.

Return link title: this is the title that will be used to link the user back to the page you specify with "Return link url". Enter your desired title in the "Return link title".

Missing fields redirect: this field allows you to specify a URL that users will be redirected to if there are listed in the required form fields that are not filled in. This will enable you to customize an error page instead of displaying the default.

Background image: this field allows you to specify a background image that will appear if you do not have the "Redirect url" field set. This image will appear as the background to the form result page. Enter the absolute path to the image in the "Background image" textbox.

Background color: this field allows you to specify a bgcolor for the form result page. This field should not be set if the "Redirect url" field is set. Enter your the color (e.g. Black) or a number sign (#) followed by the hexadecimal value of the color your want to set for the result page background.

Example: For a background color of white enter #FFFFFF

Text color: this field works in the same way as "Background color" field, except that it will change the color of your text.

Link color: this field allows you to change the color of links on the resulting page and it works the same way as "Text color" field.

Vlink color: changes the color of visited links on the result page and it works the same way as "Link color" field.

Alink color: changes the color of active links on the result page and it works the same way as "Vlink color" field.