Upgrade from AbleCommerce 7.0.4 to 7.0.5

1)  Download Upgrade

To download the upgrade for AbleCommerce 7.0.5, you will need to have a valid 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 a valid subscription, you can open the "commerbuilder.lic" file located in the \app_data\ folder.  Look for this line of code:

e.g. <subscription>2010-06-01</subscription>

Make sure the date is on, or after, the subscription date for this build.  If you do not see this line, then your license does not have a subscription included.

* The actual release date of the 7.0.5 version is July 27th, 2010.  However, due to delays beyond our control, we have extended the availability of version 7.0.5 to customers who have subscriptions expiring on, or after June 1st, 2010.     

2)  Backup your Existing Files

• Make a backup copy of the entire AbleCommerce install folder and the database.

• Any customizations that you may have made should be located in the following folders of your <installpath>:

• • \ConLib\Custom\..

  • \App_Data\Scriptlets\Custom\..

  • \App_Themes\..(current store theme)..\*.css, *.skin

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)  Installation of New Files

1. Double-click the .exe file to extract the contents to a temporary location.

2. Stop the IIS web service* application to release a lock on the DLL files in the \bin\ folder.

3. Select all the new files, copy, and overwrite your existing files in the <installpath> program folder.

4. Restart the IIS web service application.

  * If you are unable to stop the web service, try to perform the update during a slow time.  DO NOT access your store while uploading the files via FTP.  Double-check to make sure that ALL files are updated, especially the .DLL's in the \BIN\ folder.

4) Permission for updates

During upgrades, we may need to remove files that are no longer used or perform updates that require additional permission.  This means that AbleCommerce will need to have write and delete permissions on folders that might not ordinarily require it.  If possible, you should temporarily add 'write' and 'delete' permission to the entire store website for the ASPNET user (e.g. Network Service).

If adding additional permissions is not an option, you may receive errors during the upgrade.  These errors will simply be warnings to indicate which files and/or folders could not be removed by the program.  You can still complete the upgrade, however, you will need to complete these steps after upgrading:

1. Remove unused files and/or folders

2. Update web.config and global.asax  

5)  Upgrade your Installation

WARNING: Make sure you have a backup of your database before upgrading !!!!

1. Browse to the <installpath>/install/upgrade.aspx page to run the database script.
   
   e.g. http://localhost/ac7/install/upgrade.aspx

2. Follow the on-screen instructions to complete the upgrade:

   • Type BACKUP in the space provided to confirm you understand.

   • You can optionally have AbleCommerce upgrade the web.config and global.asax files. Check the box to confirm you've made backups.

   • Initiate the upgrade.  When finished, you should receive confirmation.  
     You may also receive some information on changes made during the upgrade.

3. If you get an error during upgrade* - STOP!  Copy the error for AbleCommerce support, and revert to your backups.

6)  Replace any Customizations (if applicable)

• AbleCommerce will not replace any files located in the \Custom\ folders, however, you may need to restore customizations made to files (.css\.skin) within the \App_Themes\ folder if you are not using a custom Theme.

• • \ConLib\Custom\..

  • \App_Data\Scriptlets\Custom\..

  • \App_Themes\..(your custom store theme)..\*.css, *.skin

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

1. Complete the steps, as needed, in the Post Upgrade Tasks section immediately following.

2. Review the Release Notes to see if there are any changes that could impact your store.

Post Upgrade Tasks

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 want AbleCommerce to handle these automatic updates, then you will need to manually update these two files yourself.  Please Update web.config and global.asax files before continuing.

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. 

Release Notes

The following list includes changes in this release that could impact your store.  Please take a moment to read through each item and determine if any action needs to be taken.

• DISCONTINUE SUPPORT FOR WINDOWS 2000 SERVER
  
  Microsoft's .NET Framework 2.0 SP2 is no longer supported on Windows 2000.  As such, we will also be discontinuing support for Windows 2000 because AbleCommerce will require .NET Framework 2.0 SP2.

• DISABLE BOTS ON CHECKOUT
  
  The OnePageCheckout control and scriptlet have disabled robots in prior versions by using the setting "DisableBots=true".  The setting is only necessary to prevent bots from attempting to use multiple random gift certificate codes.  In new installations of 7.0.5+, the feature will be turned off by default.   
   

