ListingControl

ListingControl is the base control for child controls that list many catalog items or categories by category, search context, model, or another grouping.

Listing scope

Use the shared properties to control which categories and item types are included in a listing.

Property	Default	Valid values or format	Effect
IncludeItemsFromAllChildCategories Not specified	Not specified		Includes items from child categories when true; limits the listing to the current category when false.
IncludeModels Not specified	Not specified		Controls whether models are included.
IncludeSKUs Not specified	Not specified		Controls whether SKUs are included.
IncludeStockCodes Not specified	Not specified		Controls whether stock-code items are included.
OverrideCategoryList Not specified	Not specified		Uses the specified category list instead of the current category context.

Item-page visibility

Use these properties to control whether a listing appears on an item page for a specific item type.

Property	Default	Valid values or format	Effect
ShowOnStockCodeDetailPage Not specified	Not specified		Controls display on a stock-code detail page.
ShowOnModelDetailPage Not specified	Not specified		Controls display on a model detail page.
ShowOnSKUDetailPage Not specified	Not specified		Controls display on an SKU detail page.

SitePages.config example

The following example loads ListingControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: IncludeItemsFromAllChildCategories, IncludeModels, IncludeSKUs, IncludeStockCodes, OverrideCategoryList, ShowOnStockCodeDetailPage, ShowOnModelDetailPage, ShowOnSKUDetailPage.

<Control src="ListingControl.ascx" />

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

A child control can define additional properties beyond this shared base. The legacy source does not document defaults, supported combinations, or precedence for the listing properties.

Inherited properties

ListingControl inherits shared visibility and shopper-access conditions from CyberStoreBaseControl.

Validate the control

1. Configure a listing control for a category or search context.
2. Test the selected category scope and item-type inclusion settings.
3. Test the listing on stock-code, model, and SKU detail pages when those views are used.
4. Confirm the displayed items match the configured category and item-type rules.