Upgrading
Please view the upgrade notes in the wiki.
Features
Cart
- Quantity discounts:
discount_quantity_amount
,discount_quantity_percentage
,discount_price_amount
,discount_price_percentage
. To use these options, send them to your cart with the name for your discount and the discount tier details like so:discount_quantity_amount=Discount{2-.50|10-.75|50-1}
, which would give $0.50 off per product for 2 to 9 products, $0.75 off per product for 10 to 49 products, and $1.00 off per product for 50 or more products. By default, this discount is an “all-units” quantity discount, and will apply to all units. discount_quantity_amount=Discount{2-.50|10-.75|50-1}
added. This is very similar to the default “all-units” behavior, but the discount only applies to the products in the tier. So with the above example, 4 products would be 1 product at full price, then 3 products with the $0.50 discount. It is invoked with theincremental
flag like this:discount_quantity_amount=Discount{incremental|2-.50|10-.75|50-1}
- “Buy one, get one” style discounts added. In addition to “buy one, get one free” discounts, this can be used for “buy 3, get 1 50% off” and etc. Since this discount type is effectively a repeating incremental discount, it is invoked with the
repeat
flag like this:discount_quantity_percentage=Discount{repeat|2-100}
. Repeatable discounts can have only one tier. Check the docs for more information. - Minimum and Maximum Quantity: You can now set minimum and maximum quantities on a per product, per cart, basis. (Please note that this is not inventory; this simply sets caps on allowed quantities on a per transaction basis.)
- Added a new
empty=yes
option that will empty your shopping cart while adding your next product. - Concatenate product code modifiers: You can now use product modifiers to concatenate onto your product_code as you go using
c+
as a modifier.
Checkout
- Added new “sensitive” custom fields which will show up in the admin and the datafeed, but will not be included in any of the emails or the receipt. Just add “h:” in front of any custom field names that you would like to obtain from your customer on the checkout, but don’t want sent via email or displayed in the receipt. Good examples are social security numbers or other personal information.
- Custom field select boxes can now be required on checkout by adding the
fc_required
class.
Admin
- Category-wide quantity discounts: Similar to the product quantity discounts described above, but applying to all products in the same category.
Improvements & Bug Fixes
Cart
- IMPORTANT: Change to product option modifiers. Product option modifiers have been changed from a single comma
,
to a single pipe symbol|
. Example:&color=red{p+4,w-1,c:01a}
becomes&color=red{p+4|w-1|c:01a}
If you use product option modifiers to adjust your product’s weight, price or code, you must modify your website for this version. We don’t like to change things like this, but it’s necessary as we move towards more complete international solutions. - Fixed a bug that was including cookie information as product options.
- Single-quotes / apostrophes can now be included in product options.
- Set the root path for FoxyCart cookies to be the site root, which fixes a problem when the first time
foxycart_includes.js
is loaded in a subdirectory rather than the site root. Also made FoxyCart cookies subdomain independent to prevent issues with bouncing betweenwww.domain.tld
anddomain.tld
.
Checkout
- Google Analytics:
^^analytics_google^^
has been changed to^^analytics_google_urchin^^
(the old Google Analytics script,urchin.js
) and^^analytics_google_ga^^
(the new Google Analytics script,ga.js
). Please use the new place holder depending on what version you are using. - Added
customer_company
as a new field on the checkout and receipt page. If you don’t want this field to show up or you haven’t styled it yet, you might want to add some css to hide#customer_company
. Hidden by default in the “standard” theme. - Added
shipping_company
as a new field on the checkout and receipt page. If you don’t want this field to show up or you haven’t styled it yet, you might want to add some css to hide#shipping_company
. Hidden by default in the “standard” theme.