• CHANGES TO "LOW INVENTORY" EMAIL TEMPLATE
  
  The Low Inventory email template has been modified to include product variants that are part of low inventory warnings.  Modified as follows:
  
  FIND:

#foreach ($product in $products)

<td style="text-align: center;">$product.SKU</td>

<td>$product.Name</td>

<td style="text-align: center;">$product.Instock</td>

<td style="text-align: center;">$product.InstockWarningLevel</td>

</tr>

#end

ADD AFTER:

#foreach ($variant in $variants)

<td style="text-align: center;">$variant.SKU</td>

<td>$variant.Product.Name ( Variant: $variant.VariantName)</td>

<td style="text-align: center;">$variant.Instock</td>

<td style="text-align: center;">$variant.InstockWarningLevel</td>

</tr>

• CHANGES TO "EMAIL LIST SIGNUP NOTIFICATION ONLY" EMAIL TEMPLATE
  
  The email template has been modified to include a simplified and secure unsubscribe link.  Modified as follows:
  
  FROM:

<p>If you did not intend to sign up for this list, then click the link below

to remove your address.</p>

<p><a href="${store.StoreUrl}Subscription.aspx?action=remove&list=${list.EmailListId}&email=${email}">
${store.StoreUrl}Subscription.aspx?action=remove&list=${list.EmailListId}&email=${email}</a>

   </p>

TO:

<p>If you did not intend to sign up for this list, then click the link below

to remove your address.</p>

<p>$unsubscribeLink</p>

• CHANGES TO "EMAIL LIST SIGNUP WITH VERIFICATION" EMAIL TEMPLATE
  
  The email template has been modified to include a simplified and secure unsubscribe link.  Modified as follows:
  
  FROM:

<p><strong>To activate your subscription, you MUST click the link below to

verify your request.</strong></p>

<p><a href="${store.StoreUrl}Subscription.aspx?action=confirm&list=${list.EmailListId}&email=${email}&key=${signupkey}">
${store.StoreUrl}Subscription.aspx?action=confirm&list=${list.EmailListId}&email=${email}&key=${signupkey}</a>

   </p>

TO:

<p><strong>To activate your subscription, you MUST click the link below to

verify your request.</strong></p>

<p>$subscribeLink</p>
 

• HOW TO REMOVE GIFT WRAP IMAGE FROM ALTERNATE CHECKOUT

If your store will not be using the Gift Wrap features, then you may want to remove the gift wrap image shown within the Alternate Checkout pages.  These pages can only be accessed when using multiple shipping address or Paypal Express checkout.

1. Edit ConLib/ShipMethodPage.ascx file

2. Locate following line of code

<div class="addGiftOptions">

and then replace it with

<div class="addGiftOptions" runat="server" id="addGiftOptionsDiv">

3. Now edit ConLib/ShipMethodPage.ascx.cs file

4. Locate following line of code

GiftOptionsPanel.Visible = BasketHelper.ContainsAnItemWithGiftWrap(basket);

and then replace it with

GiftOptionsPanel.Visible = BasketHelper.ContainsAnItemWithGiftWrap(basket);

            if (!GiftOptionsPanel.Visible)

                addGiftOptionsDiv.Attributes.Add("style","background:none!important;");

5. Save the files and now test with/without items associated with wrappings.
    

• IMAGE FORMATTING ADJUSTMENT IN MINI BASKET FOR KITS
  
  In the App_Themes\{your theme}\styles.css file, adjust 3 lines so that Kits are displayed properly in the mini-basket.

CHANGE FROM:

.miniBasketItemTitleBox { margin-left: 34px; display:table-cell;}
 

TO:

.miniBasketItemTitleBox { margin-left: 34px; }

CHANGE FROM:

.miniBasketItemTitle { color:#003716; font-weight: normal; float:left; position:relative; text-align:left; margin:0 5px; }

TO:

.miniBasketItemTitle { color:#003716; font-weight: normal; float:left; text-align:left; position:relative; margin:0 5px 0 15px; }

CHANGE FROM:

.miniBasketSubItemTitle { font-size: 10px; padding: 0; text-indent:0; margin: 0 7px; clear:both; }

TO:
.miniBasketSubItemTitle { font-size: 10px; padding: 0; text-indent:0; margin: 0; clear:both; }