Adding/editing top links

Customizing Viewpoint > Customizing navigation components > Adding/editing top links

3.2.2 Adding/editing top links

You can specify the links that appear in the upper right corner of the Viewpoint header (for example, "Contact Us" and "Login/Logout"). Additionally, you can associate images with these links (for details, see Adding top link icons).

You can create top links by using the <top-link> element in the core.xml file.

<top-links>
    <top-link href='login?logout=true' target='thisWindow' label='Log out' />
</top-links>

Attributes and values for the <top-link> element are:

href- The href component works just like an HTML link. This can be a URL to an external source, or it can link to Viewpoint-specific functionality (for a list of Viewpoint page hrefs, see Viewpoint page URLs).
target - The target describes where the link should be opened. The possible values are:

Value	Description
thisWindow	Exits the Viewpoint Web application and displays the new page in the same window as the link.
newWindow	Opens the link in a new window.
subFrame	Displays the link's contents in the Viewpoint application panel.

label - The label attribute is the display name of the menu or item.

To add/edit a top link

Open the core.xml file located in the Viewpoint home directory.
Inside of the <navigation>'s <top-links> child element, insert <top-link>.
Set the required href attribute (for a list of Viewpoint page hrefs, see Viewpoint page URLs).
Specify the link's display name by using the label attribute.
Specify where the link opens by using the target attribute. It can be set to any of the following:
- thisWindow
- newWindow
- subFrame

For example:

<top-links>    
    <top-link href="login?logout=true" target="thisWindow" label="Logout" />
</top-links>

Restrict who may use the link by setting permissions (for details, see Filtering navigation with permissions). For example:

<top-links>
    <top-link href="login?logout=true" target="thisWindow" label="Logout">
        <permission name="nav.logout" />
    </top-link>
</top-links>

Only users with the support.helpRequest permission can view the Support link, and only users with the manage.VPCs permission can view the Manage page.