Width & Height
The width and height of the applet are set in the HTML code you add to the web page. Be sure to change the dimensions in the <object> and the <embed> tags.

Mailman's width can be almost anything you want, as long as it's wide enough to display the required fields and their labels.

Mailman's height must be sufficient to display all the fields, which depends somewhat on your choice of fonts and font-sizes. As you increase the height beyond its minimum size, the Message area will increase in size. To find the minimum height (after selecting your fonts), set the Testmode parameter to 'yes' and click anywhere inside the applet: the height will be shown in a tooltip message. You can then edit the HTML code and set Testmode back to 'no'.

Parameters
The parameters below should be added to your datafile in the form NAME=VALUE (for instance, BgColor=FF0000). Each parameter should be on a separate line. You can leave blank lines in the list to organize the parameters into groups if you want to. The parameter names are not case-sensitive, and neither are the values, so BgColor=FF0000 is the same as bgcolor=ff0000. You can add the parameters to your file in any order. Most parameters have a default value which we show in bold text below: if you don't include the parameter in your datafile, the default value will be used automatically.

AddressMustContain
If you don't specify any Contacts, Mailman will display recipient name and address fields allowing messages to be sent to anyone from your web site. If you choose, you can pre-fill and lock the recipient fields to allow Mailman only to send to one address. Alternatively you can use this parameter to specify text that must appear in the recipient's email address. You can include any number of text items (case-insensitively), with each separated by a pipe symbol (|). For example:

AddressMustContain=@coolfocus.com|@cfisoft.com|@microsoft.com

AllowBlankMessage
A choice of yes or no according to whether the message area can be left blank when sending a message. The default is Yes for backward compatibility with earlier versions of Mailman. If set to 'no', the Send button will remain disabled until the message area contains text.

AllowBlankSubject
A choice of yes or no according to whether the subject field can be left blank when sending a message. The default is Yes for backward compatibility with earlier versions of Mailman. If set to 'no', the Send button will remain disabled until the Subject field contains text.

BgColor
Sets the background (fill) color of the applet, unless Transparent is set to Yes. The default is FFFFFF.

ButtonBorderColor
Sets the color of the borders around the Send Email and New Message buttons. The default is C0C0C0 (light gray).

ButtonBorderFocusColor
Sets the color of the borders around the Send Email or New Message button when the mouse moves over it. The default is C0C0C0 (light gray).

ButtonColor
Sets the fill color of the Send Email and New Message buttons. The default is EEEFF2 (very light blue-gray).

ButtonFocusColor
Sets the fill color of a button when the mouse moves over it. The default is DDDDDD (light gray).

ButtonFont
Sets the name, size and style of font to use for the text on the buttons, with each part separated by commas. The default is Sans,8,plain.

• Name: You can include any number of font names, separated by pipe symbols (|), and the applet will use the first font available on the user's system. To ensure compatibility, finish with one of these generic names: Sans, Serif or Typewriter.
  
• Size: The size of the font in points.
  
• Style: The style can be plain, bold, italic or bold-italic.

ButtonTextColor
Sets the color of the text on the Send Email and New Message buttons. The default is 000000 (black).

ButtonTextDisabledColor
Sets the color of the button-text when the button is disabled (not available). The default is A0A0A0 (gray).

ButtonTextFocusColor
Set the color of text on a button when the mouse moves over it. The default is 000000 (black).

ComboArrowColor
Sets the color of the arrow on the drop-down combo-box containing your Contacts. The default color is 000000 (black). (The combo is shown only if 2 or more Contacts are defined.)

ComboButtonColor
Sets the fill color of the arrow-box at the right of the drop-down combo-box containing your Contacts. The default is DDDDDD (light gray).

ComboSelectorColor
Sets the color of the selection bar shown when the mouse moves over items in the dropped-down list. The default is 446BD2 (blue).

ComboTextFocusColor
Sets the text color of an item in the dropped-down list when the mouse moves over it. The default is FFFFFF (white).

DefaultSenderName
Specifies the text to display in the Sender's Name field when Mailman starts, and when the New Message button is clicked. The default is to display nothing. See also: LockSender.

DefaultSenderEmail
Specifies the text to display in the Sender's Email Address field when Mailman starts, and when the New Message button is clicked. The default is to display nothing. See also: LockSender.

DefaultSubject
Specifies the text to display in the Subject field when Mailman starts, and when the New Message button is clicked. The default is to display nothing. See also: LockSubject.

