Popular Searches:                    
Freeservers Web Hosting Reliable, Free Web Hosting Brought to you by
My Member Area
 View My Site
 Build My Site
 Enhance My Site
  - Broken Link Redirect
  - CGI Access
  - Corkboard
  - Counter
  - Form Emailer
  - Guestbook
  - Polls
  - Slide Show
  - Webrings
 Promote My Site
 View My Stats
 My Site Toolbar
 Edit My Account
 Upgrade My Site
 Update Billing Info
 Ask Questions
 Visit The Store
Support Options 
FAQs  FAQs 9919379293
Email Support  Email Support 4128361822

My Member Area > Enhance My Site > Form Emailer 
Now you can easily add a fully customized feedback form to any or all of your Web pages and have the results emailed to you!
Our feedback script takes all information from any HTML form that you create, and then sends that information to you in an email message.
Minimize This Section Popular Uses for the Form Emailer
This tool can be used in a number of ways to enhance your site and allow your visitors to more effectively communicate with you. Below are listed only a few of the ways people have used this utility:
Simple Order Form
Users can select products and enter customer data that is then sent to you via email. Do not ask for sensitive information such as credit card numbers!
Visitor Feedback FormGet feedback from your visitors about your Web site.
Bug ReportsHelp users report errors or broken links on your site.
Mailing ListUsers can input their email addresses to join your mailing list. You can collect this data and send messages to your mailing list.
Surveys or VotingAsk your visitors specific questions about their likes and dislikes and have their answers emailed to you.
Much more...Customize the feedback form to your Web site's needs.
Minimize This Section Features of the Form Emailer Utility
The Form Emailer utility is a versatile program--it can be simple or complex, depending on what you want it to do for you. Configuring it can be as simple as enabling it in your member area, and adding a line to a form you want to use. Other features include:
  • No complicated configuration is necessary -- default settings can handle all HTML forms, if desired.
  • All features of the program are fully configurable and can be overriden with your own settings.
  • You to create multiple page forms and pass data from one page to the next.
  • A customizeable email message can be sent to you, your site visitors, or anyone else you want on completion of the form.
  • Customized "successful submission" and "error during submission" pages can be used.
  • Time stamp can be set to your time zone or any other around the world.
  • Data from the form can include the date and time the form was filled out, as well as other environmental variables.
  • You can require information to be entered for certain fields. When a field is left empty, a customized error message can be created for your visitor.
  • Form data can be organized and rearranged to any order you want in the emailed output or saved file.
  • The To:, From:, and Subject: fields can be customized in the email messages.
  • Form data can also be written to a file in database format and stored for later analysis offline, or for backup purposes.
Minimize This Section Instructions for Using the Form Emailer Utility
1. Enable the Form Emailer utility in your member area. You can enable or disable this feature in the "edit my account" section of the member area, or by clicking here. (Currently the Form Emailer is enabled.)

2. Create an HTML form. This will requires some knowledge of HTML, a pre-built form, or a tool to build forms. Your starting <form> tag will need it's action and method properties set as follows to use the Form Emailer: <form action="/cgi-bin/cgiemail" method="post">

This tag will cause information* submitted through the form to be delivered to the Form Emailer which will then send that information in an email to the email address associated with your account. (Currently that is: lazarusukogo@yahoo.com)

*When you create <input> tags, they must be named in order for the data to be passed to the utility, for example <input name="a" value="1"> will appear in the email as "a: 1".

