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.

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.