Community Toolbar

The "Dynamic_Menu" tag defines the external menu. The tags that the Dynamic_Menu may receive are described in the following table:

Tag	Description	Example
TYPE	Indicates the type of external menu	<TYPE>BUTTON_MENU</TYPE>
BUTTON	Adds a button to the external menu which receives all of the button’s tags	For the list of tags that Button receives, see Button below.
MENU	Adds a menu to the external menu which receives all of the menu’s tags	For the list of tags that Menu receives, see Menu below.
EXTERNAL_INTERVAL	Defines the frequency (in minutes) between the "refreshes" of the external menu (optional)	<EXTERNAL_INTERVAL> 60 </EXTERNAL_INTERVAL>

<DYNAMIC_MENU>
 <TYPE>BUTTON_MENU</TYPE>
 … </DYNAMIC_MENU>

The "Button" tag defines the external menu’s button which is displayed on the toolbar. Clicking on the button will display the external menu. The possible tags that the button may receive are described in the following table:

Tag	Description	Example
DEFAULT_BUTTON_TEXT	Text that appears on the menu button.	Menu Button Caption
BUTTON_ICON_URL	The URL containing the icon displayed on the button.
BUTTON_TOOLTIP	The text that appears when the mouse hovers over the button.	Button tooltip
WITH_DROPDOWN	Indicates whether to use a dropdown button or spitted button	<WITH_DROPDOWN> TRUE </WITH_DROPDOWN>

Example:

<BUTTON>
 <DEFAULT_BUTTON_TEXT>Menu Button Caption</DEFAULT_BUTTON_TEXT>
 <BUTTON_ICON_URL>http://www.conduit.com/ToolbarImagesDir/CT51752/1530494970group01.gif</BUTTON_ICON_URL>
 <BUTTON_TOOLTIP>Button tooltip</BUTTON_TOOLTIP>
 <WITH_DROPDOWN>TRUE</WITH_DROPDOWN>
 </BUTTON>

The "Menu" tag defines a list of items which are displayed on the external menu. You may create a sub-menu item by defining a menu within a menu. The possible tags that the menu may receive are described in the following table:

Tag	Description	Example
CAPTION	The text of the sub-menu entry	-
ICON_URL	The icon of the sub-menu’s entry	-
HINT	The tooltip for the menu item	-
MENU	Adds a sub-menu to the menu, which receives all of the menu’s tags (not an optional field)	-
MENU_ITEM	Defines a menu entry	See Menu Item below.

Example: Menu

<MENU>
 <CAPTION />
 <ICON_URL />
 <HINT />
 <MENU_ITEM>
 <CAPTION>First Menu Item</CAPTION>
 <DATA>
 <TYPE>LINK</TYPE>
 <LINK>
 <URL>http://www.conduit.com/</URL>
 </LINK>
 </DATA>
 </MENU_ITEM>
 </MENU>

Example: Sub-Menu

<MENU>
 <MENU_ITEM>
 … 
 </MENU_ITEM> 
 <MENU> 
 <CAPTION>Sub Menu 1 Caption</CAPTION> 
 <ICON_URL /> 
 <HINT /> 
 <MENU_ITEM> 
 <CAPTION>First Submenu Item</CAPTION> 
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <URL>http://www.conduit.com</URL> 
 </LINK> 
 </DATA> 
 </MENU_ITEM> 
 </MENU> 
 </MENU>

The "Menu_Item" tag defines an item which is displayed on the external menu. The tags that the Menu_Item may receive are described in the following table:

Tag	Description	Example
CAPTION	The text to display on the external menu.	First Menu Item
DATA	The type of data displayed for this menu item. Currently, this can only be a URL link.	http://www.conduit.com/
ICON_URL	The icon of this menu’s item.	-

Example:

<MENU_ITEM> 
 <CAPTION>First Menu Item</CAPTION> 
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <URL>http://www.conduit.com/</URL> 
 </LINK> 
 </DATA> 
 </MENU_ITEM>

The "Separator" tag adds a separator between menu items within the external menu.
Example:

<MENU>
 <MENU_ITEM> 
 … 
 </MENU_ITEM> 
 <SEPARATOR/> 
 <MENU_ITEM> 
 … 
 </MENU_ITEM> 
 </MENU>

The "Data" tag defines the data which is displayed within the menu. The tags that the Data may receive are described in the following table:

Tag	Description	Example
TYPE	The type of data which is displayed for this menu item	<TYPE>LINK</TYPE> OR <TYPE>POP_HTML</TYPE>
LINK	Link data type	See LINK
POP_HTML	Pop HTML data type launches a gadget from an external menu	See POP_HTML

Example: Menu

