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.

Classica's width must be sufficient to show all your menu labels, and to show the right-most menu (and its submenus, if it has any). You can reduce the width required by reducing the size of the LabelFont.

Classica's height must be enough to display the tallest menu or submenu. (Classica will alter the vertical position of submenus, moving them upwards if the applet is too short to display them in their normal position.)

To avoid the trial-and-error of finding the best size, set the Testmode parameter to 'yes' and click anywhere inside the applet: the minimum width and 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.

BgColor
Sets the background color of the applet, with a default of FFFFFF (white). (Note that Classica can only change the background color after it has loaded. To have the same background color shown before the browser starts loading the applet, change the BgColor setting in the HTML code too.)

BgContent
Unless you're using Classica's transparency features and DHTML to cause menus to drop over HTML content, there must be a blank space below the menu bar where the menus will be shown. This space will be filled with your chosen BgColor. The BgContent parameter lets you choose a JPEG image or Flash .SWF movie to display in this space. For example, you could display your site logo here. Enter the absolute or relative URL of the file to display. The content you use here will not be scaled, tiled or resized. It will be placed at the left of the applet, immediately below the menu bar, but can be positioned elsewhere using the two parameters below.

Another option (in compatible browsers) is to make the applet Transparent and use Dynamic HTML to place it in the desired position on the page.

BgContentLeft
A number value which sets the horizontal position of the BgContent (if used). Negative values can be used by prefixing them with a - sign.

BgContentTop
A number value which sets the vertical position of the BgContent (if used), in relation to the bottom of the menu bar. Negative values can be used by prefixing them with a - sign.

DefaultIcon
If UseIcons is set to 'yes', this parameter specifies the absolute or relative URL of a JPEG or Flash image to use for any item that doesn't specify its own individual icon. If this parameter is left blank (and UseIcons is 'yes'), any item without an icon will have a blank space beside it. The icon images should be 12x12 pixels in size. Only non-progressive JPEG images are supported; to use GIF images, they must be converted to SWF format - see Image Support in Flash Applets.

DefaultTarget
Every Label and Item can link to a separate URL, and it can open it into a separate frame or window: we provide numbered Target parameters for that. However, you probably want most (or maybe all) the links to open into one particular frame. Enter the frame name in this parameter, and every item without its own Target parameter will open the link into this 'default' frame. You can also use the HTML names _self, _top, _parent, _blank or _new. If you leave this parameter out of your datafile, links will open into _self (the frame or window containing the applet).

Name
Specifies a name for this instance of the applet. This is only necessary if you are using the applet in conjunction with our free Satellite add-on, and it's explained in the documentation for Satellite, available from the Cool Focus web site. If you are not using Satellite with this applet, it's best not to include this parameter in your datafile (although nothing bad will happen if you do).

ShowLinkMessages
A choice of yes or no. If set to 'yes', any label or item that doesn't have a Message parameter will display the URL it links to in the browser's status bar. If set to 'no', no message will be displayed. The default is 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.

SoundItemHover
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse moves over a linking menu item. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundItemSelect
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse clicks a linking menu item. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundLabelHover
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse moves over a menu label. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

Testmode
A yes or no value, with a default of 'no'. This parameter is included in most Cool Focus Flash applets, and is used to help you determine the best width and 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.) Set this parameter to 'yes', then view the applet in your browser and click anywhere inside the applet. You'll see the minimum width and height displayed in a tooltip message, and you can copy these values 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: If you've specified a list of font names in the applet's font parameters, it's a good idea to check that the applet will be big enough whichever of those fonts is used: with Testmode set to 'yes', move each font name to the beginning of the list and refresh the page to see if Testmode reports that larger dimensions are needed.

Transparent
A yes or no parameter, with a default of no. If set to 'yes', the applet's background (the area below the menu bar) will be made transparent in compatible browsers, showing the HTML content (such as a page background) behind the applet. You must also change the word 'window' to 'transparent' in the HTML code for the applet.

