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

 Magic Thumb™
 osCMax module version v4.9.1 [v1.6.103:v3.0.20]

 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 an earlier version of Magic Thumb, remove it.

2. Backup the following files, then rename them by adding a suffix "_original" to the filename, e.g. application_top.php become application_top_original.php

  - includes/application_top.php
  - includes/application_bottom.php
  - includes/modules/product_listing.php
  - includes/modules/product_listing_col.php
  - includes/modules/new_products.php
  - includes/boxes/reviews.php
  - includes/boxes/specials.php
  - includes/boxes/whats_new.php

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

  * YOUR-ADMIN-FOLDER

4. Upload the contents of the 'catalog' directory to your osCMax directory to their respective folders.

5. If you use the osCMax STS module, edit sts.php file as below (otherwise, skip this step).

5.1. Backup your /includes/classes/sts.php file.

5.2. Open the file /includes/classes/sts.php in the editor and find following code lines:

  foreach ($this->template as $key=>$value) {
    $this->template['template_html'] = str_replace('$' . $key . STS_END_CHAR , $value, $this->template['template_html']);
  }

and add these 3 lines before it:

  require_once(DIR_WS_MODULES.'magicthumb/magicthumb.php');
  $this->template['content'] = MagicThumb($this->template['content']);
  $this->template['template_html'] = MagicThumbSTSHead($this->template['template_html']);

6. If the version of your osCMax is lower than 2.5.0, do the following (otherwise, skip this step):

6.1. Backup your admin/includes/column_left.php file.

6.2. Open admin/includes/column_left.php in the editor and find this line (at the end of file):

    ?>

and add these lines before it:

    // ADDED: Magic Toolbox
    if(tep_admin_check_boxes('magictoolbox.php') == true) {
      require(DIR_WS_BOXES.'magictoolbox.php');
    }

6.3. Backup your admin/index.php file.

6.4. Open admin/index.php in the editor and find these lines:

?>
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN">

and add this line before them:

  include('includes/boxes/magictoolbox.php');

7. If the version of your osCMax is 2.5.0 or above, do the following (otherwise, skip this step):

7.1. Backup your admin/includes/menu.php file.

7.2. Open admin/includes/menu.php in the editor and find this line (at the end of file):

  </ul>

and add these lines before it:

  <!-- MAGICTOOLBOX -->
  <?php
    if (tep_admin_check_boxes('magictoolbox.php') == true) { ?>
      <li>
        <a href="#">Magic Toolbox</a>
          <ul>
             <?php require(DIR_WS_BOXES . 'magictoolbox.php'); ?>
          </ul>
      </li>
  <?php } ?>

8. Apply the install.sql file to your database using phpMyAdmin or other MySQL tools.

9. If the version of your osCMax is lower than 2.5.0, apply the install_2.0.x.sql file to your database using phpMyAdmin or other MySQL tools.

10. If you use the osCMax version 2.5.0 or above, apply the install_2.5.x.sql file to your database using phpMyAdmin or other MySQL tools.

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

12. Magic Thumb is ready to use!

13. To upgrade your version of Magic Thumb (which removes the "Please upgrade" text), buy Magic Thumb and overwrite the includes/modules/magicthumb/core/magicthumb.js file file with the new one in your licensed version.

Buy a single license here:

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

