Customizing the Mailbox Tool Bar

This section describes how to modify the mailbox tool bar shown in Figure 5–1.

Figure 5–1 Communications Express Mailbox Tool Bar

You can modify the following on the mailbox tool bar:

• Change the layout of the mailbox tool bar relative to the rest of the page

• Rearrange the order of tools

• Change the tools text

Customizing the Mailbox Tool Bar

To modify the mailbox tool bar, edit the appropriate files as follows:

• To customize the layout within the tool bar and the associated graphics, edit the getToolbar() function in the mbox_fs_lr.html file

• To customize the text associated with the graphics in the Tool Bar, edit the i18n[ ] values for get mail, compose, search, new search, file selected message, delete, undelete, and expunge in the lang/i18n.js file

The functions assigned by getToolbar() in mbox_fs_lr.html that handle the tool clicks are:

• Get Mail: main.refreshMbox()

• Compose: main.compose(”new”)

• Search: srch()

Example—Mailbox Tool Bar Modifications

Example 5–1 shows the necessary edits to be made in the file mbox_fs_lr.html to display “Search” as the first tool and changes the text of “Get Mail” tool to “Get Messages.

Example 5–1 Altered Tool Bar Layout (mbox_fs_lr.html)

function getToolbar() {
  if (!main.loaded) return '';
return nWMtoolbar(i18n['mbox search'], 'srch()',
           'search','imx/LrlSearchMsg_wo_1.gif','imx/LrlSearchMsg_1.gif') +
         nWMtoolbar(i18n['compose'], 'main.compose(\\'new\\')',
           'compose', 'imx/LrlNewMsg_wo_1.gif', 'imx/LrlNewMsg_1.gif') +
         nWMtoolbar(i18n['get mail'], 'main.check_mail = 1; 
							main.displaySpecialMbox(\\'Inbox\\')',
           'getmail', 'imx/LrlGetMail_wo_1.gif','imx/LrlGetMail_1.gif')+
         nWMtoolbar(i18n["collect long"], 'main.collect()',
           'collect', 'imx/LrlColExtMail_wo_1.gif', 
				'imx/LrlColExtMail_1.gif')+
}

            

Example 5–2 shows the necessary changes to be made in file en/i18n.js (text)

Example 5–2 Altering Tool Bar Text (en/i18n.js)

i18n[’get mail’] = ’Get Messages’