Minimize This Section Advanced Options for Using the Form Emailer Utility
Virtually every feature of this utility can be customized through "hidden" <input> tags in your forms. The following list contains each of the property names and an example of their usage.
NAME=cgiemail_html tells the script which should be the next html page shown after the form is submitted. If a relative URL is used, (i.e. VALUE="/done.html", instead of VALUE="www.someplace.com/done.html"), then $variable replacements may be used on that page to fill in what your visitor typed on the previous page. This value should appear only once in a form. Here are a few examples of this property's usage: <input type="hidden" name="cgiemail_html" value="success.html"> or ... <input type="hidden" name="cgiemail_html" value="formpage2.html">
NAME=cgiemail_invalid sets the error message that your visitor will be shown if an invalid email addresses is entered (i.e., VALUE="You entered an invalid Email address"). This property should appear only once in each of your forms if you want to use it. Here are a few example: <input type="hidden" name="cgiemail_invalid" value="You entered an invalid email address"> or ... <input type="hidden" name="cgiemail_invalid" value="How can we reach you with that email address?">
NAME=cgiemail_required requires the visitor to enter information in any field(s) you specify. A customized message can be used for each missing field. (Note: Do not use the ";" character in the messages. This is a reserved character and it will cause your form not to work.) This property can be set for any field you want and therefore can appear as many times as you have control names in a form. Here are some examples: <input type="hidden" name="cgiemail_required" value="email:You forgot to enter your email address"> <input type="hidden" name="cgiemail_required" value="name:You forgot to enter your name"> <input type="hidden" name="cgiemail_required" value="address:You didn't enter your address"> (Note: In the second and third examples above, these "hidden" <input> controls imply that you have another <input> control for each of these names in your form. To extend the example, you must have two other controls between the <form> and </form> tags in your HTML form which are similar to "<input type=whatever name=name>" and "<input type=whatever name=address>". The second and third examples above simply tell the Form Emailer to check each of those controls to make sure they have not been left blank. They do not actually create the controls.)
NAME=cgiemail_message is the message file, including the headers and body of the email. $variable Replacements may be used, but they must be a relative URL (i.e., VALUE="message.txt"). This input may be used multiple times to send multiple email messages. If this file begins with ">/path/db.txt", then the contents of the rest of this file will be appended to /path/db.txt. Multiple tags can also be used. Here are some examples: <input type="hidden" name="cgiemail_message" value="receipt.txt"> <input type="hidden" name="cgiemail_message" value="order.txt"> <input type="hidden" name="cgiemail_message" value="database.txt">
NAME=delim_(name) overrides the default delimitor (",") on multi-valued inputs associated with name (i.e., VALUE="\n"). For examples, <input type="hidden" name="delim_product" value="\n">
NAME=cgiemail_timezone overrides the default timezone (GMT) for the message (i.e., VALUE="MST" or VALUE="US/Mountain"). For examples, <input type="hidden" name="cgiemail_timezone" value="MST">
NAME=cgiemail_order (This field is ignored if "cgiemail_message" is used.) This field sets the order for displaying fields (i.e., VALUE="name1:name2:name3"), as in the following example: <input type="hidden" name="cgiemail_order" value="email:address:name">
NAME=cgiemail_subject (This field is ignored if "cgiemail_message" is used.) This field is the "Subject:" for the email. (i.e., VALUE="WEB FEEDBACK"). For example, <input type="hidden" name="cgiemail_subject" value="Web Site Feedback Form">
NAME=cgiemail_username (This field is ignored if "cgiemail_message" is used.) This field is the "To:" for the email. (i.e., VALUE="webmaster"). For example, <input type="hidden" name="cgiemail_username" value="you@yourisp.com">
NAME=email must be a valid, formatted email address. (This field is ignored if "cgiemail_message" is used.) This field is the "From:" for the email. EXAMPLE HTML CODE: Enter your email: Examples VALUES for cgiemail_timeformat field: <input type="hidden" name="email" value="webform@yoursite.com">
NAME=cgiemail_timeformat overrides the default (EPOCH seconds) time format used to assign the special $TIME variable. This field is only used to customize the $TIME and has no other purpose. (You can include the $TIME variable on any page returned by the CGI and the time will be printed in its place). VALUE="%a %b %e %T %Z %Y" would appear: Fri Dec 23 10:10:42 EST 1988, VALUE="%A, %B %e, %Y %T" would appear: Friday, December 23, 1998 10:10:42, VALUE="DATE: %m/%d/%y%nTIME: %H:%M:%S" would appear: DATE: 12/23/98 TIME: 10:10:42 Output can be customized by using the following codes:
  • %% = a literal %
  • %n = a newline
  • %t = a horizontal tab
  • %H = hour (00..23)
  • %I = hour (01..12)
  • %k = hour ( 0..23)
  • %l = hour ( 1..12)
  • %M = minute (00..59)
  • %p = locale's AM or PM
  • %r = time, 12-hour (hh:mm:ss [AP]M)
  • %s = seconds since 1970-01-01 00:00:00 UTC (a nonstandard extension)
  • %S = second (00..61)
  • %T = time, 24-hour (hh:mm:ss)
  • %X = locale's time representation (%H:%M:%S)
  • %Z = time zone (i.e., EDT), or nothing if no time zone is determinable
  • %a = locale's abbreviated weekday name (Sun..Sat)
  • %A = locale's full weekday name, variable length (Sunday..Saturday)
  • %b = locale's abbreviated month name (Jan..Dec)
  • %B = locale's full month name, variable length (January..December)
  • %c = locale's date and time (Sat Nov 04 12:02:33 EST 1989)
  • %d = day of month (01..31)
  • %D = date (mm/dd/yy)
  • %h = same as %b
  • %j = day of year (001..366)
  • %m = month (01..12)
  • %U = week number of year with Sunday as first day of week (00..53)
  • %w = day of week (0..6) with 0 corresponding to Sunday
  • %W = week number of year with Monday as first day of week (00..53)
  • %x = locale's date representation (mm/dd/yy)
  • %y = last two digits of year (00..99)
  • %Y = year (1970...)
Example: <input type="hidden" name="cgiemail_timeformat" value="DATE: %m/%d/%y%nTIME: %H:%M:%S">
Minimize This Section Working Examples of Forms
Here are some working example forms using the Form Emailer. You can take these examples and adapt them for your own use if you want.
Very basic form -- this form shows the most basic configuration method, specifying only the location of the utility. There is no customization, only defaults are used.
Basic form -- this form shows most of the basic customization features, and includes a custom "success page" and "error page" which use $variable output.
Moderate form -- this form builds upon the basic form, but uses a customized email message (which also show the use of some special variables like $TIME and $HTTP_REFERER), overrides the delimeter values, and shows how the $TIME variable can be customized.
Complex form -- This form is a two-page form. Clicking next on the first form will take you to another form (where some of the input from form 1 is displayed from the $variables), and the data from both forms is submitted together. This form also sends multiple, customized email messages, AND saves the data to a database file.