CatalogCategoryNavigationControl

CatalogCategoryNavigationControl displays approved categories filtered for the current shopper’s View List. It can display a text or drop-down menu and recognizes an item’s category on item-detail pages.

CatalogCategoryNavigationControl category navigation

Configurable properties

Property	Default	Valid values or format	Effect
`DropDownButtonText` String	`"Go"`		Sets the drop-down button text.
`DropDownFirstHintText` String	see LinkPage		Sets the first drop-down hint text.
`DropDownHintText` String	see LinkPage		Sets the drop-down hint text.
`DropDownMenuParentID` Integer	`-1`		Sets the drop-down menu parent identifier.
`ExpandTextMenuByDefault` Boolean	`false`	`true`, `false`	Controls expansion of the text menu when no category is set.
`FirstButtonHyperlinkPage` String	`"/ECommerce/CatalogSubCategoryDisplay.aspx"`		Sets the first button hyperlink page.
`FirstLinkPage` String	see LinkPage		Sets the first link page.
`HyperlinkPage` String	`"/ECommerce/CatalogSubCategoryDisplay.aspx"`		Sets the hyperlink page.
`LinkPage` String	`"CatalogSubCategoryDisplay.aspx"`		Sets the link page.
`MaxCategoryDepth` Integer	`99`		Sets the maximum category depth shown in the menu.
`MenuDisplayMode` String	Not specified		Selects the text or drop-down menu display mode.
`ShowOnlySiblingCategories` Boolean	`false`	`true`, `false`	Controls display of only the current category’s siblings in text mode.
`TieredPages` Boolean	`false`	`true`, `false`	Controls tiered pages.

SitePages.config example

The following example loads CatalogCategoryNavigationControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: DropDownFirstHintText, DropDownHintText, FirstLinkPage, MenuDisplayMode.

<Control src="CatalogCategoryNavigationControl.ascx"
         DropDownButtonText="Go"
         DropDownMenuParentID="-1"
         ExpandTextMenuByDefault="false"
         FirstButtonHyperlinkPage="/ECommerce/CatalogSubCategoryDisplay.aspx"
         HyperlinkPage="/ECommerce/CatalogSubCategoryDisplay.aspx"
         LinkPage="CatalogSubCategoryDisplay.aspx"
         MaxCategoryDepth="99"
         ShowOnlySiblingCategories="false"
         TieredPages="false" />

Add this <Control> element to the appropriate page placeholder as described in The SitePages.config File.

Inherited properties

CatalogCategoryNavigationControl inherits shared conditions from CyberStoreBaseControl.