PricingControl

PricingControl is the base control for child controls that display catalog prices. It extends ItemControl with shared pricing, add-to-cart, label, visibility, and style behavior.

Binding and behavior

Property	Default	Valid values or format	Effect
Item_ID Integer	Not specified		Identifies the item being priced.
StockCode String	Not specified		Identifies the item being priced.
AddToCartMinimumQuantity Integer	Not specified		Requires the minimum quantity before an item can be added to the cart.
SavingsMessageCalcBasis String	Not specified		Sets the basis used to calculate the savings message.
AddToCartGraphicPath String	Not specified		Specifies the graphic used for the add-to-cart action.
OnSaleGraphicPath String	Not specified		Specifies the graphic used for an on-sale indicator.
AddToCartMinimumRequired Not specified	Not specified		Gets or sets the add to cart minimum required.
CustomerPriceCSSClass String	Not specified		Gets or sets the customer price CSS class.
DefaultPriceCSSClass String	Not specified		Gets or sets the default price CSS class.
DiscountPriceCSSClass String	Not specified		Gets or sets the discount price CSS class.
DiscountText String	Not specified		Gets or sets the discount text. Obsolete . Use SavingsMessage instead.
ListPriceLabelText String	Not specified		Gets or sets the text of the “List Price Label”. Obsolete . Use DefaultPriceLabelText instead.
MinimumRequired Integer	Not specified		Gets or sets the minimum required. Obsolete . Use AddToCartMinimumQuantity instead.
OnSaleGraphicCSSClass String	Not specified		Gets or sets the on sale graphic CSS class.
QtyInputLabelText String	Not specified		Gets or sets the qty input label text. Introduced in v2.18.4 .
SalePriceLabelText String	Not specified		Gets or sets the text of the “Sale Price Label”. Obsolete . Use WebPriceLabelText instead.
SavingsMessageCSSClass String	Not specified		Gets or sets the savings message CSS class.
ShowQtyInputLabel Boolean	Not specified	true, false	Gets or sets a value indicating whether the qty input label is shown. Introduced in v2.18.4 .
ShowSalePrice Boolean	Not specified	true, false	Gets or sets a value indicating whether the “Sale Price” is shown. Obsolete . Use ShowWebPrice instead.
ShowYouSavedPrice Boolean	Not specified	true, false	Gets or sets a value indicating whether “You Saved Price” is shown. Obsolete . Use ShowSavingsMessage instead.
WebDiscountedCSSClass String	Not specified		Gets or sets the web discounted CSS class.
WebPriceCSSClass String	Not specified		Gets or sets the web price CSS class.
YourPriceLabelText String	Not specified		Gets or sets the text of the “Your Price Label”. Obsolete . Use CustomerPriceLabelText instead.
YouSavedLabelText String	Not specified		Gets or sets the text of the “You Saved Label”. Obsolete . Use SavingsMessageLabelText instead.

Visibility and labels

Property	Default	Valid values or format	Effect
ShowOnlyPricing Boolean	Not specified	true, false	Displays price information without other control elements.
ShowOnSaleGraphic Boolean	Not specified	true, false	Controls whether the on-sale graphic appears.
ShowPricePerUnit Boolean	Not specified	true, false	Controls whether price per unit appears.
ShowSavingsMessage Boolean	Not specified	true, false	Controls whether the savings message appears.
ShowUOM Boolean	Not specified	true, false	Controls whether the unit of measure appears.
ShowWebPrice Boolean	Not specified	true, false	Controls whether the web price appears before the cart.
AddToCartButtonText String	Not specified		Sets the add-to-cart button text.
DefaultPriceLabelText String	Not specified		Sets the default-price label.
CustomerPriceLabelText String	Not specified		Sets the customer-price label.
DiscountPriceLabelText String	Not specified		Sets the discount-price label.
WebPriceLabelText String	Not specified		Sets the web-price label.
SavingsMessageLabelText String	Not specified		Sets the savings-message label.
SavingsMessage String	Not specified		Sets the savings message.
PricePerUnitDisplayText String	Not specified		Sets the price-per-unit display text.

SitePages.config example

The following example loads PricingControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: Item_ID, StockCode, AddToCartMinimumQuantity, SavingsMessageCalcBasis, AddToCartGraphicPath, OnSaleGraphicPath, AddToCartMinimumRequired, CustomerPriceCSSClass, DefaultPriceCSSClass, DiscountPriceCSSClass, DiscountText, ListPriceLabelText, MinimumRequired, OnSaleGraphicCSSClass, QtyInputLabelText, SalePriceLabelText, SavingsMessageCSSClass, ShowQtyInputLabel, ShowSalePrice, ShowYouSavedPrice, WebDiscountedCSSClass, WebPriceCSSClass, YourPriceLabelText, YouSavedLabelText, ShowOnlyPricing, ShowOnSaleGraphic, ShowPricePerUnit, ShowSavingsMessage, ShowUOM, ShowWebPrice, AddToCartButtonText, DefaultPriceLabelText, CustomerPriceLabelText, DiscountPriceLabelText, WebPriceLabelText, SavingsMessageLabelText, SavingsMessage, PricePerUnitDisplayText.

<Control src="PricingControl.ascx" />

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

Style properties

DefaultPriceCSSClass, CustomerPriceCSSClass, DiscountPriceCSSClass, OnSaleGraphicCSSClass, WebPriceCSSClass, and WebDiscountedCSSClass add CSS classes to their corresponding pricing elements.

The legacy source does not establish defaults or supported combinations for these properties. Use only values supported by the configured pricing control and site theme.

Inherited properties

PricingControl inherits item-type visibility conditions from ItemControl and shared visibility and shopper-access conditions from CyberStoreBaseControl.

Validate the control

1. Configure a pricing child control for an item with the relevant price types.
2. Confirm the configured price labels, visibility settings, and savings-message basis.
3. Test the minimum quantity before adding the item to the cart.
4. Confirm configured graphics and CSS classes resolve in the target site theme.