TransparentMenuBar
A yes or no parameter, with a default of no. If set to 'yes', Classica's menu bar and the borders around its menus will be made transparent.

UseIcons
A choice of yes or no. If set to 'yes', Classica will reserve space for a 12x12-pixel icon image beside every menu-item and will load any icons specified in your Icon parameters. If set to 'no', images won't be loaded and no space will be reserved on the menus. The default is no.

MenuBarAutosize
A choice of yes or no. The default is no. If set to 'yes', the menu bar will autosize to the total width of the menu labels, and any extra space to the right of the bar will be filled with MenuBarBgColor. If set to 'no', the menu bar will extend to the full width of the applet.

MenuBarBgColor
Sets the color of the area to the right of the menu bar, visible only if MenuBarAutosize is set to 'yes'. The default is to match your chosen BgColor.

MenuBarColor
Sets the color of the menu bar (the strip at the top of the applet containing the menu labels). The default color is ECE9D8 (light tan).

LabelColor
Sets the text color of a menu label when not focused. The default is 000000 (black).

LabelFocusColor
Sets the text color of a menu label when the mouse moves over it, or its menu is open. The default is 000000 (black).

LabelFont
Sets the name, size and style of font to use for the menu labels, 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.

LabelIndent
Sets the number of pixels by which to indent the first menu label from the left of the applet. The default is 0 pixels.

LabelPressColor
Sets the text color of a linking menu label when clicked. The default is FFFFFF (white). (Note that if the label has a menu instead of being a link, clicking the label will close the menu but the label's text-color won't change.)

LabelSelectorBorderColor
Sets the border color of the menu labels' selection rectangle. The default is to match the MenuBorderColor.

LabelSelectorColor
Sets the fill color of the menu labels' selection rectangle. The default is F0EEE1 (light tan).

LabelsAsTabs
A choice of yes or no. The default is yes. If set to 'yes', menus are displayed in an Office XP tabbed style.

MenuBorderColor
Sets the color of the border around menus. The default is 8A867A (gray).

MenuColor
Sets the background color of menus. The default is FCFCFE (blue-white).

MenuOpacity
A value from 0 to 100 specifying the percentage opacity of menus. 0 is fully transparent, 100 is fully opaque. (This can be used to create some smart effects if BgContent is used, or if the applet is Transparent.) If this parameter is not included in your datafile, the value depends on your Transparent setting: a transparent applet will have transparent menus; an opaque applet will have opaque menus.

MenuShadow
A choice of yes or no according to whether you want menus and menu-label selectors to show a shadowed effect.

ItemColor
Sets the color of a menu item's text when not focused and not disabled. The default is 000000 (black).

ItemDisabledColor
Sets the text color of any menu items whose Disabled parameter is set to 'yes'. The default is 8A867A (gray).

ItemFocusColor
Sets the color of a menu item's text when the mouse is over it. The default is 000000 (black).

ItemFont
Sets the name, size and style of the font to use for menu items, with each part separated by commas. The default is Sans,8,plain. This parameter is constructed in exactly the same way as the LabelFont parameter.

ItemPressColor
Sets the color of a linking menu item's text when clicked. The default is 316AC5 (mid-blue).

ItemSelectorBorderColor
Sets the border color of the selection rectangle shown for menu items. The default is 316AC5 (mid-blue).

ItemSelectorColor
Sets the fill color of the selection rectangle shown for menu items. The default is BDCFEC (light blue).

SeparatorColor
Sets the color of any horizontal separator lines on the menus. The default is to match your chosen MenuBorderColor.

Labels
The four parameters below place menu labels onto the menu bar. These are arranged horizontally like an operating-system menu bar. A label can either act as a direct link to a web page (or some other resource) which is activated by clicking it, or it can open a menu by moving the mouse over it. If a label has associated items, its URL and Target parameters will be ignored.

