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

 Magic Slideshow™
 osCommerce module version v4.9.1 [v1.6.103:v3.2.12]

 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 Slideshow, 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

  NOTE: skip files in includes/boxes folder if you use osCommerce version 2.3.0 or above

  - includes/application_top.php
  - includes/application_bottom.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 osCommerce directory to their respective folders.

5. If you use the osCommerce 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.'magicslideshow/magicslideshow.php');
  $this->template['content'] = MagicSlideshow($this->template['content']);
  $this->template['template_html'] = MagicSlideshowSTSHead($this->template['template_html']);

6. If the version of your osCommerce is lower than 2.3.3.3, 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:

    include(DIR_WS_BOXES . 'tools.php');

and add this line after it:

    include(DIR_WS_BOXES . 'magictoolbox.php');

7. If you use the osCommerce version 2.3.0 or above, do the following (otherwise, skip this step):

7.1. Backup your includes/classes/osc_template.php file.

7.2. Open includes/classes/osc_template.php in the editor and find this line:

    $mb->execute();

and replace it with these lines:

    $block_count = count($this->_blocks[$mb->group]);
    $mb->execute();
    if($block_count != count($this->_blocks[$mb->group]))
        magicslideshowProcessBlock($class, $mb->group, $this);

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

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

10. Magic Slideshow is ready to use!

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

Buy a single license here:

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

