Table of Contents

ProductCart v4 - Patch #3 (Service Pack 3)

Overview

This patch was released on 12/05/09. It addresses all known issues found in ProductCart v4.0 between the initial release and 12/04/09. See the section below for details on which files were updated.

Security Issues

This update addresses a few security issues that were recently discovered. Therefore, we recommend that it is applied to your ProductCart-powered store as soon as possible.

Do you need it?

If your ProductCart version number contains “SP 3” (service pack #3), then you do not need this patch. Otherwise, you need to apply it to your store.

Do you also need Patch #1 and or Patch#2?

No, this is a cumulative “Service Pack”. To simplify things, we included all files that were updated since the release of ProductCart v4. So it includes Patch #1 and Patch #2. You do not need to worry about applying previously released patches. Just apply this patch and you will be using the latest files.

Downloading the Update File

You can download the update by using the “Check for Updates” feature in your ProductCart Control Panel, or you can download it by clicking on the file names in the table below.

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.

You are running v4 Upgrade File Name
ProductCart Standard ProductCart_v4_SP3_120409
ProductCart Standard + Apparel Add-on ProductCart_v4_SP3_APP_120409
ProductCart Build To Order ProductCart_v4_SP3_BTO_120409
ProductCart Build To Order + Apparel Add-on ProductCart_v4_SP3_BTO_APP_120409
ProductCart Build To Order + Conflict Management ProductCart_v4_SP3_BTO_CM_120409
ProductCart Build To Order + Conflict Management + Apparel Add-on ProductCart_v4_SP3_BTO_CM_APP_120409

If you believe that the ProductCart Update Management System is not providing you with the correct file set, please open a support ticket. If you do not see the v4 SP3 Update when you “Check for Updates”, even if it has officially been announced, then make sure that your license is eligible for Software Updates.

Unzipping the Downloaded Files

Updated Files

In addition to the files that were updated with Patch #1 and Patch #2, the following files will be updated. This area is still being updated with file names and references.

includes/

pc/

pcadmin/

Performing the update

Other Add-on's

If you are also using…

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.

Synchronize overwritten files

The following files are often customized by ProductCart users and will be overwritten with this patch (see how to synchronize files):

For users of the Keyword Rich URLs feature (or “SEO files”). The file 404b.asp is also overwritten by this patch. This should not affect any stores since this file does not need to be edited in version 4. However, if you manually edited the file to hardcode the location of your “404 - Page Not Found” page, go to Settings > Store Settings > Miscellaneous, turn on the Keyword Rich URLs feature (if not already on) and enter the path to the file (e.g. ”/my404page.html”). You do not need to manually edit 404b.asp in ProductCart v4 (unlike in v3). The location of the “Page Not Found” page will be retrieved from your store settings.

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.

Confirm successful transfer

FTP transfers sometimes fail. 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. For example, Filezilla separately reports “Failed Transfers” and “Successful Transfers”. The “Failed Transfers” tab should be empty.

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 “upddb-PayPal-AB.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 store database and version number have been updated. If there are any “To Do” items, they will be mentioned here. One important To Do item is the following:

Step 7 - 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.

New version number (service pack)

Starting with this Patch, we will add an identifier to the version number of a ProductCart store that has applied a Patch. Since these patches can contain both files and database updates, we will call them “service packs”, just like other large software companies do :-)

Your ProductCart store version number after applying this patch with include “SP 3” to indicate that you applied this service pack.