CatalogCategoryListControl

CatalogCategoryListControl displays sibling categories and their item counts, including items in subcategories. It shows only categories that contain items and are approved for the current shopper’s View List.

CatalogCategoryListControl category list

Configurable properties

Property	Default	Valid values or format	Effect
`OverrideCategory_ID` Integer	`0`		Sets a category identifier to limit the listing to one category.
`PhotoWidth` Integer	`0`		Sets the category photo width.
`RepeatColumn` Integer	`0`		Sets the repeat column count.
`RepeatDirection` String	Empty string (`""`)		Sets the repeat direction.
`ShowAllChildCategories` Boolean	`true`	`true`, `false`	Controls display of all child categories.
`ShowCategoryItemCount` Boolean	`false`	`true`, `false`	Controls display of category item counts.
`ShowChildCategoryList` Boolean	`true`	`true`, `false`	Controls display of the child category list.
`ShowOnlyCategorieswithPhotos` Boolean	`false`	`true`, `false`	Controls whether only categories with photos are displayed.
`ShowOnlyChildSubCategories` Not specified	Not specified		Controls whether only child subcategories are displayed.
`ShowTopLevelCategories` Boolean	`false`	`true`, `false`	Controls display of top-level categories.
`SubCategoryPhotoWidth` Integer	`0`		Sets the subcategory photo width.
`SubCategoryShowPhoto` Boolean	`false`	`true`, `false`	Controls display of subcategory photos.

SitePages.config example

The following example loads CatalogCategoryListControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: RepeatDirection, ShowOnlyChildSubCategories.

<Control src="CatalogCategoryListControl.ascx"
         OverrideCategory_ID="0"
         PhotoWidth="0"
         RepeatColumn="0"
         ShowAllChildCategories="true"
         ShowCategoryItemCount="false"
         ShowChildCategoryList="true"
         ShowOnlyCategorieswithPhotos="false"
         ShowTopLevelCategories="false"
         SubCategoryPhotoWidth="0"
         SubCategoryShowPhoto="false" />

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

Inherited properties

CatalogCategoryListControl inherits listing behavior from ListingControl and shared conditions from CyberStoreBaseControl.