#######################################################

 Magic Zoom™
 Zen Cart module version v4.6.17 [v1.6.103:v5.3.7]

 www.magictoolbox.com
 support@magictoolbox.com

 Copyright 2025 Magic Toolbox

#######################################################

INSTALLATION:

IMPORTANT: Before you start, we recommend you open readme.txt and follow those instructions. It is faster and easier than these readme_manual.txt instructions. If installation failed using the readme.txt procedure, then continue with these instructions instead.

1. If you already have installed a previous version (lower than 4.3) of the Magic Toolbox modules, uninstall it.

2. Extract the contents of the zip file to your computer, keeping the file structure intact.

3. Rename the following folders to match your template folder name:

  * includes\modules\YOUR-TEMPLATE-FOLDER
  * includes\templates\YOUR-TEMPLATE-FOLDER

4. Rename the following folder to match your admin folder name:

  * YOUR-ADMIN-FOLDER

5. Make a backup of the following files, if they already exist in your store, then rename them by adding a suffix '_original' to the filename
    (e.g. 'tpl_modules_main_product_image.php' become 'tpl_modules_main_product_image_original.php')

    NOTE: if you have installed another Magic Toolbox module, skip files that are already backed up and renamed

  * includes/modules/YOUR-TEMPLATE-FOLDER/additional_images.php
  * includes/modules/YOUR-TEMPLATE-FOLDER/product_listing.php
  * includes/modules/YOUR-TEMPLATE-FOLDER/new_products.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/templates/tpl_modules_main_product_image.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/templates/tpl_modules_products_new_listing.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/templates/tpl_modules_products_all_listing.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/sideboxes/tpl_featured.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/sideboxes/tpl_specials.php
  * includes/templates/YOUR-TEMPLATE-FOLDER/sideboxes/tpl_whats_new.php

6. Upload the admin and 'include' folders to your Zen Cart shop directory.

7. Apply the install.sql file to your database using your Zen Cart admin (Admin panel -> Tools -> Install SQL Patches) or other MySQL tools.

8. If you use Zen Cart v1.5.x or above then apply the install_menu.sql file to your database using your Zen Cart admin (Admin panel -> Tools -> Install SQL Patches) or other MySQL tools.

9. If the language of your admin interface is other than English then copy the file

    YOUR-ADMIN-FOLDER/includes/languages/english/extra_definitions/magiczoom.php

    to the folder

    YOUR-ADMIN-FOLDER/includes/languages/YOUR-ADMIN-INTERFACE-LANGUAGE/extra_definitions/

10. Go to [Admin panel -> Magic Toolbox -> Magic Zoom] and configure Magic Zoom how you want it.

11. Magic Zoom is ready to use!

12. To upgrade your version of Magic Zoom (which removes the "Please upgrade" text), buy Magic Zoom and overwrite the includes/templates/[your_template_folder]/jscript/magiczoom.js file file with the new one in your licensed version.

Buy a single license here:

http://www.magictoolbox.com/buy/magiczoom/

