Price by Quantity Threshold Fieldtype

Table of Contents

Overview

The CartThrob Price - Quantity fieldtype allows you to create multiple prices which depend on the quantity being added to the cart. This field type will show your default number format prefix (by default, $) as a prefix to your field.

CartThrob Price - Quantity

When an item is added to cart, the cost of the items in the cart will be adjusted based on the quantity.

Installation

  1. Go to the ExpressionEngine addons » fieldtypes settings
  2. Select this fieldtype
  3. Install
  4. Once installed, go to your products channel(s) field groups and add a new fieldtype
  5. Select this fieldtype and add it to the field group
  6. Set this fieldtype as your "price" field type in the CartThrob »products settings

Add a this fieldtype to your Products channel

Head to Admin > Channel Administration > Channel Fields to add this fieldtype to your Products channel, or create a separate channel for these products and add it to your CartThrob product channel settings.

Variables

YOUR_FIELD

If your field is named price, you can simply output the base price of the field using standard EE variable notation:

{price}

This will output a formatted number (eg. $10.00)

Variable Pair and Field Variables

You can also use the field as a variable pair to output the various price levels. The variable pair includes additional field-variables that are output between the variable pair, for example:

{your-price-field-name}
    {from_quantity}
    {up_to_quantity}
{/your-price-field-name}

from_quantity

The minimum number of items needed to meet this quantity threshold

{from_quantity}

up_to_quantity

The maximum number of items needed to meet this quantity threshold

{up_to_quantity}

price

The formatted price of the item including monetary prefix (eg. $10.00)

{price}

price_numeric

The non-formatted price of the item, excluding prefix, and other formatting (eg. 10)

{price_numeric}

price_plus_tax

The price with tax added on, including formatting (eg. $10.77)

{price_plus_tax}

price_plus_tax_numeric

The price with tax added on, not including formatting (eg. 10.77)

{price_plus_tax_numeric}

Examples

{price_by_quantity}
    {from_quantity}
        {price}
        {price_plus_tax}
        {price_numeric}
        {price_plus_tax_numeric}
    {up_to_quantity}
{/price_by_quantity}

Important note

This field accepts numeric values using "." (english standard) as the decimal point. Even if your locality normally uses "," as the separator between whole numbers and fractional amounts, you must use a "." as your separator when entering your price. On output CartThrob can convert this decimal point to any other separator, but on input, english standard decimals are required.