Using Controls

CyberStore controls are configured in SitePages.config. A control can inherit shared behavior from a CyberStore base control and add configuration for its specific storefront or checkout purpose.

Configure a control

Use the control’s source file in the relevant SitePages.config entry, then add only the properties documented for that control or its direct CyberStore base.

<Control src="CatalogItemDetailControl.ascx" />

This guide does not define a universal control configuration template. Use the configuration structure already established for the target page, and validate each property in the active site.

For page and placeholder structure, see The SitePages.config File.

Apply inherited properties

Read a control’s direct base page before configuring its own properties:

• CyberStoreBaseControl documents shared visibility and shopper-access conditions.
• ItemControl documents item-type visibility conditions for controls that operate on one item.

Use each inherited property on its declaring base page as the reference. A concrete control page lists only behavior that belongs to that control.

Validate a configuration

After changing a control configuration:

1. Load the page that contains the control.
2. Test each configured condition using the applicable shopper state, item type, or checkout workflow.
3. Confirm that the control displays the intended content and that unrelated controls continue to render.
4. Review the page on desktop and mobile layouts when the control changes shopper-visible content.