
 ******************************************************************************************
                        iScripts Multicart 3.1 Readme File

                                February  16, 2016

 ******************************************************************************************

 (c) Copyright Armia Systems,Inc 2005-15. All rights reserved.


 This file contains information that describes the installation of iScripts Multicart 






 ******************************************************************************************

 Contents

 ******************************************************************************************

 1.0 Introduction

 2.0 Requirements

 3.0 Installing iScripts Multicart

 4.0 Upgrading from  1.0 To Multicart 2.4

 5.0 Upgrading from  2.0 To Multicart 2.4

 6.0 Upgrading from  2.1 To Multicart 2.4

 7.0 Upgrading from  2.2 To Multicart 2.4

 8.0 Upgrading from  2.3 To Multicart 2.4

 9.0 Upgrading from  2.5 To Multicart 2.6

 10.0 Upgrading from  2.6 To Multicart 3.0

 11.0 Upgrading from  3.0 To Multicart 3.1

 12.0 Adding a custom theme

 13.0 Setting up a cron

 14.0  Note for Upgrading


 ******************************************************************************************

 1.0 Introduction
  
 ******************************************************************************************

 This file contains important information you should read before installing iScripts

 Multicart.


 The iScripts.com Multicart enables any web master to offer multi-storefront from his/her website/server.


 For any support visit us at http://www.iscripts.com/support/kb/


 ******************************************************************************************

 2.0 Requirements

 ******************************************************************************************

 The iScripts Multicart is developed in PHP and the database is MySQL. 



 The requirements can be summarized as given below:


	 1. PHP > 4.3.10 

		You can get the latest PHP version at http://www.php.net


	2. MySQL > 3.x.x

	3. Curl Support (In case you are using Authorize.net payment gateway)





 ******************************************************************************************

 3.0 Installing iScripts Multicart

 ******************************************************************************************

 3.1) Unzip the entire contents to a folder of your choice.

	a) Upload the contents to the server to the desired folder using an FTP client. If you do not 		   
           have a FTP client we suggest  CoreFTP or FTPzilla


 3.2) Set 'Write' permission to the following folders.



	a) products

	b) portfolios
	
	c) products/bulk_images

	d) pem

	e) banners

	f) digital_product

	g) csv 

	h) products/zip
        
        i) homepagebanners

        j) sellerbanners

        k) categories/avatar

        l) categories



 3.3) Provide 'Write' permission for the following files.


 
	a) includes/config.php 

        b) .htaccess
		



 3.4) Run the following URL in your browser and follow the instructions.

		
	http://www.yoursitename/install/
		


	If you have uploaded the files in the root (home directory), you can access the iScripts
	Multicart install wizard at http://www.yoursitename
		


	You can also install the script in any directory under the root. For example if 
	you have uploaded the zip file in a directory like http://www.yoursitename/Multicart
	then you can access the iScripts Multicart site at http://www.yoursitename/Multicart
		


	In the installation step, please provide the site url as described above, without
	any trailing slashes.
		


	Make sure you enter the same license key you received at the time of purchase,in the 
	"License Key" field. The script would function only for the domain it is licensed. If you 		
        cannot recall the license its also included in the email you received with subject: 			
        iScripts.com software download link. You can also get the license key from your user panel		
       at www.iscripts.com


	
 3.5) Remove the 'Write' permission provided to the file 'includes/config.php'.


 3.6) Delete the 'install' folder. 


 3.7) Change the settings to match your specific requirements 
	at http://www.your-install-directory/admin/





 ******************************************************************************************

 4.0 Upgrading from  1.0 To Multicart 2.4

 ******************************************************************************************

 4.1) Take the backup of your existing Multicart 1.0 Files and Database.(make sure to    
   
      keep backup of products, banners,digital_product,portfolios folders).



 4.2) Copy the files and folder from the newly purchased pack to your existing site folder.



 4.3) Overwrite all files and folder except the file 'includes/config.php'.



 4.4) Run the following URL in your browser and follow the instructions.
		
		http://www.yoursitename/upgrade/



 4.5) Cross check your existing files and database with the upgraded one.

 4.6) Copy products, banners,digital_product,portfolios folders from the backup of Multicart 1.0 to your existing site folder. 

 ******************************************************************************************

 5.0 Upgrading from  2.0 To Multicart 2.4

 ******************************************************************************************

 5.1) Take the backup of your existing Multicart 2.0 Files and Database.(make sure to keep 

      backup of  products, banners,digital_product,portfolios folders).



 5.2) Copy the files and folder from the newly purchased pack to your existing site folder.



 5.3) Overwrite all files and folder except the file 'includes/config.php' and banners/logo.gif.



 5.4) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade2.0/



 5.5) Cross check your existing files and database with the upgraded one.


 5.6) Copy products, banners,digital_product,portfolios folders from the backup of Multicart 2.0 to your existing site folder.


 ******************************************************************************************

 6.0 Upgrading from  2.1 To Multicart 2.4

 ******************************************************************************************

 6.1) Take the backup of your existing Multicart 2.1 Files and Database.(make sure to keep 

      backup of products, banners,digital_product,portfolios folders).



 6.2) Copy the files and folder from the newly purchased pack to your existing site folder.



 6.3) Overwrite all files and folder except the file 'includes/config.php' and banners/logo.gif.



 6.4) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade2.1/



 6.5) Cross check your existing files and database with the upgraded one.

 6.6) Copy products, banners,digital_product,portfolios folders from the backup of Multicart 2.1 to your existing site folder.

