How it is Displayed

Once you have decided which navigation links are going to be displayed (see what is Displayed) on each page, you have to decide on their presentation.

This is also achieved with parameters in the same navigation properties file as the six 'levels' parameters. The display darameters are:

StartNavigation and EndNavigation - This text is used to encapsulate the entire results of the navigation menu. If there are no navigation links to display these strings are not used.

IncreaseLevel and DecreaseLevel - This text is used to encapsulate navigation links sharing a parent.

MenuEntry - this text is used for every displayed navigation link. Two main replacement strings can be part of the text ##Link## (replaced by a url reference to the page concened) and ##Label## (the name of the page being linked to). For a full list of available ## replacement strings see Nav Replacements.

LabelOfRoot - By default the value of the ##Label## for the home page is "/" Using this parameter the home page label is replace to somthing more acceptable such as "Home".

LabelOfParent - by default, the label of the parent to the current page is simply the name of the parent page. For some navigation tasks it is more appropriate to use this parameter to change the label for this page to say "Up". LabelOfRoot takes precedence over LabelOfRoot.

WrapLevelStringsForTopEntries - by deafult the IncreaseLevel and DecreaseLevel Strings are not used on the top level entries displayed. Sometimes you formatting will require the IncreaseLevel and DecreseLevel strings around all navigaion links not just within sub-levels - if this is the case set this parameter to "true".

For example take the navigaion tree from the What is Displayed page and apply the followng navigation properties file:

StartNavigation = StartNavTest\r\n EndNavigation = EndNavTest\r\n IncreaseLevel = StartSubMenu\r\n DecreaseLevel = EndSubMenu\r\n MenuEntry = Entry For ##Label##\r\n LabelOfRoot = Home TopLevel = 0 BottomLevel = 999 TopDisplayIfParentOnPath = 999 BottomDisplayIfParentOnPath = 999 TopDisplayAll = 999 BottomDisplayAll = 999 WrapLevelStringsForTopEntries = false

Assumeing that the current page being processed is "MultiMedia" again the items in red will be displayed in the navigation.

Home Welcome
Products Electrical White Goods Freezers
Fridges
MultiMedia Hi-Fi's
TV's Plasma
CRT
DVD's
Gardening Fences
Tools
Contact Us

The text that is generated in the processed html file in replacement for the ##nav:navigationname## in the site template for the "MultiMedia" page is:

StartNavTest Entry For Home StartSubMenu Entry For Products StartSubMenu Entry For Electrical StartSubMenu Entry For MultiMedia StartSubMenu Entry For Hi-Fi's Entry For TV's StartSubMenu Entry For Plasma Entry For CRT EndSubMenu Entry For DVD's EndSubMenu EndSubMenu EndSubMenu EndSubMenu EndNavTest