Designmode
A choice of Yes or No, with a default of No. When setting up and testing Mailman on your local system, set this parameter to Yes. When you click the Send Email button, Mailman will not attempt to send the message, but will alternate between displaying the "Mail sent successfully" and "Mail could not be sent" messages. (It will also display the word "Designmode" in the titlebar caption as a reminder.) You can use this mode to test color choices and reactivity for the buttons and the result messages.

Remember to set the Designmode parameter back to No before publishing your datafile to your site.

FieldBgColor
Set the fill color of all the text, combo and message fields displayed in Mailman. The default is EEEFF2 (very light blue-gray).

FieldBorderColor
Sets the color of the borders around the text, combo and message fields. The default is C0C0C0 (light gray).

FieldFont
Sets the name, size and style of font to use for text typed or shown in the text, combo and message fields. The default is Sans,8,plain. This parameter is constructed in the same way as the ButtonFont.

FieldTextColor
Sets the color of all text typed or shown in the text, combo and message fields. The default is 000000 (black).

LabelFont
Sets the name, size and style of font to use for the text labels shown above Mailman's fields. The default is Sans,8,plain. This parameter is constructed in the same way as the ButtonFont.

LabelTextColor
Sets the color of the text used for the labels above Mailman's fields. The default is 000000 (black).

LockSender
A choice of Yes or No, with a default of No. If you have specified text for the DefaultSenderName and DefaultSenderEmail parameters, you can set this parameter to Yes to prevent users from changing these fields. The message will always appear to be sent by the name and address you specified. With this parameter left at No, users can change the sender name and address before sending. (If either the DefaultSenderName or DefaultSenderEmail is blank, this parameter is ignored.)

LockRecipient
A choice of Yes or No, with a default of No. If you specify one Contact, you can set this parameter to Yes ensuring that all email messages are sent to this contact; users will not be able to enter a different recipient name or address into Mailman's recipient fields. (This parameter is ignored if more than one Contact is defined.) If this parameter is set to No, the details of that single contact will be shown in Mailman's recipient fields, but users can replace them with a different name and address.

LockSubject
A choice of Yes or No, with a default of No. If you have specified text for the DefaultSubject parameter, you can set this parameter to Yes to prevent users from changing this field. The message will always have the subject line you specified. With this parameter left at No, users can change the subject line before sending. (If the DefaultSubject is blank, this parameter is ignored.)

Margin
Sets the width of the applet's inner margin (in pixels). This is a blank space between Mailman's fields and buttons and the edges of the applet. The default is 8 pixels.

ScriptURL
This parameter is vital for Mailman to send email. It must contain the absolute or relative URL of a script file which can receive the details sent by Mailman and initiate sending of an email message. Two scripts are provided with Mailman: mailman.asp (for use on Windows-based servers) and mailman.php (for UNIX-based servers). We recommend that you place the script file in the same directory as Mailman.swf and your datafile. This parameter then needs to contain just the name of the script file. If you place the script in a different directory (or if you write your own script) you must ensure that this parameter contains the correct URL. Relative URLs must be determined in relation to the location of the web page containing Mailman.

SendSuccessURL
This optional parameter allows you to specify the (absolute or relative) URL of a web page to be displayed when Mailman has successfully sent an email message. If this parameter is blank or missing, Mailman will display its own internal messagebox to notify the user.

SendSuccessTarget
An optional parameter to specify the name of the browser frame or window in which to display the SendSuccessURL web page. If blank or missing, "_self" will be used.

SendFailURL
This optional parameter allows you to specify the (absolute or relative) URL of a web page to be displayed if Mailman fails to send an email message. If this parameter is blank or missing, Mailman will display its own internal messagebox to notify the user.

SendFailTarget
An optional parameter to specify the name of the browser frame or window in which to display the SendFailURL web page. If blank or missing, "_self" will be used.

ShowBorder
A choice of Yes or No, specifying whether a border should be drawn around Mailman. The color of the border matches the TitlebarColor. The default is Yes.

ShowTitlebar
A choice of Yes or No, specifying whether Mailman's titlebar should be shown. The default is Yes. If set to No, the titlebar will be hidden (and all fields moved upwards accordingly), and the parameters TitlebarFont, TitleCaption, TitleIconURL and TitleTextColor will be ignored. Note that the TitlebarColor parameter is still used to draw a border around the applet if ShowBorder is set to Yes.

ShowVersion
A yes or no value. This parameter is included in all Cool Focus Flash applets, and its default is no. If set to 'yes', the version number of the applet (and other details) will be shown when the applet starts. This is included only for troubleshooting purposes, to help you determine which version of an applet you're using. It should be set to 'no' (or removed from your datafile) before you publish your page.

