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).
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.
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).
As with all of our payment methods, documentation is on our wiki.
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 :)
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.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.
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.
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.
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.
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”)
.
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.