Back to contents

Previous section                                                                                                                                                                             Next section

 

conf.xml SYSMENU tag

DeskAlerts allows only one button with a pop-up menu, but you can modify the menu by adding new items or submenus. The SYSMENU tag in the conf.xml file is as follows:

<SYSMENU name=”sysmenu” img=”0″ standby_img=”1″ disable_img=”2″ unreaded_img=”3″ offline_img=”4″>
<ITEM caption=”Options” command=”option” img=”11″/>
<ITEM caption=”History” command=”history” img=”13″/>
<SEPARATOR/>
<ITEM caption=”Update” command=”update” img=”10″/>
<ITEM caption=”Uninstall” command=”uninstall” img=”5″/>
<SEPARATOR/>
<ITEM caption=”Disable Alerts” pressed_caption=”Enable Alerts” pressed_img=”0″ img=”2″ command=”disable”/>
<ITEM caption=”Exit” command=”exit” img=”14″/>
</SYSMENU>

New items or submenus can be added to the button by following the pattern given above.

The numbers in the img attribute refer to the particular icons in the .bmp file that you have specified as the source for icons in the bitmap attribute of the ALERTS tag. For example, the deskalertsmenu button is represented by the first icon.

The command attribute of a button can refer to any command you have specified in the COMMANDS tag of conf.xml. For example, you could define a BROWSERJUMP command as

<BROWSERJUMP name=”search1″ filename=”http://www.google.com/” />

and reference it in an item:

<ITEM caption=”Google Search” command=”search1″ img=”12″/>

When a user clicks that button he or she will be redirected to the Google search page.

Image notes:

  • If you do not specify an image for a button you can sometimes get an awkward display. You can avoid this by specifying img=”-1″ for any button for which you want no image.
  • The image you specify should by 16×16 pixels. The pixel in the upper left corner of the image is considered to be the transparency color for the image.

conf.xml ITEM tag

Use the ITEM tag to populate a SYSMENU tag with options.

The tag format is:

<ITEM id=”itm_26″ caption=”The Alphabet” img=”10″ command=”command_name” />

Submenus

To create a submenu, nest ITEM tags inside an ITEM tag in the main menu. This example creates a submenu of book categories in a main menu item called “Books”, which has no HTML associated with itself:

<ITEM caption=”Order” img=”18″ command=”command1″>
<MENU>
<ITEM caption=”Books” img=”1″ hint=”” command=”command2″>
<ITEM caption=”History” img=”29″ hint=”History books” command=”command3″ />
<ITEM caption=”Science” img=”30″ hint=”Science books” command=”command4″ />
<ITEM caption=”Poetry” img=”31″ hint=”Poetry books” command=”command5″ />
</MENU>
</ITEM>

You can add an unlimited number of levels to a MENU, and an unlimited number of ITEMs to each level.

Invoking alerts

To configure the alert function you must have an ALERT tag within the COMMANDS tag in conf.xml. The tag will look something like this:

<ALERT name=”alert” history=”history” window=”alertwindow1″ filename=”%alert_url%”/>

The attributes:

  • history is the name of the command for storing history;
  • window is the name of the window where alert will placed;
  • filename is the URL of the alerts server script;

To configure the look of the alert window, add this line in the VIEWS tag:

<WINDOW name=”alertwindow1″ captionhref=”%root_path%\alertcaption.html” width=”500″ height=”400″ leftmargin=”5″ topmargin=”28″ rightmargin=”5″ bottommargin=”13″ confirmation=”1″ position=”right-bottom” transparency=”230″ transp_color=”00F0FF” customjs=”%root_path%\file.js”/>

  • captionhref is the html page that represents the border of the alert window where the logo, close button and other elements can be placed;
  • width, height specify size of the window;
  • leftmargin, topmargin, rightmargin, bottommargin specify margins for the inplace window where the alert or other html will be open;
  • transparency is a value of transparency for the window; 0 – transparent, 255 – non-transparent;
  • transp_color is a hex RGB value of color which will be absolute transparent (can be used for round corners);
  • customjs will upload file.js to the message body and call function Initial().

 

Previous section                                                                                                                                                                          Next section