ClickCartPro - Upgrading From Version 5.x
This wiki entry details the upgrade process for users who wish to upgrade from ClickCartPro 5.x versions to ClickCartPro 6.
The upgrade process requires a new install of the Kryptronic Hybrid X Core (KHXC) and ClickCartPro 6 (installed on top of / with the KHXC). Because of the vast differences between ClickCartPro 5.x and ClickCartPro 6, a new installation is required and should not be done as an 'overwrite'. This will give you time to test changes and publish the site when you're ready.
Visit www.kryptronic.com and purchase an upgrade version of ClickCartPro 6.
Install the KHXC and ClickCartPro 6. This is done using the web-based KHXC installer. ClickCartPro 6 is automatically installed when the KHXC is installed, provided you purchased a ClickCartPro license. This installation should be done in directories not associated with your 5.x installation. When configuring your database for the KHXC, you can use the same database you used for ClickCartPro 5.x (if you used an advanced RDBMS like MySQL and not CSV files) - none of the tables have the same names. It is recommended, however that you use a clean database.
Download and run the ClickCartPro 5.x to ClickCartPro 6 data importer from the following URL:
Follow the instructions in the README.pdf file for running the importer. This importer will import the following items from your ClickCartPro 5.x install into ClickCartPro 6. You have the option for each of these items to import them or to skip the import of each particular item listed:
- Imports Software Settings
- Imports Media Files (CCP5.x site, product and category image files, download source files, etc.)
- Imports Customer Accounts
- Imports Affiliate Accounts
- Imports Maillist Subscribers (by creating an account for them and assigning a random password)
- Imports Online Store Categories
- Imports Online Store Products
- Imports Online Store Product Options
- Imports Dynamic Forms
- Imports Orders and Order Items
- Imports Discount Codes
- Imports HTML Pages (User Defined)
- Imports the HTML Site Layout (creates a skin based on the CCP5.1 layout)*
*Please Note: This HTML site layout to skin conversion is to be considered experimental and may or may not produce desired results and almost certainly will not product standards compliant output due to the fact that the KHXC is written in PHP using XHTML Strict displays with CSS and CCP5.1 is written in Perl using non-standards compliant HTML.
Test your new ClickCartPro 6 installation and modify as needed to get ready to launch in a production environment. This may only take a couple of hours or may take a long time depending on how many modifications you wish to do before launch.
Redirect any links pointing to your ClickCartPro 5.x installation to your ClickCartPro 6 installation on your static HTML pages for your website. This will make ClickCartPro 6 live. Once ClickCartPro 6 is live, you can safely delete your ClickCartPro 5.x installation. You may wish to use Apache mod_rewrite rules in a .htaccess file in your root web directory to rewrite any old 5.x URLs to direct them to ClickCartPro 6. This will ensure search engine links and the like will continue to work appropriately. The following rewrite rules work great:
RewriteRule ^ccp51/cgi-bin/cp-app.cgi khxc/index.php?app=ccp0 [L,PT]
RewriteRule ^ccp51/cgi-bin/cp-app.cgi?(.*) khxc/index.php?app=ccp0 [L,PT]
ErrorDocument 404 http://www.yourdomain.com/khxc/index.php?app=ccp0
Wiki: ClickCartPro 6