WebValence Top LeftWebValence Top Right

Web Sites and Ezine Design and Hosting

 

Legacy Forms to Mail

Legacy Forms to Mail is not recommended. This page is for reference only.

Refer to the current Forms to Mail Instructions for implementing a new Form to Mail page.

Legacy Forms to Mail uses a system-resident script to Email form content from a web site visitor to the site owner. Optional extras include:

  • Privacy encode the site owner name and Email address to thwart spam bots,
  • Format the contact information for ease of reading,
  • Auto-respond with custom Email content to the web site visitor, and
  • Send a copy of a web page to a web site visitor

Forms to Mail HTML Creation Wizard

Form to Mail Wizard Instruction

Use the Wizard to create basic HTML for your Form. Leave unwantted optional fields blank. Copy and paste the resulting HTML into your web page. Then edit to add more form fields, as needed, to capture specific information for your application.

Mailer Form Creation Wizard
Required Parameters
Site Domain Name, Example:
mysite.com
Site owner name, Example:
FirstName LastName

Site owner Email address, Example:
FirstName@mysite.com

Privacy encode site owner info? No Yes
Subject for Email message
Optional Parameters
Web response page for site visitor
http://mysite.com/thanks.html
Error response page for site visitor
http://mysite.com/error.html
Email Template URL for owner
http://mysite.com/emailtemplate.html
Email auto response to site visitor? No Yes
Email auto response URL
http://mysite.com/emailTemplate.html
Email auto responder Subject
Email auto responder From Name
Email auto responder From Address
Carbon Copy Email address, Example:
AnotherName@mysite.com
   
Click Here --> --> and copy output from immediately below.

Wizard Output HTML

 

Form Parameter Documentation

Caution: Form parameter names must be spelled the same as in the example. Parameter names are case-independent. For example, use "ToName" or "toname" but not "to-name".

Required Form Parameters

ToName: Name of the person receiving the mail, normally the owner. This will be encoded if you have selected the privacy setting in the wizard above.

ToAddress: Email address of the person receiving the mail. This will be encoded if you have selected the privacy setting in the wizard above.

Subject: A subject line to identify this message

FromName: Name of the sender, the website visitor. Substitute FirstName and LastName, if preferred.

FromAddress: Email address of the sender. This address will be copied into a reply-to header in the Email message.

Absence of these parameters will cause mailer to display an error message and no mail will be sent.

Optional Form Parameters

RequiredValues: Optionally name a comma-separated list of parameters that are mandantory. For example, to require that the user enter something in the name, address and phone, use the following hidden tag. <input type="hidden" name="RequiredValues" value="name,address,phone">

Carbon Copy: To send a carbon copy, place the parameter CC in the list of parameters.

For example, use: <input type="hidden" name="CC" value="owner@yourdomain.com">

Response Page: Place either a URL in the "NextPage" paramenter to specify a static web page to fetch upon successful forms submission. The page text may contain fill-in parameters specified with square bracket syntax, eg, [$FirstName].

For example, use: <input type="hidden" name="NextPage" value="http://yourdomain.com/thankyoupage.html">

Error Response Page: A corresponding dynamic response page to "NextPage" may be fetched when an error condition is detected by the script. The error response may be specified in an "errorPage" parameter.

For example, use: <input type=hidden name=errorPage value=http://yourdomain/errorPage.html>

Use a tag named "errorMsg" to display the text for the error on the Error Page Response page.

For example, write some code like this on the Error Page:
Sorry, but your mail was not sent. [$errorMessageHTML]

Formatted Report for the Site Owner : To combine the forms parameters with a text file and produce a formatted Email message, place the parameter "MailForm" in the list of hidden parameters. For plain text messaging, use a "txt" file. Otherwise use an "html" file.

For example, use: <input type="hidden" name="MailForm"      value="http://yourdomain.com/MailFormFile.html">

In the example, "MailFormFile.html" is the name of a text file that is stored on your web site, "yourdomain". See example below for more information on text file content.

Auto Responder to the Site Visitor: To auto respond with an email message to the web site visitor, add the "responder", and "respSubject" parameters to your form.

The text in the responder message may be HTML or plain text. Name the file containing your response to be with a suffix that is consistent with its content (.html or .txt).

Example:
<input type="hidden" name="responder"      value="http://yourdomain.com/ResponseFile.html">
<input type="hidden" name="respName" value="John Brown ">

In the example, "ResponseFile.html" is the name of a HTML file containing your response that is stored on your website.

Submit Button: The submit button may be given any value you choose, as the submit parameter is ignored. We recommend that you leave the name attribute out of your submit tag.

For example: <input type="submit" value="Send Request">

Formatting for the Email Message

Use this option to create custom formatted Email messages. Such messages may be mailed either to the site owner or to the site visitor, or both.

To prepare the formatting template, create a text or html file with fill-in fields. Each fill-in field is of the form "[$fill-in]" and is named the same as one of the parameters in your web page form. The "[$fill-in]" will be replaced with the contents that the web site visitor typed in the form. An example will help you understand this concept more easily.

Example File name: SessionPlan.txt

Example File contents as follws:

Life Design Institute: Coaching Session Plan

Name: [$FromName] <[$FromAddress]>

Present Status:
[$HowIAm]

Progress Since The Last Call:
[$Happenings]

Working On:
[$WorkingOn]

Support Needed:
[$HowYouCanHelp]

Next Step:
[$NextStep]

...End of File

NOTE: In this example the field names: FromName, FromAddress, HowIAm, Happenings, WorkingOn, HowYouCanHelp, and NextStep will be replaced with corresponding values from the web form.

Be sure to self-test your implementation and contact support@webvalence.com if you have problems or questions.

 
 
WebValence Bottom LeftWebValence Bottom Right Copyright 1997 - 2010 :: All Rights Reserved
WEBVALENCE is a registered trademark of WebValence Internet Partners