Version: AbleCommerce 7.0.3 Build 12458
Release Date: 06/01/09
Change Log : A list of changes between build AbleCommerce 7.0.2 build 11659 and 7.0.3 build 12458.
Take a moment to read this entire document before beginning. After you upgrade, you may need to complete the Post-Upgrade steps below.
Before you begin, DETERMINE YOUR CURRENT VERSION. View the Help > About page from the Merchant Menu for this information.
These instructions apply to installations running AbleCommerce 7.0.2. If you are running a version prior to 7.0.2, then please use the Instructions for Multiple Step Upgrades instead.
1) Download Upgrade
To download the upgrade for AbleCommerce 7.0.3, you will need to have an active subscription. We will notify all subscription holders when a new version is available for download. To obtain the file, login to the ablecommerce.com website and go to the Customer Account pages. From there, click on the Downloads tab to see available software downloads. License keys are requested through your order.
DO NOT INSTALL THE UPGRADE IF YOU DO NOT HAVE A VALID SUBSCRIPTION. To see if you have an active subscription, you can open the "commerbuilder.lic" file located in the \app_data\ folder. Look for this line of code:
Make sure the date is on, or after, the release date for this build. If you do not see this line, then your license does not have a subscription included. If you think that you are entitled to this upgrade, then please open a new case and include the name of your website. If you purchased a beta version of AbleCommerce, there is a good chance that your subscription end date will be incorrect. We will happily correct this for you.
2) Backup your Existing Files
The upgrade will NOT overwrite customizations located within these specific folders. After the upgrade, you are responsible for merging any changes to the new "control" objects or .aspx files.
3) Pre Upgrade Tasks
These are required steps that you need to do BEFORE copying the new files into place.
ALL UPGRADES: Prior to applying the upgrade files, locate and delete the entire "FCKEditor" folder from your install location.
ONLY IF UPGRADING FROM 7.0.1 OR 7.0.2: Locate the file App_Code/TaxHelper.cs file and delete it prior to accessing the Upgrade.aspx script.
4) Installation of New Files
5) Upgrade your Database
WARNING: Make sure you have a backup of your database before upgrading !!!!
* NOTE: This upgrade requires that you have write or delete permissions to the entire store folder so that certain outdated files can be removed or changed. If you get informational errors after upgrading, you can follow the steps to manually delete or change these files.
6) Replace any Customizations (if applicable)
If you have customized the control objects located in the \ConLib\ folder, they will be overwritten by the upgrade. Control objects that are modified should always be placed in the \ConLib\Custom\ folder and referenced by the scriptlet accordingly.
If you need to merge any customizations, we recommend that you use a file compare and merge utility such as WinMerge. WinMerge is Open Source file compare and merge utility which runs on all modern Windows versions. Latest WinMerge version and other WinMerge information is available at http://winmerge.org
7) Complete Post-Upgrade Tasks
Not all steps may be necessary. Please take a moment to review the steps below.
STEP 1) - Web.config and Global.asax updates
YOU CAN SKIP THIS STEP IF YOU ALLOWED THE UPGRADE TO AUTOMATICALLY CHANGE YOUR WEB.CONFIG/GLOBAL.ASAX FILES.
The upgrade can automatically handle required changes to your web.config and global.asax files. If you did NOT choose to have AbleCommerce handle these automatic updates, then you will need to manually update these two files yourself. Please complete Web.Config changes documented here.
STEP 2) - Enable Taxes
If you are using AbleCommerce Tax Rules, you must visit the Configure > Taxes > Settings page in the merchant administration. Please confirm that taxes are enabled and that the display settings are satisfactory.
STEP 3) - Email Templates
In this release, we corrected a bug in the email templates that displayed hidden components of a Kit. If you do not have kits or use hidden components, then you can skip this step. Please review this page for instructions on updating your email templates: Email Templates for AbleCommerce 7.0.3
STEP 4) - Disabled URL rewriting
This step is only necessary if you have disabled URL rewriting through manual modification of the App_Data/ablecommerce.config file. The way URL rewriting is turned on and off has changed. After upgrade to 7.0.3, for URL rewriting to remain off you must perform the following manual change.
Apply Latest Updates
After installation, make sure to check for free Service Release upgrades, or Hot Patches as posted in the Announcements section on the home page of this website.
Federal Reserve Bank of New York discontinued foreign exchange rates
On December 31, 2008, the Federal Reserve Bank of New York ceased publication of foreign exchange rates.
If you had configured multiple currencies and were using the FRBNY for automatic rate updates, your configuration has automatically been switched over to use the European Central Bank. In version 7.0.3 we have also added the Bank of Canada as an alternate provider of exchange rates. You should visit the currencies menu (Configure -> Currencies) in the AbleCommerce merchant administration and update your exchange rates now.
You may also change to the new Bank of Canada rate provider if desired.
IMPACT OF KITTING CHANGES
If you use kits, please review these new kit rules so you understand the impact of changes in this release. The most significant change for upgraded installations will be that taxes are now calculated on individual kit member products.
There are two types of kits:
Bundled - this is the original kit display style "bundled" which you will continue to have after upgrading. The kit will be shown as a single product and price with any member products displayed in a list beneath the master product.
Itemized - this is the new kit display style "itemized" which can be changed from the Kits/Bundles page of product editing. The kit will be shown with the master product on the first line with it's own price, and each member product itemized in the basket and invoices with their own prices.
Gift Wrap - Kits that use gift wrap will use the Wrap Group setting of the master kit in all cases. This means that you cannot have individual kit member products that use different gift wrapping choices.
Shipping to Multiple Destinations - Kits cannot be split apart and shipped to different destinations. In the case of itemized kits, you can have multiple shipments created for the order, but they must all be shipped to the same location. If the customer purchases two or more kits, they will still be able to use the multiple destination feature but a kit, as a whole, will be shipped to the same destination.
Member products that are Included-Hidden - The "included-hidden" component products will always take on the properties of the master product.
A division of Able Solutions Corporation, headquarters located in Vancouver, WA