ARCHIVED

Post-Upgrade Tasks for AbleCommerce 7 (RC3 to Final)

This document includes instructions on performing post upgrade tasks.  Some of these changes are required if you have upgraded from RC3 (build 9381+).

Post Upgrade Issues to Fix
 

STEP 1)  Download a small patch with the two files necessary to fix the issues shown.  Or, you can follow the instructions below for manually making the required changes.

STEP 2)  This step only applies to merchants who have installed the patch to modify the checkout behavior for failed credit card transactions.  Follow the new instructions below for issue 6692 (Validate credit cards prior to order completion).  Do not overwrite the new files using the patched files from RC3.

 

Issue ID 6769 - Truncation error causing lost orders on checkout

This issue can happen if a person is referred to the store and the browser has a user agent referrer longer than 255 characters.  This is a critical issue and should be fixed to prevent the possibility of a lost order.

  1. Find the patched file 'global.asax' and place in the root of your AbleCommerce installation folder.  This file is not included in the upgrade so you must replace it, or manually modify the following lines of code if you have customized the file.  

    1. Around line 21, in the Session_OnStart method.

    2. Change FROM:

if (Request.UrlReferrer != null) Session["SessionReferrerUrl"] = Request.UrlReferrer.ToString();

    1. Change TO:

if (Request.UrlReferrer != null) Session["SessionReferrerUrl"] = StringHelper.Truncate(Request.UrlReferrer.ToString(), 255);

  1. Save your changes.  

 

Issue ID 6867 - Orders with missing customer information

In the last release (SR3), the maintenance routine removed addresses for anonymous users every 60 minutes.  This change had some undesired effects in the event that an anonymous user would begin the checkout process and delay for more than 60 minutes before placing the order.  The result was that an order would be submitted without a name or any address information.  The flaw can be corrected by upgrading and setting an anonymous cookie time-out in the base web.config file.

  1. Find the patched file 'web.config' and place in the root of your AbleCommerce installation folder.  This file is not included in the upgrade so you must replace it, or manually modify the following lines of code if you have customized the file.

    1. Change FROM:

<anonymousIdentification enabled="true" cookieName="AC7.ASPXANONYMOUS"/>

    1. Change TO:

<anonymousIdentification enabled="true" cookieName="AC7.ASPXANONYMOUS" cookieTimeout="1440" />

  1. This will set the anonymous cookie time-out to 24 hours.  You may enter a different value (in minutes) if so desired.     

  2. Save your changes.   

 

Issue ID 6692 - Validate credit cards prior to order completion

This update is optional unless you have previously installed the patch made available for RC3.  By making this change, you are changing the behavior of the checkout process with credit card payments.  If a credit card fails to authorize during an order, the customer is directed to another page where they can try to re-enter the credit card information or try a new payment method.

If you do not want to make this change, the default behavior is to accept all orders regardless of the outcome of the credit card transaction.

This change has not been fully tested. If you find a bug, please report it.  

  1. Login to the AbleCommerce merchant menu as the admin, or a user with website edit permissions.

  2. Go to Website > Content and Layout

  3. Find and edit the ”r;My Order Page” content scriptlet.

  4. The content field should have this tag:

[[ConLib:MyOrderPage]]

  1. You need to include the "HandleFailedPayments" attribute to turn on failed payment handling, so change it to look like this instead:

[[ConLib:MyOrderPage HandleFailedPayments="true"]]

  1. After updating the scriptlet content, save the changes.

  2. Find and edit the "Receipt Page" content scriptlet.

  3. The content field should have this tag:

[[ConLib:ReceiptPage]]

  1. Again, you need to include the "HandleFailedPayments" attribute to turn on failed payment handling, so change it to look like this instead:

[[ConLib:ReceiptPage HandleFailedPayments="true"]]

  1. After updating the scriptlet content, save the changes.