CoolCart.Net
Professional Edition
 
Help Desk
HTML Element Reference

CoolCart.Net works by interpretting special HTML tags embedded in your own web pages. The following list the HTML element names that have special meaning to CoolCart.Net.

Quick Index
ID Describe Qty QtyMin QtyMax QtyMultiples Price
Multi Size Color AddOn NAddOn DiscStr DiscItem
TaxItem Ship S2 Weight Show ShipAllowed ReturnLink
Related SKU SKU_Rule        
Element Name  Description
ID   "ID" is required. This is the identifier of the item. It can be the Model Number or any Identifier for the item. Each ID must be unique for the cart engine to identify each product. ID values can be hidden from the customer via the Profile Manager so they need not be long, descriptive names, etc. The maximum allowed size for an ID value is 30 characters. Values should contain just enough information to uniquely identify each of your products such as the products part number.
Ex. PART-201-A, PART-201-B, etc.:

<input Type="hidden" Name="ID" Value="PART-201-A">

Tip - Do not use quote marks (") or within the Value unless the value is enclosed in a single quote ('). Otherwise, your html will be improperly formatted. For example:

Don't use:

<input type="hidden" Name="ID" Value="36" TV">

Try:

<input type="hidden" Name="ID" Value="36 inch TV">
or
<input type="hidden" Name="ID" Value='36" TV'>

Tip - Use the "Describe" tag (below) to specify long, descriptive text for the product. Uncheck the "Always Show ID" box on the "Display" screen of the Profile Manager to hide the ID value from the web receipt (e-mail receipts always show the ID).
Top

Describe   "Describe" is optional and will describe the Product. This value will be displayed to the user in their basket.
<input Type="hidden" Name="Describe" Value="Deluxe Sparkling Widget">

You can also optionally include an image in the "Describe" field by referencing the URL of the image and it's height and width attributes. To specify an image for the item, use the ^ character to separate the description from the image URL. The image URL must be an absolute URL (i.e. - it must begin with http:// or https://) since the image resides on your web server. The syntax for including an image is:

"description^image_url^height^width"

The height and width parameters are also optional so you can either explicitly specify the image size or let the browser use the actual size of the image. An example would be:

<input type="hidden" name="Describe"
value="Production Description^http://www.yourcompany.com/images/widget.gif^60^80">


Or, if you don't want to have a text description and only want to display the image as its actual size, use:

<input type="hidden" name="Describe"
value="^http://www.yourcompany.com/images/widget.gif">


Note - Once the cart has been posted to the server, the cart will automatically switch to HTTPS mode when recalculating and some browsers (like Internet Explorer 6.0) will prompt the user that the page contains both secure and un-secure elements. This is not a problem but it could be an annoyance to the shopper unless their browser is configured to allow mixed content.

Top

Qty   "Qty" is optional and will contain the default quantity for the item. If a "Qty" element is not provided or is not a positive integer value, the cart engine will default to "1" for new items. Therefore, you only need it if your default quantity is different than 1.

Like all fields, you can provide "Qty" as a hidden field or as an input field. Here is an example of a hidden field that would override the default to order by the dozen:
<input Type="hidden" Name="Qty" Value="12">

Alternatively, you could use "Qty" as an input box to allow users to order any number that they desire. Here is the input field code:
<input Type="text" Size="3" Name="Qty" Value="">
which would create this

Tip - Use the QtyMin, QtyMax, and QtyMultiples tags to further define values that the user is allowed to order.

Tip - The cart remembers the quantity of each item ordered. If the cart captures a quantity and later the user presses the submit button for the same item, it will keep the previous value unless the user explicitly enters a new number. This is to prevent shoppers from accidently changing their quantities after entering them.


Working Example

Top

QtyMin   "QtyMin" is an optional value that will not allow the cart to check out if the "Qty" value is less than this value. If QtyMin is not specified or a non-numeric value, no minimum check is applied.

Here is an example of a hidden field "QtyMin" value of "10":
<input Type="hidden" Name="QtyMin" Value="10">

Working Example

The following example shows how to use the "QtyMin", "QtyMax" and "QtyMultiples" to enforce the quantity to be between 25 and 100 in multiples of 5.

<input Type="hidden" Name="QtyMin" Value="25">
<input Type="hidden" Name="QtyMax" Value="100">
<input Type="hidden" Name="QtyMultiples" Value="5">


Please note that the QtyMin value is only checked when the user has submitted the item to the cart server. You would need to add Javascript code in your web page to restrict the Qty value in the client's browser prior to submitting the item.

Tip - Click here for using advanced modifier options for setting a "QtyMin" value.

Top

QtyMax   "QtyMax" is an optional value that will not allow the cart to check out if the "Qty" value is greater than this value. If QtyMax is not specified or a non-numeric value, no maximum quantity check is applied.

Here is an example of a hidden field "QtyMax" value of "100":
<input Type="hidden" Name="QtyMax" Value="100">

Working Example

Please note that the QtyMax value is only checked when the user has submitted the item to the cart server. You would need to add Javascript code in your web page to restrict the Qty value in the client's browser prior to submitting the item.

Tip - Click here for using advanced modifier options for setting a "QtyMax" value.
Top

QtyMultiples   "QtyMultiples" is an optional value that will not allow the cart to check out if the "Qty" value is not a multiple of this value. If QtyMultiples is not specified or a non-numeric value, no multiple check is applied.

Here is an example of a hidden field "QtyMultiples" value of "5":
<input Type="hidden" Name="QtyMultiples" Value="5">

Working Example

Please note that the QtyMultiples value is only checked when the user has submitted the item to the cart server. You would need to add Javascript code in your web page to restrict the Qty value in the client's browser prior to submitting the item.

Tip - Click here for using advanced modifier options for setting a "QtyMultiples" value.
Top

Price   "Price" is optional and specifies the unit price of the item. If not specified or a non-numeric value, then the price will be set to zero for that item.
<input type="hidden" Name="Price" Value="49.50">

Sometimes you may want to leave the price at zero and use the "AddOn", "NAddOn", "Size", or "Color" tags to determine the price.

Top

Multi   "Multi" is an optional value that can be used if you want to allow the same item to be added to the cart more then one time based on different options like color, size, addons, etc.

"Multi" supports two values "Y" for yes and "N" for no. These values are not case sensitive, so "Y" and "y" are equivalent, as are "N" and "n".

When set to "Y", the shopper can select the same item multiple times with different options, such as 2 large red, 3 small green, and 5 medium blue items.

When set to "N" or not specified, the cart will overwrite the item based on its ID value.
<input type="hidden" Name="Multi" Value="Y">

Top

Size   "Size" is an optional value. You have the option to add additional charges for each size if you wish using the format "value^price". For example, if you wanted to include an additional price for large and extra large sizes, you would use the "Price" element to set the base price and then use the following to modify the price according to the size selected:
<input type="hidden" Name="Price" Value="19.95">

<select name="Size">
  <option value="Small">Small
  <option value="Medium">Medium
  <option value="Large^1.00">Large - Add $2.00
  <option value="X-Large^2.00">X-Large - Add $4.00
</select>


An equivalent method would let the "Size" dropdown determine the entire price by not defining a base price and adding a ^price modifier to each item in the dropdown list, such as:
<input type="hidden" Name="Price" Value="0">

<select name="Size">
  <option value="Small^19.95">Small - $19.95
  <option value="Medium^19.95">Medium - $19.95
  <option value="Large^21.95">Large - $21.95
  <option value="X-Large^23.95">X-Large - $23.95
</select>


Note - Price modifiers must be numeric values. Also, if "Multi" is set to "Y" then the cart will keep adding items to the cart of different combinations, allowing the user to order a Small, two Mediums, and an X-Large, etc.

Tip - Click here for advanced Size modifier options.

Top

Color   "Color" is an optional value. You have the option to add additional charges for each color if you wish using the format "value^price". For example, if you wanted to modify the base price for different colors in a dropdown list, you would use the "Price" element to set the base price and then use the following to modify the price according to the color selected:
<input type="hidden" Name="Price" Value="12.50">

<select name="Color">
  <option value="White">White
  <option value="Purple^1.00">Purple - Add $1.00
  <option value="Orange^2.00">Orange - Add $2.00
  <option value="Gold^3.00">Gold - Add $3.00
</select>


An equivalent method would let the "Color" dropdown determine the entire price by not defining a base price and adding a ^price modifier to each item in the dropdown list, such as:
<input type="hidden" Name="Price" Value="0">

<select name="Color">
  <option value="White^12.50">White
  <option value="Purple^13.50">Purple - Add $1.00
  <option value="Orange^14.50">Orange - Add $2.00
  <option value="Gold^15.50">Gold - Add $3.00
</select>


Note - Price modifiers must be numeric values. Also, if "Multi" is set to "Y" then the cart will keep adding items to the cart of different combinations, allowing the user to order a White item, three Purple items, etc.

Tip - Click here for advanced Color modifier options

Top

AddOn1  
to        
AddOn15  
The AddOn values give you the ability to add more options and extra charges if you wish. They behave similiar to "Color" and "Size" but you can define the type of modifier that meets your product line needs. For example,
<select name="AddOn1">
  <option value="Model - Base">Base Model
  <option value="Model - Deluxe^25.00">Deluxe Version - Add $25.00
  <option value="Model - Premium^50.00">Premium Version - Add $50.00
</select>


Note - Price modifiers must be numeric values. Also, if "Multi" is set to "Y" then the cart will keep adding items to the cart of different combinations, allowing the user to order a Base Model, two Deluxe Versions, etc.

Tip - Click here for advanced AddOn modifier options

Top

NAddOn1  
to        
NAddOn4  

NAddOns are "No Multi AddOn's". These will prevent another item from being added to the cart if these options are already selected. For example, to allow the user to select multiple items and optionally include an additional instructional video, use:
<input name="NAddOn1" type="checkbox" value="Learning Video^5.00">With Learning Video Tape - Add $5.00

Note - Multi=N will always overwrite the item in the cart no matter which options they choose.

Tip - Click here for advanced NAddOn modifier options
Top

DiscStr   Using "DiscStr", you can build price breaks on each product based on quantity purchased.

"DiscStr" works by creating a hidden variable that lists the quantity and price breaks using the format min,max,price. For example:
<input type="hidden" name="DiscStr" value="1,5,10.95;6,10,8.95;11,20,5.95;21,100,2.95">
The above example would mean:
  1 - 5 for $10.95
  6 - 10 for $8.95
  11 - 20 for $5.95
  Over 20 for $2.95

The last qty number is 100. This can be any number because if it's not on the table, it will use the last price it finds. It will use 2.95 for any quantity 21 and over in this example.

Tip - You can define global discounts for your products in the Profile Manager under Global Discounts.

Top

DiscItem   By default, any discounts and/or coupons will be applied to all items that the shopper adds to their cart. Use "DiscItem" if you want to exclude specific items from being discounted. "DiscItem" is an optional value and supports two values - "Y" for yes and "N" for no. These values are not case sensitive, so "Y" and "y" are equivalent, as are "N" and "n".

When set to "Y" or not specified, the item will be included when determining any global or coupon discount amounts.

If set to "N" then the item will not be discounted.
<input type="hidden" name="DiscItem" value="N">

Tip - Use the "Global Discount" section of the Profile Manager to define global discounts that are valid for your products.

Tip - Use the "Coupon" section of the Profile Manager to create coupons that can be used by your shoppers.
Top

TaxItem   "TaxItem" is an optional value used to determine whether sales tax should be applied to this item.

"TaxItem" supports two values "Y" for yes and "N" for no. These values are not case sensitive, so "Y" and "y" are equivalent, as are "N" and "n".

When set to "Y" or not specified, sales tax will be added to the item if a purchase is made within a Tax Regions defined in the Profile Manager under "Taxes".

If set to "N" then the item will not be charged sales tax. You can mix taxable and non-taxable items in one basket and the system will calculate accurately for you.
<input type="hidden" name="TaxItem" value="N">
Top

Ship   "Ship" is an optional value that contains the shipping price of the item when your Profile Manager Shipping Option section has specified the Shipping Method to be "By Region". The value is usually a numeric dollar amount based on a per item calculation.
<input type="hidden" name="Ship" value="3.00">


However, if you want to define free shipping for an item, you can set the value to "x".
Shipping Region Description:
When your Shipping Method is "By Region", you define various "regions" in the Profile Manager under the Shipping Options, Shipping Regions menu item. A region may be a type of shipping method (such as UPS Ground) or a geographical location (such as "U.S. lower 48" or "Internet").

Each defined region contains a Primary Minimum, Primary Multiplier, Secondary Minimum and Secondary Multipiler value. When the shopper selects a "region" during checkout, the "Ship" value for the item is compared to the region table to calculate the price.

Example: Let's say that you create a region called "U.S." and the primary multipler is 1. When a product has a <input type="hidden" name="Ship" value="3.00">, CoolCart will calculate the shipping as 3.00 x 1 X 1 = $3.00 for this region ("Ship" value x qty * multipler). If the shopper ordered 5 items, the cost would be $15.00 - 3.00 x 5 x 1. If the calculated cost is less than the minimum, the minimum is used.

Now, let's say you have a "Canada" region with a 1.5 primary multiplier. If the shopper selects the "Canada" region, for the same item, the shipping rate would be calculated $3.00 X 1 x 1.5 = $4.50. If this shopper orders five items for the Canada region, the cost would be $22.50 or $3.00 x 5 x 1.5.

This allows you to create precise and customized shipping rates very easily on a product-by-product basis. The Secondary Minimum and Secondary Multiplier work the same way as the Primary values but are only used for products using <input type="hidden" name="S2" value="Y"> elements (see S2 for details). This allows granular shipping rates for the Shipping Regions method.

Tip - Click here for using advanced modifier options for setting a "Ship" value.
Top

S2   "S2" extends the Ship tag by instructing CoolCart to a region's Secondary Minimum and Secondary Multipler values when the Shipping Method is "By Region".

"S2" supports two values "Y" for yes and "N" for no. These values are not case sensitive, so "Y" and "y" are equivalent, as are "N" and "n".

When set to "N" or not specified, the "Ship" value will be calculated using the Primary Minimum and Multipler.

If set to "Y", the "Ship" value will be calculated using the Secondary Minimum and Multipler.
<input type="hidden" name="S2" value="Y">

Tip - "S2" should always be used with an accompanying "Ship" value, otherwise only the Secondary Minimum price will be used.
Top

Weight   "Weight" is an optional value that is used when the Profile Manager Shipping Option section has specified the Shipping Method to be "By Price", "By Qty", or "UPS". Weight contains the weight of the item. Do NOT include any unit of measurement indicator such as "lb", "oz", etc. Only numeric values will be applied. Weight values are used differently when the Shipping Method is set to UPS, USPS, FedEx or Mixed than when Shipping Method is either "By Price" or "By Qty".

When set to "By Price" or "By Qty", you can base the weight on ounces, pounds, liters or any units of measurement. When an item has a "Weight" value specified, CoolCart will multiply weight x quantity for each item. Next, it will look in your weight table and determine the price based on the total weight values of all items. If this total is less than your minimum then it will use the minimum.

Tip - Be sure your weight table values in the Profile Manager use the same unit of measurement as the Weight elements used for each item. Otherwise, the shipping charge will not be calculated correctly.

If your Profile Manager - Shipping Options is set to use the UPS, USPS, FedEx or Mixed Shipping Method, Weight MUST be based on U.S. pounds. Example 1 for 1 lb, 1.5 for 1 1/2 lbs, etc. When the user enters the Ship To zip code, CoolCart will contact UPS, USPS, FedEx in real-time to determine the shipping charge based on the accumulated weight values and the shipping service selected (Overnight, 2nd Day, Ground, Express, etc.).

.0625 x 16 = 1 lb (16 oz)
.0625 x 8 = .5 lb ( 8 oz)
.0625 x 2 = .125 lb ( 2 oz)
.0625 x 1 = .0625 lb ( 1 oz)

1 oz x .0625 = .0625
2 oz x .0625 = .125
3 oz x .0625 = .1875
4 oz x .0625 = .25
5 oz x .0625 = .3125
6 oz x .0625 = .375
7 oz x .0625 = .4375
8 oz x .0625 = .5   (since 8 is half of 16 oz. That is 1/2 of 1)

Example of 1 pound
<input type="hidden" name="Weight" value="1">

Example of 1.5 pound
<input type="hidden" name="Weight" value="1.5">

Tip - Click here for using advanced modifier options for setting a "Weight" value.

Top

Show   "Show" is used to determine whether or not to display the contents of the cart when adding items to the basket.

"Show" supports three values "Y" for yes, "N" for no, or an absolute URL. These values are not case sensitive, so "Y" and "y" are equivalent, as are "N" and "n".

When set to "Y" or not specified, the contents of the cart will be displayed each time and item is added to the cart.

When set to "N", the shopper can add items to their cart but the contents of the cart are not displayed and the shopper is returned to the same page they were just on. This allows you to silently add items to the cart without displaying the contents for each item added.

Setting the value an absolute URL such as "http://www.yourcompany.com/mypage.html" is similar to "N" except you can specify an explicit page to show after each item is added. The value must include the http:// or https:// for the re-direct to occur.
<input type="hidden" Name="Show" Value="N">
Top

ShipAllowed   This allows you to limit how certain items can be shipped. For example, if you have a product that you only want to ship UPS Ground, you can include a "ShipAllowed" field that contains "UPS Ground, UPS 3 Day Select".

If a product has a ShipAllowed defined, the shopper will not be allowed to check out unless their shipping choice is found in the ShipAllowed field. The ShipAllowed field is tested against your defined Shipping Regions and/or UPS services selected (i.e. – either the Shipping Regions page or the UPS Options page in the Profile Manager). If two products are ordered and only one of them has a ShipAllowed defined, the ShipAllowed will affect the entire order. Use commas to separate multiple allowed shipping options, such as:
<input type="hidden" Name="ShipAllowed" Value="UPS Ground, UPS 3 Day Select">

Caution - if you specify a ShipAllowed value that does not exist as either a defined Shipping Region or selected UPS Service, the shopper won’t be allowed to check out. For example, if you only allow "UPS Ground" but don't have "UPS Ground" as an available Shipping choice, the shopper won't be able to check out.
Top

ReturnLink   When the user adds an item to their cart, A "Review Item" link will be displayed next to each item in the cart so the shopper can jump directly to the item from the cart. This value is usually automatically determined but you can also explicitly set the value by specifying a "ReturnLink" URL. "ReturnLink" values must be absolute URLs (i.e. -- "http://www.mycompany.com/mypage.aspx"). Relative URLs (i.e. -- "../mypage.aspx") will not work since the user only sees the link when displayed on the cart page running on the CoolCart.Net servers.
<input type="hidden" Name="ReturnLink" Value="http://www.mycompany.com/mypage.aspx">

You can also optionally include an image in the "ReturnLInk" field by referencing the URL of the image and it's height and width attributes. To specify an image for the ReturnLink, use the ^ character to separate the return link URL from the image URL. Like the ReturnLink, the image URL must be an absolute URL (i.e. - it must begin with http:// or https://). When the image URL is included in the ReturnLink value, the image is used instead of the words "Review Item". The syntax for including an image is:

"return_url^image_url^height^width"

The height and width parameters are also optional so you can either explicitly specify the image size or let the browser use the actual size of the image. An example would be:

<input type="hidden" name="ReturnLink"
value="http://www.mycompany.com/mypage.aspx^http://www.mycompany.com/images/widget.gif^60^80">


Note - Once the cart has been posted to the server, the cart will automatically switch to HTTPS mode when recalculating and some browsers (like Internet Explorer 6.0) will prompt the user that the page contains both secure and un-secure elements. This is not a problem but it could be an annoyance to the shopper unless their browser is configured to allow mixed content.
Top

Related   Related1 through Related5 tags allow you to create up to 5 URLs per product in your cart. Examples of "related" links might be suggested add-on products, product data sheets, particular shipping issues that a product may have, etc. Related links allow you to provide better service to your shoppers or up-sell products.

The syntax for the "Related" value is "absolute URL^description text^target".

For example, this value will display the text "Also Buy This!" and open the "mylinkpage.html" page in the current window when clicked.
<input type="hidden" Name="Related1" Value="http://www.mycompany.com/mylinkedpage.html^Also Buy This!">

To display a product datasheet .PDF in a new window, you could use:
<input type="hidden" Name="Related1" Value="http://www.mycompany.com/datasheet.pdf^Specs^_new">

The values must be absolute URLs (i.e. -- "http://www.mycompany.com/mypage.aspx"). Relative URLs (i.e. -- "../mypage.aspx") will not work since the user only sees the link when displayed on the cart page running on the CoolCart.Net servers.

Tip - For the "target" portion of the Related value, only include the target identifier. Don't use "target=_new" since the cart engine inserts the "target" attribute as necessary.
Top

SKU,  
SKU_Rule  
"SKU" is an optional value that you can use to reference the ordered items with your inventory system and is generally a used as a hidden tag, such as:

<input type="hidden" Name="SKU" Value="ABC-1-2-3">

Sometimes, the SKU number may differ depending upon the options selected, such as Color, Size, or other option. To accommodate this, you can provide CoolCart with a "SKU_Rule". The "SKU_Rule" value determines how CoolCart will create the SKU based on the selected options.

The Profile Manager allows you to define a default "SKU_Rule" value on the "Display" screen. You can also pass in a "SKU_Rule" tag which takes precedence over the default "SKU_Rule". In other words, if "sku_rule" is passed in as a form variable, that rule will be used; if not passed in, the default rule defined in the Profile Manager will be used. This allows a default (site wide) rule to be defined, but then overridden on a page-by-page basis if desired. The syntax of "sku_rule" is:

"accumulate"|"overwrite",[variable],[variable],[variable],[variable]

where "variable" can be "Color", "Size", "AddOn", or "NAddOn".

Examples:
<input type="hidden" name="sku_rule" value="accumulate,Color,Size">
This will append the Color's sku modifier to the "sku" value and then it will append the Size's sku modifier.

<input type="hidden" name="sku_rule" value="accumulate,Size,Color">
This will append the Size's sku modifier to the "sku" value and then it will append the Color's sku modifier.

<input type="hidden" name="sku_rule" value="accumulate,AddOn,Color,Size">
This will append any AddOn sku modifiers to the "sku", then append the Color's sku modifier, and finally append the Size's sku modifier.

<input type="hidden" name="sku_rule" value="overwrite,Color,Size">
This will first assign the discrete "sku" value (if present). Then, it will overwrite it with the Color's sku modifier (if present) and finally, it will assign the Size's sku modifier (if present).

Tip - A note about the order of AddOn and NAddOn – they will be added in ascending order. So, you only need to put "AddOn" in the sku_rule and the engine will overwrite or append AddOn1, then AddOn2, then AddOn3, etc.

Tip - When a hidden "SKU" tag is defined, that will always be used first. This allows you to define a base SKU value and update or overwrite it based on the option modifiers and "sku_rule". To have the option modifier's soley determine the SKU value, do not define a discrete "SKU" element.

Tip - Click here for using advanced modifier options for passing a "SKU" value.


Top

Additional Modifiers - The Size, Color, AddOn, and NAddOn tags support additional modifiers that can be used to set the Price, Ship, Weight, QtyMultiples, QtyMin, QtyMax, or SKU values using the format value^Price^Ship^Weight^QtyMultiples^QtyMin^QtyMax^SKU. For example, an AddOn checkbox that marks the price up by $2.00 and must be ordered in multiples of 12 with a minimum quantity of 24 would be:
<input type="checkbox" Name="AddOn1" Value="Extra Thing^2.00^^^12^24">

Tip - The Price portion can either be an absolute amount such as "5.00" or a percentage amount such as "15%". When a percent amount is used, the percentage value is the base price of the item, as determined by the original "Price" options. Further, the percentage can also be a discount by specifying a negative percent, such as "-10%"

Since the embedded values are positional, placeholders must be included for non-used positions if a subsequent modifier is used. For example, the below AddOn requires that item "Model A" have a minimum order of 2 but no Price, Ship, Weight nor multiple modifiers. Model B is an extra $2, has a minimum order of 10 and must be ordered in multiples of 5 while Model C is an extra $3, has a minimum order of 16 and must be ordered in multiples of 8. Since none of the options have a maximum limitation, no placeholder is required for the last modifier.

<select name="AddOn1">
  <option value="Model A^^^^^2">Model A
  <option value="Model B^2.00^^^5^10">Model B - Add $2.00
  <option value="Model C^3.00^^^8^16">Model C - Add $3.00
</select>


Since non-used positional placeholders are not required for non-used trailing modifiers, these are all valid settings:

Price only (adds $2.00 to the price for each item ordered)
<OPTION value="Some Item^2.00">Some Item

Price only using a percentage (adds 15% to the price for each item ordered)
<OPTION value="Some Item^15%">Some Item

Weight only
<OPTION value="Some Item^^^4">Some Item

Ship only
<OPTION value="Some Item^^2.25">Some Item
Price and QtyMin
<OPTION value="Some Item^2.00^^^^10">Some Item

Price and QtyMultiples
<OPTION value="Some Item^2.00^^^10">Some Item

QtyMin only
<OPTION value="Some Item^^^^^10">Some Item

QtyMultiples only
<OPTION value="Some Item^^^^10">Some Item

SKU Append Example: Append an AddOn and Color to a base SKU value resulting in a SKU of "XYZ-4-G"
<input type="hidden" name="SKU" value="XYZ">
<input type="hidden" name="SKU_Rule" value="accumulate,AddOn,Color">
<input type="hidden" name="Color" value="Green^^^^^^^-G">
<OPTION value="Some Item^^^^^^^-4">Some Item


SKU Overwrite Example: Keep overwriting the SKU, first with an AddOn value, then a Color value resulting in a SKU of "ABC-GRN"
<input type="hidden" name="SKU" value="ABC-0">
<input type="hidden" name="SKU_Rule" value="overwrite,AddOn,Color">
<input type="hidden" name="Color" value="Green^^^^^^^ABC-GRN">
<OPTION value="Some Item^^^^^^^ABC-4">Some Item


Tip - If a form contains both a discrete QtyMultiples, QtyMin, and QtyMax values and embedded modifiers, the embedded values will supercede the discrete values. Embedded Price, Ship, and Weight values are added to any discrete values.

Tip - If a form contains a discrete SKU value and embedded modifiers, the embedded values either overwrite or be appended to the discrete SKU value based on the "sku_rule" used. If a "sku_rule" is not defined in the Profile Manager and no "sku_rule" value is passed into the page, the CoolCart engine will not know how to use the modifiers. In this case, modifiers will be ignored and only the discrete value will be used.

QtyMin, QtyMax, QtyMultiples example
Top