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

 Magic Thumb™
 xtCommerce module version v3.4.4 [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. Unzip the zip file and upload the contents of 'module' folder to your xt:Commerce installation, keeping the file structure intact.

2. Backup your /product_info.php file.

3. Open the file /product_info.php in the editor.

4. Find a line:

    include ('includes/application_top.php');

and add this line after it:

    require_once(DIR_WS_MODULES . 'magictoolbox/core/magicthumb.php');

5. Find a line (at the end):

    include ('includes/application_bottom.php');

and add this line before it:

    MagicThumb();

6. Open the file /includes/modules/product_listing.php in the editor and find a line:

    $listing_split = new splitPageResults($listing_sql, (int)$_GET['page'], MAX_DISPLAY_SEARCH_RESULTS, 'p.products_id');

and add this before it:

    include(DIR_WS_MODULES . '/magictoolbox/core/magicthumb.php');

7. Insert the following line at the end of the file before the '?>' tag:

    MagicThumb();

8. If you want to use Magic Thumb on product reviews info page then do steps 2-5 with 'product_reviews_info.php' file.

9. Open the file /admin/includes/functions/general.php in the editor and find a line:

    function xtc_check_permission($pagename) {

and add this line after it:

    if($pagename == 'magicthumb') $pagename = 'modules';

10. Open the file /admin/includes/column_left.php in the editor.

11. Find this line:

    echo ('<div class="dataTableHeadingContent"><b>'.BOX_HEADING_MODULES.'</b></div>');

or this:

    echo ('<div class="menuBoxHeading"><b>'.BOX_HEADING_MODULES.'</b></div>');

and add this line after it:

    if(($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['modules'] == '1')) echo '<a href="' . xtc_href_link('magicthumb.php', '', 'NONSSL') . '" class="menuBoxContentLink"> -Magic Thumb</a><br>';

12. If you if you did not find line in the previous step, find these lines:

    echo ('<h2 class="boxheader">' . BOX_HEADING_MODULES . '</h2>');
    echo '<div class="boxbody"><ul class="contentlist">';

and add this line after it:

    if(($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['modules'] == '1')) echo '<li><a href="' . xtc_href_link('magicthumb.php', '', 'NONSSL') . '">' . xtc_image(DIR_WS_IMAGES . 'icon_arrow.gif') . 'Magic Thumb</a></li>';

13. Change the settings for Magic Thumb™ as you wish via the admin area (Modules -> Magic Thumb).

14. Magic Thumb is ready to use!

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

Buy a single license here:

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