You must include at least one Label parameter, or Classica will display nothing at all!

The parameters all have numbers after their names, and the numbers must be consecutive, starting from 1. If you want to show 5 menu labels, but you forget to include a Label4 parameter, Classica will stop looking for any more, and will only find labels 1 to 3.

Label1, Label2, ..., Label_n
These parameters specify the text you want Classica to display for each menu label. The labels will displayed in numerical order, starting from 1, and you can include as many labels as you like, limited only by the width of the applet.

URL1, URL2, ..., URL_n
The optional URL to which the Label with the same number should link when clicked. (If you want a Label to open a menu, its URL will be ignored and it will not act as a link.)

Target1, Target2, ..., Target_n
The name of the frame or window into which the URL with the same number should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.

Message1, Message2, ..., Message_n
An optional text message which will be displayed in the browser's status bar (in compatible browsers) when the mouse moves over the Label with the same number. If no Message is included, and this Label is a link, and ShowLinkMessages is set to 'yes', the URL that the label links to will be shown in the status bar.

Items
The parameters below create menus and submenus of items for each Label, which are shown when the mouse moves over a label. They are all prefixed with one or more numbers and hyphens (up to a maximum of 3 numbers and 3 hyphens) and have one number after their names. These numbers tell Classica which menu or submenu the item belongs to, and which position it takes on that menu. Classica supports 3 levels of menus (which is why you can place 3 numbers and hyphens before each item). Here's an explanation of the prefixes and suffix:

Suffix: The number that appears after the word Item (or URL, Target, Message, etc) denotes its position on the menu. So Item1 appears at the top of the menu, Item2 is below it, and so on.

Prefixes: The prefixes denote the item's parentage. For example, 1-2-3-Item4 means that if you hover the mouse over Label1 to open its menu, move to the second item on the menu to open its submenu, then move to the 3rd item on that submenu to open its submenu, you'll see this item 4th down.

1-Item1, 1-Item2, ..., 1-Item_n
These parameters specify the text you want Classica to display for each item. The items will displayed in numerical order, starting from 1, and you can include as many items on each menu as you like. To create a separator line, just enter a hyphen (-) as the text. (Separators cannot be links, and cannot have icons or messages, so don't include the parameters below for separator items.)

1-URL1, 1-URL2, ..., 1-URL_n
The optional URL to which the Item with the same numeric prefixes and suffix should link when clicked. To make items behave like links in all respects except linking somewhere (which can be useful for testing), use a dollar sign ($, or when encoded, %24) as the first character of the URL.

1-Target1, 1-Target2, ..., 1-Target_n
The name of the frame or window into which the URL with the same prefixes and suffix should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.

1-Message1, 1-Message2, ..., 1-Message_n
An optional text message which will be displayed in the browser's status bar (in compatible browsers) when the mouse moves over the Item with the same numeric prefixes and suffix. If no Message is included, and this item is a link, and ShowLinkMessages is set to 'yes', the URL that the item links to will be shown in the status bar.

1-Disabled1, 1-Disabled2, ..., 1-Disabled_n
This is a yes or no parameter which determines whether the item is disabled or not. The default is no (so that all items are enabled unless they have this parameter). This parameter can be useful if you want to build and publish your menu before the site is complete, showing users which content you will add later without letting them link to it yet. When you publish a page, just delete this parameter to make the link active. Disabled items have their text drawn in ItemDisabledColor and they ignore mouse clicks.

1-Icon1, 1-Icon2, ..., 1-Icon_n
This parameter is ignored if UseIcons is set to 'no' (its default value). This parameter lets you specify the absolute or relative URL of a 12x12-pixel image to use as the icon for this item. If you don't include this parameter for an item (and UseIcons is set to 'yes') the icon specified in the DefaultIcon parameter will be used. Note: Only non-progressive JPEG images are supported; to use GIF images, they must be converted to SWF format - see Image Support in Flash Applets.