This document contains important information on how to get started using ClubMailer.

Download the ClubMailer Documentation here in PDF format (160k)

Table of Contents:

1) ClubMailer Admin Page
2) Steps To Get ClubMailer To Work
3) Component Fields
4) Build Your Own Forms
5) Your Own Required Fields
6) Support
7) Privacy Issues

1) ClubMailer Admin Page

The ClubMailer Admin Page is as important as the actual ClubMailer component. In the Admin Page you must register the form in your site in order to process the form through ClubMailer.

On the Admin Page, all you need to do is give the form a title (strictly for your own reference) and the full URL of the form in your site. If your form page can be accessed using other URLs (for example with and without "www.") then you should register other ClubMailers with the other options.

In the admin pages you can also delete old references to forms that no longer exist.

The URL to the admin page is http://club.coolmaps.com/clubmailer_admin.cfm

2) Steps To Get ClubMailer To Work

1. Create a form in 'Page View' in NetObjects Fusion
2. Add the ClubMailer component to the page
3. Configure the fields in the ClubMailer properties palette (see 3 below)
4. Publish
5. Go to the ClubMailer Admin Page and add the form.

3) Component Fields

1. Site Name - Title of site, eg. "coolmaps component club"
2. Form Name - Name of the form, eg. "Subscribe to mailing list"
3. Sender ID - Your unique SenderID that identifies your rights to send forms through our server, eg. "1234". Note: Your SenderID is given in the ClubMailer Admin Page.
4. # of Receipts - The number of people that will receive the form result. (limit is 5)
5. Recipient # x - The email addresses of the people that will receive the email result.
6. Sender - Your e-mail address (will be displayed in header of sent mail), eg. "anyone@anywhere.com"
7. Subject - This is what will be displayed in the 'subject' field of the mail sent to the recipients specified above.
8. FormResultURL - The result page where people get redirected upon successful form submission, eg. "http://www.anything.com/submit_done.html"
   You must give a compete (absolute) URL, including the "http://".
9. Send Confirm - Setting this to 'Yes' will send a confirmation email to the user submitting the form. The content of the return mail is written in the add form page in the admin section.
   Note: To use this feature your form MUST contain a field called email so that the end users can type in their email addresses.
10. CC Confirm - This option will be available if 'Send Confirm' is set to 'Yes'. Enabling this feature will cc all confirmation mails to the 'sender' specified above.

4) Build Your Own Forms

The ClubMailer form is no different from any other form built in NetObjects Fusion. Just regular form fields, DropDowns, Edit Fields, etc...

You can have any form fields in the page, however the field names can only contain letters, numbers and the underscore and they CANNOT contain blank spaces. Field names must also start with a letter.

There are certain names that should NOT be used for field names because they are reserved names used in Cold Fusion, the processing system for ClubMailer. A few examples are: order, url, query, user, request, and application. (All examples given are not case-sensitive, meaning it won't matter if you use capital letters instead of lower case letters.) The example list is by no means complete. If you receive a Cold Fusion error (or if certain fields are not processed) when using the form, you may need to change a field name.

Example fieldnames: "Your_Email", "TodaysDate", "Checkbox_1", "Dropdown2_Name"

5) Your Own Required Fields

You can force a field in your form to be required. For example, if your form has an 'email' field that the user must enter to complete submission, you simply add a hidden field containing the name of the field you wish to make required, followed by a "_required".

Example: You have a regular 'Forms Edit Field' called 'email'. You add a hidden field called 'email_required' and in 'Value' you add a message users will see if they leave the field blank. Your message could say: You must enter an email address!

Remember, form field names cannot contain spaces, only letters, numbers and the underscore.

6) Support

For support check out the ClubMailer Components Support page or mail support@coolmaps.com

7) Privacy Issues

The information sent by the ClubMailer service does not get looked at by anyone at Coolmaps.

The CCC does not capture the information that is sent by ClubMailer in any way. Our system just processes the information from form submissions and turns them into email to send on to the Club Member or the member's site visitor.

While email is not a secure medium, we do our best to ensure the privacy of the email and form information while it is in our control. Once the email has left our server we have no control over the privacy or security of the information.

While every effort is made to ensure the security and privacy of the information the Coolmaps Component Club will not be held responsible for any breach of privacy.

The CCC does reserve the right to monitor email and the use of our services to ensure that they are not being abused or used for malicious purposes.