Documentation You are here: start » v » 1.1 » upgrading

Changelog and Upgrade Notes for v1.1

Note: This page is geared towards upgrading from v1.0. Please make sure you view all the version notes for versions you may be skipping (ie. from 0.7.2 → 1.0 → 1.1).

Changelog Summary

Please make sure you review the full v1.1 changelog (available in your FoxyCart admin's Store Settings page before upgrading. Also please ensure you've read the known issues.

New Features in v1.1

New Payment Methods

In addition to new “traditional” gateways, we've also added support for more alternate payment methods in the US (Dwolla, Amazon FPS) and in the EU (Ogone and DIBS for iDEAL and Netbank support).

  • Amazon FPS
  • Ogone
  • DIBS
  • Dwolla
  • DataCash
  • Emerio Payments

As with all of our payment methods, documentation is on our wiki.

Bug Fixes and Changes to Existing Behavior

There are a handful of bug fixes to v1.1 noted on the changelog, but none of them should cause problems for upgrading unless you were specifically working around the incorrect behavior. (And if you were, please in the future just let us know so we can correct the issue :)

  • Fixed a bug when checking out with a returning customer logged in via their own password or UOE. A new password hash and password salt were being created, even if the password had not changed. This change shouldn't likely impact you unless you were using SSO and UOE and working around this issue in a very particular way.
  • Subscription past due items are no longer included when calculating coupons and category discounts. Again, no action required unless you were relying on this incorrect behavior.
  • When calculating coupons, current and future subscription items are now calculated separately.
  • When calculating category discounts, current and future subscription items are now calculated separately.
  • When adding an already existing non-subscription item to the cart containing subscriptions, a new item would be added instead of increasing the quantity of the existing item. This is fixed now.
  • When loading up a subscription template via a sub_token, we no longer keep a perviously modified copy of that template in the cart. The subscription template will be loaded fresh with each click of a sub_token link.
  • Prepopulation no longer forces an anonymous (ie. guest) customer. This was causing problems for SSO checkouts.
  • Updated the FC.checkout.requireShippingAddress() function to use a language string checkout_copy_billing_to_shipping and added the HTML into the Twig template. The function has also been updated to only run if shippable products are present and mutliship is not active for the store.

Upgrading to v1.1

ACTION REQUIRED: All Users

Change of FoxyCart Includes

Log into your FoxyCart admin and go to the “sample code” section to get the latest “includes”. This will include jQuery, foxycart.colorbox.js (or a variant of that file), and the Colorbox CSS file. These filenames may change slightly between versions to accommodate for version changes and improvements, so make sure you get the latest files when you upgrade from any version.

If you're using an integration that inserts code into your templates automatically, this may be done for you, but check with your integration developer to be sure.

ACTION POSSIBLE: For stores with Twig checkout template customizations

If you've customized your checkout template using Twig, and you are not using the block shortcut syntax like this:

	{{ block('checkout_shipping_and_summary') }}

You'll need to re-copy out that portion of the checkout template (from here). We've added some <span> elements to make styling the summary values easier.

ACTION POSSIBLE: Some stores may be impacted

New jQuery Version: 1.9

jQuery has been updated to 1.9.0, which deprecates some old behavior like .live(). jQuery has its own upgrade guide, and this is very likely worth checking. If upgrading FoxyCart causes other javascript-based functionality (like image slideshows and such) to break, it's probably the new version of jQuery.

If you utilise any code that makes use of ajaxComplete(), make sure that it's bound directly to the document. This is commonly seen in custom shipping snippets, where it may look like this: jQuery(“#fc_shipping_methods_inner”).ajaxComplete(function(event, request, settings) {, and should be updated to instead look like this: jQuery(document).ajaxComplete(function(event, request, settings) {.

If you do run into issues and can't update your jQuery-based scripts, installing the Migrate plugin might get you what you need.

Google Analytics Integrations

The jQuery 1.9 upgrade necessitates a few very tiny tweaks to your Google Analytics integration code. This code has been updated on the Google Analytics + FoxyCart documentation, but if you want to find/replace, find .attr(“checked”) and replace with .is(“:checked”).

New Language String

If you're using a non-English language file, there has been a new language string added:

  • checkout_copy_billing_to_shipping

You may want to double check the language of that (the checkbox on the checkout that allows the billing address to be used for the shipping address) to make sure it's how you'd like it.

Site Tools