******************************************************************************************

 7.0 Upgrading from  2.2 To Multicart 2.4

 ******************************************************************************************

 7.1) Take the backup of your existing Multicart 2.2 Files and Database.(make sure to keep 

      backup of products, banners,digital_product,portfolios folders).



 7.2) Copy the files and folder from the newly purchased pack to your existing site folder.



 7.3) Overwrite all files and folder except the file 'includes/config.php' and banners/logo.gif.



 7.4) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade2.2/



 7.5) Cross check your existing files and database with the upgraded one.


 7.6) Copy products, banners,digital_product,portfolios folders from the backup of Multicart 2.2 to your existing site folder.



******************************************************************************************

 8.0 Upgrading from  2.3 To Multicart 2.4

 ******************************************************************************************

 8.1) Take the backup of your existing Multicart 2.3 Files and Database.(make sure to keep 

      backup of products, banners,digital_product,portfolios folders).



 8.2) Copy the files and folder from the newly purchased pack to your existing site folder.



 8.3) Overwrite all files and folder except the file 'includes/config.php' and banners/logo.gif.



 8.4) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade2.3/



 8.5) Cross check your existing files and database with the upgraded one.


 8.6) Copy products, banners,digital_product,portfolios folders from the backup of Multicart 2.3 to your existing site folder.


******************************************************************************************

 

 9.0 Upgrading from  2.5 To Multicart 2.6

 ******************************************************************************************

 9.1) Take the backup of your existing Multicart 2.5 Files and Database.(make sure to keep 

      backup of includes/config.php ,.htaccess , products, banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders).



 9.2) Copy the files and folder from the newly purchased pack to your existing site folder.

 9.3) Overwrite all files and folders 

 9.4) copy includes/config.php , .htaccess files  from the backup of Multicart 2.5 to your existing site folder

 9.5) Copy images from the backup of Multicart 2.5  'products'  folder except 'noimage.jpg' to your existing products folder in your site .

 9.6) Copy  banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders from the backup of Multicart 2.5 to your existing site folder.
 
 9.6) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade2.6/

 9.8) Cross check your existing files and database with the upgraded one.
 
