Customizing Menus

  • Article

[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

You can customize the menus displayed to Communicator Web Access users by including custom menu items that link to other Web pages or applications used by your organization.

Note

The files containing any content used by a customized login page, tab, or menu, must be in a trusted location on the network.

To customize the menus

  1. If necessary, create the content that you want the Communicator Web Access custom menu item to link to, and then save that content to a location on your network that will be accessible to Communicator Web Access.

  2. Ensure that customized content complies with legal requirements, including copyright and trademark restrictions.

  3. On the computer running the Communicator Web Access server, use a text editor to open the CustomConfig.xml file in the <drive>:\Program Files\Microsoft Office Communications Server 2007 R2\Communicator Web Access\Server\CWA\Client folder.

  4. In the CustomConfig.xml file, the <menu> element uses the following schema:

    <menu active = ”false” title = “NewMenu”>
<menuitem>
<displayname>Contoso</displayname>
<url>https://contoso.com</url>
<accessibility>both</accessibility>
</menuitem>
</menu>

  5. Configure the following elements to customize the header and footer on the login page:

    Element Attribute Description Allowable Values

    menu

    Refers to the menu and menu items that can be customized in the contact list and conversation window menu bar.

    active

    Whether the menu will display custom menu items.

    TRUE, FALSE

    If TRUE, the menu will display custom menu items as configured.

    If FALSE, the menu will display only default menu items.

    menuitem

    Corresponds to one menu item in the parent drop-down menu.

    A minimum of 1 to a maximum of 15 <menuitem> attributes can be configured.

    displayname

    The name of the menu item to appear in the parent drop-down menu if the active attribute of the <menu> element is set to TRUE.

    Any alphanumeric string.

    url

    The URL to which the menu item should hyperlink.

    A UNC path or URL on your network.

    accessibility

    Whether the menu item should be displayed in the client used by internal users, external users, or both.

    INSIDE, OUTSIDE, BOTH

    If INSIDE, only users connecting to Communicator Web Access from inside the network will see the menu item.

    If OUTSIDE, only users connecting to Communicator Web Access from outside the network will see the menu item.

    If BOTH, all users connecting to Communicator Web Access will see the menu item.

  6. When you are finished, save and then close the CustomConfig.xml file.

  7. Click Start, and then click Run. In the Open box, type cmd, and then click OK.

  8. At the command prompt, type iisreset /restart to begin displaying the new content.