SubscriptionBridge: recurring billing and subscription management system - Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 [[http://wiki.earlyimpact.com/quickstart/quickstart|ProductCart Quick Start Guide]], and then continue with the instructions below.



===== 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, [[http://wiki.earlyimpact.com/updates/how_to_backup|back-up your store]].



You will not need to turn your store off as the files you will be uploading to it will not interfere with your
 storefront.



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

  * **pcadmin** \\ Many of the SB Add-On files will go into the //pcadmin// folder. Please note that the //pcadmin// folder [[http://wiki.earlyimpact.com/how_to/rename_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 SB Add-on contains "**languages.asp**", which is often edited by ProductCart users. No lines where changed. A few lines were added. Make sure to synchronize the file with your version before overwriting your version.  See [[http://wiki.earlyimpact.com/developers/editcode#file_comparisons_and_synchronizations|File Comparisons and Synchronizations]] for tips on how to compare and synchronize your edited files.

pported versions).





===== Step 3 - Update the Store Database ===== 



  - Log into the your ProductCart Control Panel
  - Load the following URL: <code>www.yourstore.com/ProductCart/pcadmin/SB_Default.asp</code> ...where //yourstore.com// is the store URL, //productcart// is the name of the ProductCart folder ([[http://wiki.earlyimpact.com/how_to/rename_pcadmin_folder|likely renamed on your store]]) and //pcadmin// is the name of the Control Panel, which [[http://wiki.earlyimpact.com/how_to/rename_pcadmin_folder|has also, likely been renamed]].
  - You will be prompted to run the database update script
  - 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 [[https://www.earlyimpact.com/productcart/support/support_form.asp|open a Support Ticket]].



===== Step 4 - Proceed to the Setup Wizard ===== 



After completing these steps, the system will display a "No action to be taken" message, and you may continue to the [[cartintegration:productcart:setup|Setup Wizard]].