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 v3.5 Update Guide

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 3.5 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

Applicability

The v3.5 update requires that you are running ProductCart v3.11 or v3.12.

If you are running a previous version, you must update your store to version 3.11 before proceeding (version 3.12 was an “in-between” release used for new installations only - so there is no update to version 3.12).

Any download of the files now, will automatically be the V3.51 version, which includes all the V3.5 files, in a consolidated download, to simplify the upgrade process.

New Features and Bug Fixes

The 3.5 update adds new features and addresses all outstanding issues that NetSource Commerce is aware of in ProductCart v3.11 and v3.12.

Backing Up Your Store

Make sure that you back-up your store before proceeding. This is a crucial step of the store update process.

  • The backed-up version of the files listed below under “Overwritten Files” will help you update those files with your changes as you can synchronize the new files with the old ones (e.g. re-adding the text strings you had modified).

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 3.5 Update from UMS Check for updates in the CP
BTO 3.5 Update from UMS Check for updates in the CP
STD + APP 3.5 Update from UMS Check for updates in the CP
BTO + APP 3.5 Update from UMS Check for updates in the CP
BTO + CM 3.5 Update from UMS Check for updates in the CP
BTO + APP + CM 3.5 Update from UMS Check for updates in the CP
Other Add-on's and files
Google Analytics 3.5 Google Analytics files Get the 3.5-compatible files
SEO 3.5 SEO files Get the 3.5-compatible files
MailUp 3.5 MailUp Integration Files Get the 3.5-compatible files
eBay Add-on No specific update needed for version 3.5 (no overlapping files).
However, we recommend that you download the latest files as there have been some recent bug fixes and feature updates.
QuickBooks Add-on No specific update needed for version 3.5



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.
  • SEO = You are using the files that allow for keyword-rich URLs

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.

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_v3.5_Update_date
  • If you are running the BUILD TO ORDER version of ProductCart, the file that you downloaded should be named: ProductCart_v3.5_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_v3.5_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_v3.5_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_v3.5_Update_APP_CM_date

Unzipping the Downloaded Files

  • Unzip the files to a new directory on your desktop (e.g. “3.5 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

Some of the files contained in the ProductCart v3.5 update overwrite files that you have likely customized. These include:

  • pc/include-metatags.asp
    This contains your default meta tags. The file will be overwritten during the update. You will need to add your default meta tags to the new version of the file. You should do this before transferring the new files to your Web server. That is:
    • Locate the new version of the file in the pc subfolder of the file set you will be using to update your store, which you have located using the information above.
    • Edit the file by updating the default meta tags (you can copy and paste your default meta tags from the old version of the file).
    • Save the edited file. It will be uploaded to your Web server with the rest of the updated files.
  • pc/orderComplete.asp
    This file typically contains tracking code for advertising system like Google AdWords. The file will be overwritten during the update. We recommend that you do the following before transferring the new files to your Web server:
    • Locate the file orderCompleteTracking.asp in the pc folder of the file set you will be using to update your store, which you have located using the information above. This is a new file: it did not exist before and was created specifically for hosting any tracking code you may have.
    • Open the file in Notepad or your favorite HTML editor.
    • Read the comments included in the page itself.
    • Copy your tracking code from the old version of orderComplete.asp (the file backed up from your store prior to the 3.5 update) to the new orderCompleteTracking.asp file, where indicated in the code. More information.
    • Save the edited file. It will be uploaded to your Web server with the rest of the updated files.
  • includes/languages.asp
    This file contains most text strings shown in the storefront, and it is often edited by ProductCart users. Synchronize your current version of the file (locate it in your back-up files) with the new version that you have downloaded. See below about synchronizing files.

Synchronizing Overwritten Files

As noted above, this update contains files that you have likely modified (e.g. includes/languages.asp, pc/orderComplete.asp, pc/include-metatags.asp).

See File Comparisons and Synchronizations for tips on how to compare and synchronize your edited files.

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.

The ProductCart v3.5 update contains hundreds of files and the FTP upload will take several minutes. Make sure that once the process has finished, your FTP client reported a success message. Most FTP programs have a way to show you whether some files were not uploaded successfully. If that happens, make sure to upload them again until all files have been uploaded successfully.

Step 4 - Update the Store Database

  1. Log into the Control Panel
  2. You will be automatically redirected to the database update page.
    Troubleshooting:
    1. If you are not automatically redirected, replace “menu.asp” with “upddb35.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.
  4. You will then be prompted to run a second script which updates your database to prepare it for a new feature that is part of version 3.5: unlimited Custom Search Fields. This feature required a structural database change and some of you existing product information will be transferred to new tables in your store database.

Step 5 - TO DO List

A message will confirm that the store database and version number have been updated.

A “To Do” list will remind you of a actions that you need to take that are also covered in this document. See the “To Do Items” above.

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 and open 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 v3.5 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.


QR Code
QR Code ProductCart v3.5 Update Guide (generated for current page)