Share via


Adding toolbar buttons

Updated: April 8, 2010

Applies To: Unified Access Gateway

This topic describes how to add a button to the Forefront Unified Access Gateway (UAG) portal toolbar. When clicked, this button will open a new window.

To add a button to the portal toolbar

  1. On the Forefront UAG server, open the folder Microsoft Forefront Unified Access Gateway\von\PortalHomePage\Data\SiteMap\Toolbar. Copy the web.sitemap file to the ...\PortalHomePage\Data\SiteMap\Toolbar\CustomUpdate folder.

  2. In the CustomUpdate folder, open the web.sitemap file, and add a new sitemapNode to the file, as follows:

    <siteMapNode url="javascript:OpenNewPage()" 
    title="$Resources:Resource,102" 
    description="$Resources:Resource, 102" 
    imageUrl="~/images/ToolBar/home.gif" 
    displayMode="OnlyImage" 
    target="_self" 
    selectable="true"/>
    
  3. Set the sitemapNode values, as follows:

    • siteMapNode url—Change the JavaScript function name (OpenNewPage()) to any name you choose.

    • title and description—Change the resource number (102) to correspond to a string ID in the language files, located at PortalHomePage\Data\Languages.

      To add a new string, customize the language file, as described in Customizing text in the portal.

    • imageUrl—Change the path to point to the image that you want to use.

    • displayMode—Choose from three settings: OnlyImage to use an image, TextOnly to use text only, ImageAndText to use an image and text.

  4. Copy the file Standard.master from ...\PortalHomePage to the ...\PortalHomePage\CustomUpdate folder.

  5. In the ...\PortalHomePage\CustomUpdate folder, open the Standard.master file, then add the following code in the <head> tag:

    <script type="text/javascript">
        //<!--
            var contosoWin = null;
            function OpenNewPage()
            {
                var windowName = siteName + secure + "contoso";
                if (contosoWin)
                {
                    if(!contosoWin.closed)
                        contosoWin.focus();
                    else
                        contosoWin = openNewWindow("contoso.html", windowName, 720, 590, true, true);
                }
                else
                    contosoWin = openNewWindow("contoso.html ", windowName, 720, 590, true, true);
            }
        //-->
    </script>
    
  6. Replace contosoWin and "contoso" with a unique name.

  7. Replace "contoso.html" with the target URL.

  8. Replace the numbers 720, 590 with the width and height of the window.

  9. Save the file, and then reload the portal site from a client Web browser.

    The portal shows the new toolbar button.