<MENU_ITEM>
 <CAPTION>First Menu Item</CAPTION> 
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <URL>http://www.conduit.com/</URL> 
 </LINK> 
 </DATA> 
 </MENU_ITEM>

The "Link" tag defines a link menu item. The tags that the Link may receive are described in the following table:

Tag	Description	Example
TARGET	Represents the way link will be opened	<TARGET>NEW</TARGET> open link in new window OR <TARGET>TAB</TARGET> Open link in new tab
URL	Link url	-

Example: Menu

<MENU_ITEM>
 <CAPTION>First Menu Item</CAPTION>
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <URL>http://www.conduit.com/</URL> 
 <TARGET>NEW</ TARGET > 
 </LINK> 
 </DATA> 
 </MENU_ITEM>

The "Pop HTML" tag defines a pop window gadget menu item. The tags that POP_HTML may receive are described in the following table:

Tag	Description	Example
URL	Link URL	http://www.conduit.com/
WIDTH	Width of the pop window (in pixels)	-
HEIGHT	Height of the pop window (in pixels)	-

Example: Menu

<MENU>
 <MENU_ITEM> 
 … 
 </MENU_ITEM> 
 <MENU> 
 <MENU_ITEM> 
 <CAPTION>Gadget Name</CAPTION> 
 <ICON_URL /> 
 <DATA> 
 <TYPE>POP_HTML</TYPE> 
 <POP_HTML> 
 <URL>http://www.conduit.com/</URL> 
 <WIDTH>250</WIDTH> 
 <HEIGHT>350</HEIGHT > 
 </POP_HTML> 
 </DATA> 
 </MENU_ITEM> 
 </MENU> 
 </MENU>

The image below contains an example of XML code used to create an external menu:

Example: Menu

<DYNAMIC_MENU>
 <TYPE>BUTTON_MENU</TYPE> 
 <BUTTON> 
 <DEFAULT_BUTTON_TEXT>ExternalMenu Sample </DEFAULT_BUTTON_TEXT> 
 <BUTTON_ICON_URL> http://www.conduit.com/BankImages/yes.gif </BUTTON_ICON_URL> 
 <BUTTON_TOOLTIP>ExternalMenu Sample Tooltip</BUTTON_TOOLTIP> 
 <WITH_DROPDOWN>TRUE</WITH_DROPDOWN> 
 </BUTTON> 
 <MENU> 
 <MENU_ITEM> 
 <CAPTION>DivX Web Player</CAPTION> 
 <ICON_URL> http://www.conduit.com/BankImages/tv.gif</ICON_URL> 
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <TARGET>NEW</TARGET> 
 <URL>http://download.divx.com/player/DivXWebPlayer.xpi</URL> 
 <TARGET>NEW</TARGET> 
 </LINK> 
 </DATA> 
 </MENU_ITEM> 
 <MENU> 
 <CAPTION>Sub Menu Title</CAPTION> 
 <ICON_URL>http://www.conduit.com/BankImages/yes.gif</ICON_URL> 
 <MENU_ITEM> 
 <CAPTION>Full Movie</CAPTION> 
 <ICON_URL>http://www.conduit.com/BankImages/yes.gif </ICON_URL> 
 <DATA> 
 <TYPE>LINK</TYPE> 
 <LINK> 
 <TARGET>NEW</TARGET> 
 <URL>http://www.tv-toolbar.com/tvdivx.php?source=http://divx-108.vo.llnwd.net/stage6vid/1136823.divx&player=flash</URL> 
 <TARGET>NEW</TARGET> 
 <TARGET>NEW</TARGET> 
 </LINK> 
 </DATA> 
 </MENU_ITEM> 
 <MENU_ITEM> 
 <CAPTION>Trophy</CAPTION> 
 <ICON_URL>http://www.conduit.com/BankImages/trophy.gif</ICON_URL> 
 <DATA> 
 <TYPE>POP_HTML</TYPE> 
 <POP_HTML> 
 <URL> http://www.labpixies.com/campaigns/tv/tv.html</URL> 
 <WIDTH>284</WIDTH> 
 <HEIGHT>280</HEIGHT> 
 </POP_HTML> 
 </DATA> 
 </MENU_ITEM> 
 </MENU> 
 </MENU> 
 </DYNAMIC_MENU>

Here’s how different forms of implementing the XML inside the external menu will affect the
appearance of it

In case you have…	You’ll get…
BUTTON with VALID DATA with NO MENU	A button with no dropdown handle. Clicking it will navigate to the link inside the DATA item.
BUTTON with VALID DATA and a VALID MENU	A button alongside a dropdown handle. Clicking the button will navigate to the link inside the DATA item, and clicking the dropdown handle (down-arrow) will open a drop-down menu.
BUTTON with NO DATA and a VALID MENU	A dropdown. Clicking it will open a drop-down menu.