Testmode
A yes or no value, with a default of 'no'. This parameter is included in most Cool Focus Flash applets, and in Mailman it's used to help you determine the best height for the applet. (Because of this, it's best to use this parameter when you've got everything in the applet the way you want it, particularly fonts.) Set this parameter to 'yes', then view the applet in your browser and click anywhere inside the applet. You'll see the minimum height displayed in a tooltip message, and you can copy this value into the page's HTML code. When you're done, remember to set the Testmode parameter back to 'no' or delete it from your datafile. Note that this shows a suggested minimum height; make the applet taller to increase the height of the Message field.

TitlebarColor
Sets the fill color of the title-bar at the top of the applet. The default is 000080 (navy).

TitlebarFont
Sets the name, size and style of font to use for the TitleCaption at the top of the applet, with each part separated by commas. The default is Sans,8,plain. This parameter is constructed in the same way as ButtonFont.

TitleCaption
Sets the caption shown at the top of the applet. The default is Mailman. To display no caption text, include the TitleCaption parameter with nothing after its = sign.

TitleIconURL
Specifies the absolute or relative URL of an optional small image to use as an icon in Mailman's title bar. If used, this should be a non-progressive JPEG image, or an image converted to SWF format. It should be no more than about 16 pixels high. It can be as wide as you like, however: Mailman will place the caption to its right.

TitleTextColor
Sets the color of the TitleCaption text in Mailman's title-bar. The default is FFFFFF (white);

Transparent
A choice of yes or no according to whether you want the applet to be transparent, allowing the HTML background and/or content to be visible behind it. This parameter will only have an effect in compatible browsers. The default is no.

Language
The 14 parameters below specify the text displayed in Mailman for field labels, button captions and messages. You can usually leave these out of your datafile (as long as you're happy with the built-in English default text). However, these parameters let you specify text in a different language if required, or simply change any text item you don't like.

TxtSenderName
The text displayed as a label above the field for the sender's name. The default is Sender's Name:.

TxtSenderEmail
The text displayed as a label above the field for the sender's email address. The default is Sender's Email Address:.

TxtRecipientName
The text displayed as a label above the field for the recipient's name. The default is Recipient's Name:. (This field isn't shown if two or more Contacts are defined.)

TxtRecipientEmail
The text displayed as a label above the field for the recipient's email address. The default is Recipient's Email Address:. (This field isn't shown if two or more Contacts are defined.)

TxtSendTo
The text displayed as a label above the drop-down combo-box of contacts, if two or more Contacts are defined. The default is Send To:.

TxtSubject
The text displayed as a label above the subject field. The default is Subject:.

TxtMessage
The text displayed above the message-body field. The default is Message:.

TxtSendEmail
The text displayed on the Send button which sends the completed messgae. The default is Send Email.

TxtNewMessage
The text displayed on the New button which resets the fields for a new message. The default is New Message.

TxtSending
The text displayed alongside the caption in the title-bar to indicate that the message is being sent. The default is Sending....

TxtMailOKCaption
The text displayed in the caption of Mailman's small dialog after sending a message, indicating that it was sent successfully. The default is Message Sent.

TxtMailOKMsg
The text displayed in the body of Mailman's dialog if the message was sent successfully. The default is Your message was sent successfully..

TxtMailFailCaption
The text displayed in Mailman's dialog if the message could not be sent. The default is Message Failed.

TxtMailFailMsg
The text displayed the body of Mailman's dialog if the message could not be sent. The default is Your message could not be sent..

Contacts
The three parameters below specify contacts that users can send email to using Mailman.

• If you want to allow users to send email to whoever they choose, don't include these parameters. Mailman will then display Recipient's Name and Recipient's Email fields to let users type the details of the person they want to send mail to.

• If you want to restrict users to contacting just 1 email address, create just one contact using these parameters. To prevent users from changing these details before sending, you should also set the LockRecipient parameter to Yes.

• If you want to provide a choice of email addresses for users to contact, create two or more contacts using the parameters below. These will be presented in Mailman's drop-down combo-box, letting users choose one contact to send to. Users will not be able to send email to any other address from Mailman.

Note that the combo-box will contain the contacts in the numerical order of their parameter numbers.

Contact1, Contact2, ..., Contact_n
Specifies an 'alias' for the contact, such as "Support Team". This is the text shown in Mailman's combo-box. It is not sent in the email message.

Name1, Name2, ..., Name_n
Specifies the name of the person to whom the Contact parameter refers. If a user sends a message to this contact, this is the friendly name to whom the message will be sent.

Email1, Email2, ..., Email_n
Specifies the email address to whom the Contact parameter refers. If a user sends a message to this contact, this is the email address to which the message will be sent.