******************************************************************************************


 10.0 Upgrading from  2.6 To Multicart 3.0

 ******************************************************************************************

 10.1) Take the backup of your existing Multicart 2.6 Files and Database.(make sure to keep 

      backup of includes/config.php , .htaccess,products, banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders).

 10.2) Copy the files and folder from the newly purchased pack to your existing site folder.

 10.3) Overwrite all files and folders.

 10.4) copy includes/config.php , .htaccess files  from the backup of Multicart 2.6 to your existing site folder

 10.5) Copy images from the backup of Multicart 2.6  'products'  folder except 'noimage.jpg' to your existing products folder in your site .

 10.6) Copy  banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders from the backup of Multicart 2.6 to your existing site folder.
 
 10.7) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade3.0/

 10.8) Cross check your existing files and database with the upgraded one.
 
******************************************************************************************

 
 11.0 Upgrading from  3.0 To Multicart 3.1

 ******************************************************************************************

 11.1) Take the backup of your existing Multicart 3.0 Files and Database.(make sure to keep 

      backup of includes/config.php , .htaccess,products, banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders).

 11.2) Copy the files and folder from the newly purchased pack to your existing site folder.

 11.3) Overwrite all files and folders.

 11.4) copy includes/config.php , .htaccess files  from the backup of Multicart 3.0 to your existing site folder

 11.5) Copy images from the backup of Multicart 3.0  'products'  folder except 'noimage.jpg' to your existing products folder in your site .

 11.6) Copy  banners,digital_product,portfolios,homepagebanners,sellerbanners,categories folders from the backup of Multicart 3.0 to your existing site folder.
 
 11.7) Run the following URL in your browser and follow the instructions.
		
	http://www.yoursitename/upgrade3.1/

 11.8) Cross check your existing files and database with the upgraded one.
 
******************************************************************************************

 12.0 Adding a custom theme

 ******************************************************************************************

 12.1) Create a new folder with the name of the new theme in the themes folder



 12.2) Copy the contents of an existing theme to this new folder and alter them

      to suit your needs



 12.3) The copied style.css could be edited to give a the appearance changes



 12.4) Replace the image preview.gif with the new preview image. 

 
 ******************************************************************************************
 
 13.0 Setting cron jobs

 ******************************************************************************************
	
 
 13.1) If seller plans is enabled, for sending notification regarding plan expiry  run the following files at 1 A.M daily.


	a)  http://www.yoursitename/cron/cron_seller_plan_upgrade-expiry.php


          an example could be  

	    /usr/bin/php -q /home/multicart3.1/public_html/yourinstallationfolder/cron/cron_seller_plan_upgrade-expiry.php



13.2) Update product quantity, if user does not purchase a product after adding to cart at 1 A.M daily.

	a)  http://www.yoursitename/cron/cron_upate_sale_quantity_not_purchased.php


          an example could be  

	    /usr/bin/php -q /home/multicart3.1/public_html/yourinstallationfolder/cron/cron_upate_sale_quantity_not_purchased.php


13.3) To update currency rates hourly, run the cron every hour daily.

	a)  http://www.yoursitename/cron/currency_list_updation.php


          an example could be  

	    /usr/bin/php -q /home/multicart3.1/public_html/yourinstallationfolder/cron/currency_list_updation.php

13.4)To download & resize product images from external URL, run the cron in every 5 minutes,each day, each month

	a)  http://www.yoursitename/cron/download_bulkupload_images.php


          an example could be  

	    /usr/bin/php -q /home/multicart3.1/public_html/yourinstallationfolder/cron/download_bulkupload_images.php


13.5)To publish products on a future date , run the cron in every 15 minutes,each day, each month

	a)  http://www.yoursitename/cron/publish_scheduled_products.php


          an example could be  

	    /usr/bin/php -q /home/multicart3.1/public_html/yourinstallationfolder/cron/publish_scheduled_products.php



14 ) Note : Following things after upgrading to multicart 3.1

14.1 ) Edit/update each existing coupon code and select the respective seller to which the coupon code is applied.

14.2 ) All cart data will be emptied, so no items will be shown in cart for existing users.
