cartintegration:productcart:install

This is an old revision of the document!


ProductCart SubscriptionBridge Add-On - Installation Steps

Installing the SubscriptionBridge Add-On is very easy. The following assumes that you have installed and activated ProductCart on your Web server. If you haven’t done so, perform the ProductCart installation as described in the ProductCart Quick Start Guide, and then continue with the instructions below.

Choose the right folder

The file set that you will be using is different depending on whether:

  • You are using or not using the Apparel Add-on
  • You are using or not using the MailUp e-mail marketing system

A text file called “Applicability” is included in each folder and will confirm what those files are applicable to.

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. DO NOT delete any of the files that are currently on your Web server.

  • pc
    Many of the SB Add-On files will go into the pc folder. In most cases the new files will over-write existing files. If you are using customized files please backup your existing files before you upload the new files. See File Comparisons and Synchronizations for tips on how to compare and synchronize your edited files.
  • pcadmin
    Many of the SB Add-On files will go into the pcadmin folder. 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.
  • includes
    You will also be uploading files to the includes folder. Note that the file languages.asp in the includes folder will be overwritten, and this is a file that is often modified by ProductCart users. See File Comparisons and Synchronizations for tips on how to compare and synchronize your edited files.

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 your ProductCart Control Panel
  2. Load the following URL:
    www.yourstore.com/ProductCart/pcadmin/SB_Default.asp

    …where yourstore.com is the store URL, productcart is the name of the ProductCart folder (likely renamed on your store) and pcadmin is the name of the Control Panel, which has also, likely been renamed.

  3. You will be prompted to run the database update script
  4. Run the database update script

Troubleshooting

  • 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.
  • 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 - Turn your store back on

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.

Step 6 - Proceed to the Setup Wizard

Continue to the Setup Wizard to configure the subscription-related features.

cartintegration/productcart/install.1272390800.txt.gz · Last modified: 2011/03/01 23:00 (external edit)