This is archived CyberStore v2024.1 documentation. For current guidance, see the latest documentation.

ShoppingCartDisplayControl

ShoppingCartDisplayControl displays items in the shopper’s cart and lets them remove items or change quantities. When requested quantity exceeds available on-hand quantity, the control prompts the shopper to correct it. Items priced at zero must be removed before proceeding.

Shopping cart with item and action controls.

Configurable properties

Property Default Valid values or format Effect
ShowClearCartButton
Not specified		 Not specified   Controls whether the clear-cart action appears.
ShowContinueShoppingButton
Not specified		 Not specified   Controls whether the continue-shopping action appears.
ShowRecalculateButton
Not specified		 Not specified   Controls whether the recalculate action appears.
ShowCheckoutWhenPunchOutEnabled
Not specified		 Not specified   Controls checkout availability when PunchOut is enabled.
ClearCartButtonText
Not specified		 Not specified   Sets the clear-cart action label.
ContinueShoppingButtonText
Not specified		 Not specified   Sets the continue-shopping action label.
RecalculateButtonText
Not specified		 Not specified   Sets the recalculate action label.
SaveCartButtonText
Not specified		 Not specified   Sets the save-cart action label.
CheckoutButtonText
Not specified		 Not specified   Sets the checkout action label.
PunchOutButtonText
Not specified		 Not specified   Sets the PunchOut action label.
ContinueButtonUrl
Not specified		 Not specified   Overrides the continue-shopping destination.
ShowCustomerPrice
Not specified		 Not specified   Controls whether customer price appears.
ShowDefaultPrice
Not specified		 Not specified   Controls whether default price appears.
ShowDiscountPrice
Not specified		 Not specified   Controls whether discount price appears.
ShowUnitPrice
Not specified		 Not specified   Controls whether unit price appears.
ShowOnSaleGraphic
Not specified		 Not specified   Controls whether the on-sale graphic appears.
ShowDiscountMessage
Not specified		 Not specified   Controls whether the invoice-discount message appears.
ShowPersonalization
Not specified		 Not specified   Controls whether the personalization column appears.
CustomerPriceLabelText
Not specified		 Not specified   Sets the customer-price label.
DefaultPriceLabelText
Not specified		 Not specified   Sets the default-price label.
DiscountPriceLabelText
Not specified		 Not specified   Sets the discount-price label.
WebPriceLabelText
Not specified		 Not specified   Sets the web-price label.
DiscountMessageText
Not specified		 Not specified   Sets the invoice-discount message.
OnSaleGraphicPath
Not specified		 Not specified   Sets the on-sale graphic path.
BackOrderErrorColor
Not specified		 Not specified   Sets the back-order error color.
MinimumOrderValue
Not specified		 Not specified   Sets the required cart minimum.

SitePages.config example

The following example loads ShoppingCartDisplayControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: ShowClearCartButton, ShowContinueShoppingButton, ShowRecalculateButton, ShowCheckoutWhenPunchOutEnabled, ClearCartButtonText, ContinueShoppingButtonText, RecalculateButtonText, SaveCartButtonText, CheckoutButtonText, PunchOutButtonText, ContinueButtonUrl, ShowCustomerPrice, ShowDefaultPrice, ShowDiscountPrice, ShowUnitPrice, ShowOnSaleGraphic, ShowDiscountMessage, ShowPersonalization, CustomerPriceLabelText, DefaultPriceLabelText, DiscountPriceLabelText, WebPriceLabelText, DiscountMessageText, OnSaleGraphicPath, BackOrderErrorColor, MinimumOrderValue.

<Control src="ShoppingCartDisplayControl.ascx" />

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

Inherited properties

The control inherits shared visibility and shopper-access conditions from CyberStoreBaseControl.

Validate the control

  1. Add, remove, and change quantities for cart items.
  2. Request a quantity above on-hand availability and confirm the shopper is prompted to correct it.
  3. Confirm a zero-priced item cannot proceed until removed.