Work with portal navigation

 

Overview

This topic describes how to implement navigation in a portal theme. Before reading this topic, be familiar with the portal structure, the Page Customizer, and the Manage Pages portlet. You should also understand the underlying JSP structure of the portal

The themes that are shipped with WebSphere Portal provide buttons and other navigational aids to allow users to access screens (such as login, edit profile, home). Themes also provide navigation to nodes in the portal hierarchy of the home screen. The nodes in this hierarchy can be described by the number of levels below the content root in which they are placed. After installation, the portal themes include the following JSPs to provide access to the navigation hierarchy levels.

JSP file Navigation level Example nodes
ToolBarInclude.jsp 1 My Portal, Administration
PlaceBarInclude.jsp 2 Welcome page under My Portal
PageBarInclude.jsp 3 My Page, under Welcome
NavigationTreeInclude.jsp 4 and above Nodes created by administrators and users

Navigation levels are designated by the startLevel and stopLevel attributes of the <wps:navigation/> tag. The JSPs that are provided by WebSphere Portal do not provide access to all level 1 nodes. Therefore, nodes that are created directly under content root cannot be accessed unless a direct link is created using the <URLGeneration/> tag. The following topics provide further details and sample code for providing portal navigation.

The <wps:navigation/> tag is used to create the navigation menu. The content of this tag includes internal Java scriptlets that should not be modified. You can, however, customize the navigation by changing images, HTML and JSP tags, and the classes in Styles.css.

 

See also

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.