Gentics Navigation Portlet Documentation

Here you can find documentation about the Gentics Navigation Portlet


Gentics Navigation Portlet

Overview

The Gentics Navigation Portlet is able to display a structured form of the folders from the Gentics Content.Node System.
With a velocity template the behaviour and look and feel of the portlet can be configured.

Configuration

Configuration file is located in the portletsuite-config module at:

\src\main\resources\config\rest\navigation{instanceNumber}.properties

The main part of the config are parameters for the Content Connector RequestProcessor of the portlet. You can find documentation for that in the Content Connector Wiki

Parameters in the properties file
Parameter Type Description
startfolder String This is the contentId of the startfolder of the Navigation portlet instance. If there is no contentId set by clicking a link or a menu element, the portlet will display this content, e.g. on the first access to a portal page.
templatepath String This is the path to the velocity template file this portlet instance should use.
The template file can be anywhere on the server but it recommended to store it in the configuration folder.
rootattribute String With this parameter you can define an attribute that should be read from the main content page (displayed by the content portlet) in order to switch the navigation tree from one node to another. With this functionality it is possible to display a specific navigation for every content page.
The navigation instance will allways check for an appended root attribute if it is set.
Note: in order to publish those attributes correctly into the content repository there has to be a correct entry in the Gentics Content.Node tag map system.
attributes String With this parameter there can be defined a custom list of comma separated attributes that should be obtained from the navigation objects fetched by the Content Connector. When you specify an attribute here you can access it in the navigation template via $nav.object.{attributename}.
Note: in order to publish those attributes correctly into the content repository there has to be a correct entry in the Gentics Content.Node tag map system.

If you are changing the configuration dont forget to rebuild it and eventually redeploy it to your server as described in the setup guide.

Architecture

Javadocs for Class: BaseNavigationPortlet