Note: This page is geared towards upgrading from v0.4.0. Please make sure you view all the version notes for versions you may be skipping (ie. from 0.3.2 → 0.4.0 → 0.5.0).

Please make sure you review the 0.5.0 changelog before upgrading.

Tax handling in v050 has been completely rewritten. As such, you will need to re-configure your taxes when you upgrade to v050. If you have problems please let us know in the forums.

FoxyCart v050 allows receipts to be reloaded. If you're using any sort of ANALYTICS or AFFILIATE TRACKING you'll need to wrap your tracking scripts in ^^receipt_only_begin^^ and ^^receipt_only_end^^ placeholders, or these script will get called every time the receipt is loaded, which could significantly skew your data and potentially your affiliate payouts.

More information on revisitable receipts and the new "receipt only" placeholders. The Google Analytics instructions have been updated to reflect this change under the “Receipt” item.

All error, warning, and information messages are now displayed and formatted consistently throughout the cart and checkout, as well as the JSON and XML. If you're using the default styles you won't have to worry about this, but if you're using custom CSS you will need to test things out and add CSS declarations as desired. You can force an error by adding an item with no name to the cart. You can force a warning by loading an existing subscription (using the new sub_token functionality). The HTML looks like this (for a warning):

<div id="fc_message_container">
	<div id="fc_error_container" class="fc_message fc_error">
		<ul>
			<li>You must specify a name to add a product to your shopping cart.</li>
		</ul>
	</div>
</div><!-- #fc_message_container -->

The default size of the “FoxyBox” (Thickbox) has been increased. You can still set a custom size, detailed here.

If you're using subscriptions in FoxyCart you need to be aware that the subscription handling in v050 is (potentially) very different than previous versions.

• Tax and shipping/handling fees can now be added to subscriptions.
• Customers can modify and cancel their own subscriptions.
• A “past due” amount has been added to subscriptions, which eases collections.
• A subscription-specific XML datafeed has been added to greatly ease automation.
• Subscription end-dates are now configurable.

If you're using SUBSCRIPTIONS and MULTI-SHIP please notify us in the forums. There are known issues with taxes + multi-ship + future-subscriptions, and at this point we recommend not upgrading.

Removed name=“fc_cart_form” from the form on the cart template. The id=“fc_cart_form” remains. This shouldn't be an issue unless you're using some javascript that references it by the name rather than the ID.