CatalogItemListButtonControl

CatalogItemListButtonControl gives shoppers a button for adding an item to one of their personal lists. It was introduced in v2.5.

CatalogItemListButtonControl personal-list action

Configurable properties

Property	Default	Valid values or format	Effect
`AccountListsLabelText` String	`"Your Account Lists"`		Sets the account-lists label.
`AddToListIconPath` String	`"~/images/stars-gray.png"`		Sets the add-to-list icon file path.
`AddToListLabelText` String	`"Add to List"`		Sets the add-to-list label.
`CustomerListsDisabledMessage` String	`"Please contact your account manager to request changes to items in your Company Lists."`		Sets the message shown when customer lists are disabled.
`CustomerListsLabelText` String	`"Your Company Lists"`		Sets the customer-lists label.
`Item_ID` Integer	`-1`		Sets the item identifier.
`ItemInListIconPath` String	`"~/images/stars.png"`		Sets the icon file path for an item already in a list.
`ItemInListLabelText` String	`"Saved in List"`		Sets the label for an item already in a list.
`ItemListPopUpHeaderLabelText` String	`" "`		Sets the item-list pop-up header label.
`ItemListPopUpHeaderTextColor` HTML Color	`"Black"`		Sets the item-list pop-up header text color.
`ItemListPopupHorizontalAlign` Not specified	Not specified		Sets the item-list pop-up horizontal alignment.
`ItemListPopupVerticalAlign` Not specified	Not specified		Sets the item-list pop-up vertical alignment.
`PopUpHighlightColor` HTML Color	`"#999"`		Sets the pop-up highlight color.
`ShowItemListButton` Boolean	`true`	`true`, `false`	Controls display of the item-list button.
`StockCode` String	Empty string (`""`)		Sets the item stock code.

SitePages.config example

The following example loads CatalogItemListButtonControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: ItemListPopupHorizontalAlign, ItemListPopupVerticalAlign, StockCode.

<Control src="CatalogItemListButtonControl.ascx"
         AccountListsLabelText="Your Account Lists"
         AddToListIconPath="~/images/stars-gray.png"
         AddToListLabelText="Add to List"
         CustomerListsDisabledMessage="Please contact your account manager to request changes to items in your Company Lists."
         CustomerListsLabelText="Your Company Lists"
         Item_ID="-1"
         ItemInListIconPath="~/images/stars.png"
         ItemInListLabelText="Saved in List"
         ItemListPopUpHeaderLabelText=" "
         ItemListPopUpHeaderTextColor="Black"
         PopUpHighlightColor="#999"
         ShowItemListButton="true" />

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

Inherited properties

CatalogItemListButtonControl inherits shared conditions from CyberStoreBaseControl.