Announcement:Materials and articles for ProductCart 5 can be found at our brand new support center.

Create an account to edit articles | See Formatting Syntax for Wiki syntax | We look forward to your contribution!

ProductCart v4.6 Update Guide

The ProductCart v4.6 Update was made available on April 24, 2012. To download the v4.6 update (and to support the development of future updates!), please subscribe to the ProductCart Support & Updates Plan. Once your license is eligible for updates, you can download the updated files by logging into your Control Panel and selecting Help > Check for Updates.

A "Must Read"

Please READ THIS DOCUMENT CAREFULLY before updating your ProductCart-powered store.

  • A list of “To Do Items” is enclosed below. Make sure to review it and make the necessary changes.
  • Downloading the 4.6 Update files using the Check for Updates feature is not enough to successfully update your store.
  • That's because:
    • Your ProductCart-powered store may be running add-on's and special files that require additional steps
    • Some files that you have very likely customized will be overwritten (e.g. includes/languages.asp and pc/pcStorefront.css)
      Synchronize them with your version before uploading them to your store.

The primary change in this update is the FedEx Web Services Phase II update. If you are currently using the FedEx API with ProductCart you will need to apply this update before the end of May 2012 as FedEx will no longer be supporting their FedEx API.

Applicability

You should be running v4.5 Service Pack 1 to update to version v4.6.

Backing Up Your Store

Make sure that you back-up your store before proceeding. This is a crucial step of the store update process: if something goes wrong, for any reason, you will be able to restore your previous installation.

To Do Items

Please see the list below to locate all the items that you need to download and install. A Legend below includes descriptions for the abbreviations used in the following table.

You are using… What you need to download and FTP to your server… How to get the files…
Main ProductCart file set
STD 4.6 Update from UMS Check for updates in the CP
BTO 4.6 Update from UMS Check for updates in the CP
STD + APP 4.6 Update from UMS Check for updates in the CP
BTO + APP 4.6 Update from UMS Check for updates in the CP
BTO + CM 4.6 Update from UMS Check for updates in the CP
BTO + APP + CM 4.6 Update from UMS Check for updates in the CP

Check For Updates is available in the Control Panel under Help.

Legend

  • STD = ProductCart standard version
  • BTO = ProductCart Build To Order version
  • APP = Apparel Add-on for ProductCart
  • CM = Conflict Management Add-on for ProductCart
  • eBay = eBay Add-on for ProductCart
  • QBK = QuickBooks Add-on for ProductCart
  • UMS = Update Management System
    This is the system that you access via the Check for Updates feature in your Control Panel. The system detects which version you are running and delivers the correct file.

Downloading the Update File

Depending on the version of ProductCart that you are using (Standard vs. Build To Order) and on the add-on's installed on your store, the Update Management System will prompt you to download the correct file. NOTE: if you receive a message indicating that your license is not eligible for updates, that's because your subscription to the Support & Updates Plan might have expired.

Double-checking the Downloaded File Name

You can double-check that you are indeed downloading the correct file by checking the file name against the following information.

  • If you are running the STANDARD version of ProductCart, the file that you downloaded should be named: ProductCart_v4.6_Update_date
  • If you are running the BUILD TO ORDER version of ProductCart, the file that you downloaded should be named: ProductCart_v4.6_Update_BTO_date
  • If you are running the BUILD TO ORDER version of ProductCart, with the Conflict Management Add-on, the file that you downloaded should be named: ProductCart_v4.6_Update_BTO_CM_date
  • If you are running ProductCart (STANDARD or BUILD TO ORDER) with the Apparel Add-on, the file that you downloaded should be named: ProductCart_v4.6_Update_APP_date
  • If you are running the BUILD TO ORDER version of ProductCart, with both the Apparel Add-on and the Conflict Management system, the file that you downloaded should be named: ProductCart_v4.6_Update_APP_CM_date

Unzipping the Downloaded Files

  • Unzip the files to a new directory on your desktop (e.g. “4.6 Update Files”).
  • Do not copy the unzipped files onto an existing set of ProductCart files.
  • If you want to have a copy of the entire ProductCart folder on your desktop, including the latest files, download the store to your desktop after you have finished the update process.

Updating Overwritten Files

List of Files

The following file in the ProductCart v4.6 update overwrites a file that you have likely customized.

  • includes/languages.asp
    This file contains text strings that are often edited by ProductCart users.

Synchronizing Overwritten Files

As noted above, this update contains a file that you have likely modified.

See Synchronizing Files for tips on how to compare and synchronize your edited files.

Synchronize the new files with the corresponding, edited files in your ProductCart file set before you begin the update process. This article contains some instructions on how to do so.

Installing the Update

Parent Paths Enabled vs. Parent Paths Disabled

Please select the correct update files depending on the version of ProductCart that you are running. Specifically, if you are running ProductCart on a server that has Parent Paths Disabled, please use the files contained in the “Parent Paths Disabled” folder. Otherwise, use the files contained in the “Parent Path Enabled” folder, which is the most common scenario.

If you are unsure of which version you are running, look at the version number in the Control Panel start page (“menu.asp”). If it includes the letters “PPD”, then you are using the “Parent Path Disabled” version of ProductCart.

Step 1 - Back up your store

If you haven't already done so, back-up your store.

Step 2 - Turn off your store

  1. Log into your Control Panel and select General Settings > Store Settings
  2. Enter a descriptive message in the field Message displayed when store is off.
  3. Select Turn store off, then click on the Update button. This ensures that customers do not browse the store while you are updating it.

Step 3 - FTP new files to your server

Upload the files to their respective folders, overwriting the existing files. For instance, you will update the contents of the pc subfolder on your Web server with the files contained in the pc subfolder that you have downloaded from the ProductCart Update Management System.

Please note that the pcadmin folder has likely been renamed on your store. We recommend that you rename the same folder in the update files locally on your computer so that when you FTP the files there is no chance that a new pcadmin folder is created, which would mean that some of your store files are not being updated.

DO NOT delete any of the files that are currently on your Web server.

Step 4 - Update the Store Database

  1. Log into the Control Panel
  2. You will be automatically redirected to the database update page (upddb_v46.asp).
    Troubleshooting:
    1. If you are not automatically redirected, replace “menu.asp” with “upddb_v46.asp” in the browser address field and press the ENTER key on your keyboard.
    2. If you get a “Page Not Found” error, it means that the files were not uploaded to the correct folder or the FTP upload was not completed successfully.
  3. Run the database update script.
    Troubleshooting:
    1. If you receive any errors or warnings (e.g. a table could not be updated), run the database update again. In some cases these errors disappear on the second execution of the update.
    2. If the errors persist even after re-running the database update script a few times, leave the store OFF and open a Support Ticket.

Step 5 - TO DO List

A message will confirm that the database has been updated. If there are any “To Do” items, they will be mentioned here. One important To Do item is the following:

  • Remove FedEx Shipping Service (if applicable)
    If you are currently using FedEx in your store, you will need to removed it.
  • Remove FedEx Web Services (if applicable)
    If you have already applied the patch for v4.1 or v4.5 for FedEx Web Services rating then you will need to removed (not disable) FedEx Web Services.
  • Register FedEx Web Services
    In order to use the new FedEx Web Services integration with ProductCart you will need to activate FedEx Web Services. This will required that you insert your FedEx account details to register your account to work with the ProductCart application.

Step 6 - Turn your store back on

When all To Do items have been completed, you can now turn your store back on and verify that the storefront is working properly. We recommend that you place at least one test order to go through the entire checkout process.

Troubleshooting

If you encounter a problem, please review the information in this document carefully to make sure that you have followed every step as outlined above. Specifically, make sure that:

  1. You started with the correct version number (see “Applicability” above)
  2. You correctly uploaded the files to your store (e.g. files in the “pcadmin” folder, which you likely renamed in your store)
  3. You successfully updated the database, as described above
  4. You completed the rest of the To Do items mentioned above

If this still doesn't solve your problem, leave the store OFF, log into your account on the ProductCart software store, and submit a support ticket. Please make sure to indicate which version of ProductCart you are updating from, which add-on's and other file sets you are using (e.g. Google Analytics integration, etc.), and include the error message that you are receiving.

Disclaimer

The ProductCart v4.6 Update has been tested by NetSource Commerce in a variety of environments. However, there might be environments that have not been tested and that may cause problems.

You are responsible for making a backup copy of your existing store database and store files, as described above. A backup copy of your store will allow you to revert back to your previous, working version of ProductCart in case you experience any problems after running the update.

NetSource Commerce shall not be liable for any loss of data and/or loss of income due to any downtime that your online store may experience as a direct or indirect result of installing this update.

Updated Files

includes

  • languages.asp
    Corrected spelling typos and added more language variables.

pc

  • FedExWebServices.asp
    Updated for Phase II of the FedEx Web Services integration
  • opc_chooseShpmnt.asp
    Fixed a bug in the UPS rates storefront calculator that was returning only the additional handling charge for certain rates that did not qualify for negotiated rates.
  • estimateShipCost.asp, pcPay_GoogleCheckout_Callback.asp, pcPay_GoogleCheckout_Shipping.asp, pcPay_GoogleCheckout_ShipRates.asp, pcPay_GoogleCheckout_Start.asp
    Updated the Google Checkout files for the latest shipping rate changes.
  • SaveOrd.asp
    Addresses a bug during checkout at the time the order is saved. This was added to the “Just In” support section on our website on 02.16.2012.
  • ShipRates.asp
    USPS no First-Class rates returned bug. This was added to the “Just In” support section on our website on 01.24.2012.

pcadmin

  • AdminEditOrder.asp, checkRealtimeRates.asp
    Fixed a bug where the choosen shipping service was reset during the editing of an order.
  • ClearUPSSessions.asp, OrdDetails.asp
    Fixed a bug that caused UPS label details to be carried over to the next label when generating labels one after the other during the same session.
  • ConfigureOption5.asp, sds_ShipOrderWizard1.asp, viewShippingOptions.asp
    Updated for Phase II of the FedEx Web Services integration

QR Code
QR Code ProductCart v4.6 Update Guide (generated for current page)