Image Handler5 for Zen Cart v1.5.7 (and later)

Version 5.3.5 by lat9, Zen4All, brittainmark, torvista, proseLA, marco-pm and pilou2

Current Support Thread at Zen Cart Forums: https://www.zen-cart.com/showthread.php?222983-Image-Handler-5-(for-v1-5-5)-Support-Thread

Notes:

  1. The majority of this readme, other than installation instructions and change history, has been migrated online to the plugin's GitHub repository. That enables the readme to be updated as-required without the need to provide a plugin update for documentation corrections.
  2. Change history prior to v5.0.0 of IH5 has been archived on the plugin's GitHub repository.
  3. As of IH5 v5.1.11, the minimum PHP version supported is PHP 5.6.
  4. As of IH5 v5.3.0, the minimum Zen Cart version supported is 1.5.7.

If you are using IH5 on a site that also uses SitemapXML and have configured SitemapXML to Add Products Images, you'll need to edit one of the SitemapXML's files to allow those images to be properly reported. Editing /includes/modules/pages/sitemapxml/sitemapxml_products.php, you'll see this code-block towards the top of the file:

define('SITEMAPXML_PRODUCTS_IMAGES_SIZE', 'large');
define('SITEMAPXML_PRODUCTS_IMAGES_ADDITIONAL', 'false'); // true false
define('SITEMAPXML_PRODUCTS_IMAGES_FUNCTION', 'false'); // true false

… and you'll make the highlighted change to instruct SitemapXML to use the built-in Zen Cart function to create the images' links:

define('SITEMAPXML_PRODUCTS_IMAGES_SIZE', 'large');
define('SITEMAPXML_PRODUCTS_IMAGES_ADDITIONAL', 'false'); // true false
define('SITEMAPXML_PRODUCTS_IMAGES_FUNCTION', 'true'); // true false

Overview

Image Handler5 (IH5) simplifies the management of product images (particularly additional product images) and helps to improve page performance by optimizing those images. Product images (based on your image settings) are created in the Image Handler5 bmz_cache directory. The original images are not modified, so it's perfectly safe to use on an existing store.

Image Handler5 enables you to use GD libraries or ImageMagick (if installed on your server) to generate and resize small, medium and large images on the fly as they're required. You can simply upload just one image or you can have different sources for medium and large images. Image Handler5 further enables you to watermark your images (overlay a second specific translucent image) and have medium or large images pop up when you move your mouse over a small image (fancy hover).

This contribution includes a powerful admin interface to browse your products just like you would with the Attribute Manager and upload, delete or add additional images without having to do this manually via FTP. IH5 works fine with mass update utilities like EZ-Populate and the Database I/O Manager (DbIo).

For additional information, please refer to the documentation on the plugin's GitHub repository; see above for the link.

This section identifies the procedure you'll use to install, upgrade or remove the plugin for your Zen Cart.

Requirements
  • Zen Cart v1.5.7 or later (not backwards compatible with older versions of Zen Cart).
  • PHP v5.6 or later (not backwards compatible with older versions of PHP).
  • Either GD libraries version 2 or greater, or ImageMagick version 6 or greater.
  • If you are using Fual Slimbox or ColorBox for Zen Cart with Image Handler5 you must read the "Misc" tab.

In order to resize and modify images, Image Handler5 needs either GD libraries or ImageMagick installed. You can check if your version of PHP includes the GD libraries by going to Admin > Tools > Server Info and searching for GD. You have to ask your host (or read your site's documentation) to learn about an ImageMagick installation.

If you want to render GIF images, you need to have GD libraries version 2.0.28 or newer installed.

Before You Install

The IH5 installation provides updates (see below for additional information) for two of the more popular large-image viewers: Fual Slimbox and ColorBox for Zen Cart. Those updates contain plugin-specific modules that work in conjunction with the newly-added IH5 "notifiers".

What all that techno-babble means for your IH5 installation (or upgrade!) is that there are two installation routes, dependent on whether you use a large-image viewer and, if so, which one …

Regardless the route you choose, I highly recommend an initial installation on a development version of your site. If you are serious about running your store it is always worth having a second version of the store so that you can experiment on that first. I know that this seems like a lot of work but it really is worth it and does not actually take that much time.

Route 1

This route works for IH5 installation/upgrade into stores that have either no modifications or only Fual Slimbox or ColorBox changes to those two template-override files.

Just install or upgrade Image Handler5 — see below — and it will work. If your admin is in a language other than english then read further down for additional instructions.

Route 2

This route works for stores that have additional changes (i.e. another large-image viewer) or if you are unsure of the changes to those two template-override modules.

Review the installation instructions below. Once you have unzipped the IH5 package, use a file-comparison program (like WinMerge or Beyond Compare) to merge the template-override changes required by IH5 with your template's pre-existing changes.

Fual Slimbox or ColorBox for Zen Cart with Image Handler5

Both of these plugins provide a large-image popup using jQuery methods and are pre-integrated with IH5. IH5 was validated using Fual Slimbox v2.0.1a and ColorBox for Zen Cart v2.1.1 on Zen Cart 1.5.5e.

When your store is using IH5 along with one of these plugins, the order in which the plugin and IH5 are installed is important:

If your store … … then …
… has an existing installation of either large-image popup plugin … Install IH5 as if you had a "fresh" Zen Cart installation, overwriting (or creating) the two template-override files required by IH5.
… has an existing installation of IH5 and you are now going to install one of the large-image popup plugins … Install the large-image popup as instructed but do not overwrite the two template-override files in the /includes/modules sub-directory. The base zc156b+ installation already includes modules that enable that large-image popup to do its thing.
… has neither IH5 nor an existing large-image popup plugin … Install IH5, copying all its distributed files, then proceed to install the large-image popup plugin as described above.

IH5's distribution contains the following files that provide its interoperability with these two large-image popup plugins. If your store uses a different popup plugin, you'll need to review the code associated with one of the plugin integrations provided.

Plugin Name /includes/auto_loaders File /includes/classes/observers File
Fual Slimbox config.fual_slimbox.php FualSlimboxObserver.php
ColorBox config.colorbox.php ColorBoxObserver.php
Installation/Upgrade Instructions
  1. BACK UP your database & store.
  2. BACK UP your database & store!!!!!
  3. BACK UP your database & store!!!!!
  4. Unzip the Image Handler5 package to your local hard drive, retaining the directory structure.
  5. Rename the YOUR_ADMIN directory to match the name of your Zen Cart admin directory.

    IMPORTANT!!!: If your shop is using languages other than english, you must also copy the contents of the YOUR_ADMIN/includes/languages/english directory to YOUR_ADMIN/includes/languages/YOUR_LANGUAGE for each additional language.
  6. Once you've gotten any file-merge changes completed (i.e. you're using installation route 2), log in to your store's admin.
  7. Next, using an FTP program, upload the files from the following distribution sub-directories:
    1. bmz_cache
    2. images
    3. includes
    4. YOUR_ADMIN (renamed)
  8. Return to your store's admin and click on any link. If you followed the instructions above, you will see a message in the message stack at the top of your admin screen confirming a successful install or upgrade.
  9. Navigate to Admin > Configuration > Images, set IH resize images to yes.
  10. If you followed all instructions to the letter, you are ready to move on to the online documentation to learn how to modify the default configuration settings.

Un-Install Instructions

Note: IH5's uninstall processing is provided as a separate script, so you can use your admin's Admin / Admin Profiles tool to restrict its usage to authorized admin-users.

  1. BACK UP your database and store.
  2. Log into your Zen Cart admin and navigate to Tools > Image Handler5 and:
    • Click the "Admin Tools" link at the top of the page.
    • Click the "Uninstall Image Handler" link at the top of the page.
    • You'll be presented an Uninstall Image Handler page. To continue with the uninstall, click the "Go" button; to cancel, click the "Cancel" button.
    • You'll be presented a confirmation page. Click "Go" one more time and the uninstall script will remove all files (except for the list below) in the IH5 distribution as well as the changes it makes to the database.
    The following files remain after IH5 is uninstalled:
    1. /includes/auto_loaders/config.colorbox.php (remains only if ColorBox is installed)
    2. /includes/auto_loaders/config.fual_slimbox.php (remains only if Fual Slimbox is installed)
    3. /includes/classes/observers/ColorBoxObserver.php (remains only if ColorBox is installed)
    4. /includes/classes/observers/FualSlimboxObserver.php (remains only if Fual Slimbox is installed)

This section identifies the files added or modified for this plugin as well as the plugin's change history.

The plugin provides the following files in its distribution zip-file.

File Name Comments
/bmz_cache/.htaccess  
/images/watermark.png  
/images/medium/watermark_MED.png  
/images/large/watermark_LRG.png  
/includes/auto_loaders/config.colorbox.php Added in v5.0.0.
/includes/auto_loaders/config.fual_slimbox.php Added in v5.0.0.
/includes/auto_loaders/config.image_handler.php Added in v5.0.0.
/includes/classes/bmz_gif_info.class.php Unused, removed in v5.2.0.
/includes/classes/bmz_image_handler.class.php  
/includes/classes/observers/ColorBoxObserver.php  Added in v5.0.0.
/includes/classes/observers/FualSlimboxObserver.php Added in v5.0.0.
/includes/classes/observers/ImageHandlerObserver.php Added in v5.0.0.
/includes/extra_configures/bmz_image_handler_conf.php  
/includes/extra_configures/bmz_io_conf.php  
/includes/extra_datafiles/image_handler_logging.php Added in v5.1.0.
/includes/functions/extra_functions/functions_bmz_image_handler.php  
/includes/functions/extra_functions/functions_bmz_io.php  
/includes/modules/YOUR_TEMPLATE/additional_images.php No longer distributed, as of v5.2.0.
/includes/modules/YOUR_TEMPLATE/main_product_image.php No longer distributed, as of v5.2.0.
/includes/templates/YOUR_TEMPLATE/css/style_imagehover.css Removed in v5.2.0.
/includes/templates/YOUR_TEMPLATE/jscript/jscript_imagehover.js Removed in v5.2.0.
/YOUR_ADMIN/image_handler.php  
/YOUR_ADMIN/image_handler_uninstall.php Added in v5.0.0.
/YOUR_ADMIN/image_handler_view_config.php Added in v5.0.1.
/YOUR_ADMIN/includes/ih_manager.php  
/YOUR_ADMIN/includes/auto_loaders/config.image_handler.php  
/YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php Added in v5.0.0. Contains functions used by image_handler.php, moved from that module.
/YOUR_ADMIN/includes/css/image_handler.css Added in v5.3.0.
/YOUR_ADMIN/includes/extra_configures/bmz_image_handler_conf.php  
/YOUR_ADMIN/includes/extra_configures/bmz_io_conf.php  
/YOUR_ADMIN/includes/extra_datafiles/image_handler.php  
/YOUR_ADMIN/includes/extra_datafiles/image_handler_admin_logging.php Added in v5.1.0.
/YOUR_ADMIN/includes/functions/extra_functions/functions_bmz_image_handler.php  
/YOUR_ADMIN/includes/functions/extra_functions/functions_bmz_io.php  
/YOUR_ADMIN/includes/init_includes/init_image_handler.php  
/YOUR_ADMIN/includes/languages/english/image_handler.php Added in v5.0.0.
/YOUR_ADMIN/includes/languages/english/image_handler_about.php Added in v5.0.1.
/YOUR_ADMIN/includes/languages/english/image_handler_uninstall.php Added in v5.0.0.
/YOUR_ADMIN/includes/languages/english/image_handler_view_config.php Added in v5.0.1.
/YOUR_ADMIN/includes/languages/english/extra_definitions/bmz_image_handler.php Comments only for v5.0.0; definitions moved to image_handler.php.
/YOUR_ADMIN/includes/languages/english/extra_definitions/bmz_language_admin.php Comments only for v5.0.0; definitions moved to image_handler_extra_definitions.php.
/YOUR_ADMIN/includes/languages/english/extra_definitions/image_handler_extra_definitions.php Added in v5.0.0.
  • v5.3.5, 2024-06-21:
    • BUGFIX: Correct product dropdown handling when products are misconfigured.
    • The following files were changed:
      1. /YOUR_ADMIN/includes/ih_manager.php
      2. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.3.4, 2023-07-02:
    • BUGFIX: Correct /bmz_cache/.htaccess for Apache 2.4 installations (pilou2).
    • The following files were changed:
      1. /bmz_cache/.htaccess
      2. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.3.3, 2023-04-26:
    • BUGFIX: Correct MySQL error on initial install due to unescaped single-quotes.
    • BUGFIX: Correct "Implicit conversion" PHP Warning.
    • The following files were changed:
      1. /includes/classes/bmz_image_handler.class.php
      2. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.3.2, 2023-03-07:
    • BUGFIX: Add support for webp images.
    • BUGFIX: Don't count on an image's extension identifying the image's type; check the image's type programmatically (brittainmark).
    • BUGFIX: Restore watermarks for all "Cache-file Naming Conventions" (was only working for Hashed.
    • The following files were changed or added:
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/functions/extra_functions/functions_bmz_image_handler.php
      3. /YOUR_ADMIN/image_handler.php
      4. /YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php
      5. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.3.1, 2022-11-18:
    • BUGFIX: Pre-declare all class-variables; PHP 8.2+ requirement.
    • BUGFIX: Don't process images, e.g. those with a .webp extension, that aren't resizeable via PHP built-in functions.
    • The following files were changed or added:
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/classes/observers/ImageHandlerObserver.php
      3. /includes/functions/extra_functions/functions_bmz_image_handler.php
      4. /YOUR_ADMIN/image_handler.php
      5. /YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php
      6. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      7. /YOUR_ADMIN/includes/languages/english/image_handler.php
  • v5.3.0, 2022-07-31:
    • BUGFIX: Ensure that images' width/height values are integer-type.
    • CHANGE: Removing 1_Installation_Files (v1.5.5) directory; all sub-directories moved to distribution 'root'.
    • BUGFIX: 'imagecolorallocatealpha' expects ints, but 'alphablend' returns floats; fatal PHP 8.1 error.
    • CHANGE: Updated to support zc157 and later as well as PHP 8.1.
    • BUGFIX: Properly handle corrupt image file.
    • BUGFIX: zc158 products' default sort is by products_model, use products_name instead.
    • The following files were changed or added:
      1. /includes/auto_loaders/config.image_handler.php
      2. /includes/classes/bmz_image_handler.class.php
      3. /includes/classes/observers/ImageHandlerObserver.php
      4. /YOUR_ADMIN/image_handler.php
      5. /YOUR_ADMIN/image_handler_uninstall.php
      6. /YOUR_ADMIN/image_handler_view_config.php
      7. /YOUR_ADMIN/includes/ih_manager.php
      8. /YOUR_ADMIN/includes/auto_loaders/config.image_handler.php
      9. /YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php
      10. /YOUR_ADMIN/includes/css/image_handler.css
      11. /YOUR_ADMIN/includes/functions/extra_functions/functions_bmz_image_handler.php
      12. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      13. /YOUR_ADMIN/includes/languages/english/image_handler.php
      14. /YOUR_ADMIN/includes/languages/english/image_handler_about.php
  • v5.2.0, 2021-11-25:
    • CHANGE: Various future-proofing refactors.
    • BUGFIX: Correct PHP errors when supplied image is missing.
    • BUGFIX: Ensure that images' width/height values are integer-type.
    • CHANGE: Small-image 'zoom' feature removed.
    • CHANGE: No longer distributing image-handling modules' template-overrides; changes are present in the zc156b+ core.
    • CHANGE: Remove unused class file (bmz_gif_info.class.php).
    • The following files were changed or removed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_gif_info.class.php
      2. /includes/classes/bmz_image_handler.class.php
      3. /includes/functions/extra_functions/functions_bmz_image_handler.php
      4. /includes/functions/extra_functions/functions_bmz_io.php
      5. /includes/modules/YOUR_TEMPLATE/additional_images.php
      6. /includes/modules/YOUR_TEMPLATE/main_product_image.php
      7. /includes/templates/YOUR_TEMPLATE/css/style_imagehover.css
      8. /includes/templates/YOUR_TEMPLATE/jscript/jscript_imagehover.js
      9. /YOUR_ADMIN/image_handler_view_config.php
      10. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      11. /YOUR_ADMIN/includes/languages/english/image_handler_about.php
  • v5.1.11, 2021-03-28:
    • INTROP: PHP 8.1 and zc158 interoperation.
    • BUGFIX: Correct 'file not found' on admin sidebox display.
    • BUGFIX: No image preview for disabled products; the storefront popup_image doesn't display when a product is disabled.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /YOUR_ADMIN/image_handler.php
      2. /YOUR_ADMIN/image_handler_view_config.php
      3. /YOUR_ADMIN/includes/ih_manager.php
      4. /YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php
      5. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      6. /YOUR_ADMIN/includes/languages/english/image_handler.php
      7. /YOUR_ADMIN/includes/languages/english/image_handler_about.php
  • v5.1.10, 2021-02-19:
    • BUGFIX: Correct PHP 8.0.0+ fatal error.
    • BUGFIX: Unwanted modifications made to input variables when IH is disabled.
    • INTROP: Changing use of $GLOBALS to global in preparation for PHP 8.1+.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/functions/extra_functions/functions_bmz_image_handler.php
      3. /includes/modules/YOUR_TEMPLATE/additional_images.php
      4. /includes/modules/YOUR_TEMPLATE/main_product_image.php
      5. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.9, 2020-10-21:
    • BUGFIX: Remove unneeded spiffyCal elements. Thanks, @Zen4All!
    • BUGFIX: Include on-screen instructions, identifying why additional images' medium image isn't automatically created.
    • CHANGE: Additional "Cache Naming" type to help spread the files over multiple bmz_cache sub-directories. Thanks, @brittainmark!.
    • CHANGE: Simplify the description of the "Cache Naming" configuration setting.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /YOUR_ADMIN/image_handler.php
      3. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      4. /YOUR_ADMIN/includes/languages/english/image_handler.php
  • v5.1.8, 2020-01-04:
    • BUGFIX: Future-proofing; correct curly-brace usage for PHP 7.4.
    • BUGFIX: Document configuration required for SiteMapXml images' creation.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler_class.php
      2. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.7, 2019-11-06:
    • BUGFIX: 'Submit' buttons inoperative on admin tool.
    • BUGFIX: Check for empty values prior to using strpos.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler_class.php
      2. /YOUR_ADMIN/image_handler.php
      3. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.6, 2019-10-03:
    • BUGFIX: Include required parameter in additional_images notifier.
    • BUGFIX: Correct formation of 'image-hover' links.
    • CHANGE: Use CSS buttons instead of images (thanks, @proseLA!).
    • CHANGE: Use HTML5 'doctype'.
    • BUGFIX: Correct target page for category/product search; it changed for zc156 and later.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler_class.php
      2. /includes/modules/YOUR_TEMPLATE/additional_images.php
      3. /YOUR_ADMIN/image_handler.php
      4. /YOUR_ADMIN/image_handler_uninstall.php
      5. /YOUR_ADMIN/image_handler_view_config.php
      6. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.5, 2019-07-24:
    • BUGFIX: Correct undefined "IH_VERSION" PHP Notice on initial installation.
    • BUGFIX: Correct undefined index on initial installation; missing a configuration setting's description.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      2. /YOUR_ADMIN/includes/languages/english/extra_definitions/image_handler_extra_definitions.php
  • v5.1.4, 2019-07-11:
    • BUGFIX: Correct "missing constant" PHP warning on initial installation.
    • BUGFIX: Correct edit product link; broken by zc156 Categories / Products restructuring.
    • BUGFIX: Correct "Can't determine the page link" on new product-image creation.
    • BUGFIX: Correct various PHP Notice logs.
    • BUGFIX: Correct 'force canvas' and proportional height/widths image creation.
    • BUGFIX: Correct image-generation for products that can't be added to the cart.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/functions/extra_functions/functions_bmz_image_handler.php
      3. /YOUR_ADMIN/image_handler.php
      4. /YOUR_ADMIN/includes/ih_manager.php
      5. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      6. /YOUR_ADMIN/includes/languages/english/image_handler.php
  • v5.1.3, 2019-05-01:
    • BUGFIX: Correct upgrade from IH versions that didn't include an IH_VERSION value.
    • BUGFIX: Correct overlapping previous/next product buttons on Zen Cart 1.5.6 and later.
    • CHANGE: PSR-2 standardization.
    • BUGFIX: Correct image auto-update conditional.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/modules/YOUR_TEMPLATE/additional_images.php
      3. /YOUR_ADMIN/image_handler.php
      4. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.2, 2019-02-24:
    • BUGFIX: Correct undefined LARGE_IMAGE_WIDTH and _HEIGHT constants.
    • BUGFIX: Correct configuration_description for small/medium/large image backgrounds.
    • BUGFIX: Correct ih_log*.log contents when DIR_FS_CATALOG is set to '/'.
    • BUGFIX: Suppress image-conversion errors, recording only when the IH debug is active.
    • BUGFIX: Correct invalid numeric issues for later versions of PHP.
    • BUGFIX: Move "new file" button in Tools->Image Handler5 to improve workflow.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/classes/observers/FualSlimboxObserver.php
      3. /YOUR_ADMIN/image_handler.php
      4. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      5. /YOUR_ADMIN/includes/languages/english/image_handler.php
  • v5.1.1, 2018-06-20:
    • BUGFIX: Correct 'bmz_cache' file location when DIR_FS_CATALOG is set to '/'.
    • BUGFIX: Image-add corrections.
    • BUGFIX: Correct debug-log generated on initial entry.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /YOUR_ADMIN/includes/ih_manager.php
      3. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
  • v5.1.0, 2018-05-29:
    • CHANGE: Added View Image Handler Configuration to the IH5 admin menu.
    • CHANGE: Removed Scan for old images tool from the IH5 admin menu.
    • BUGFIX: Invalid "quality" parameter supplied to imagepng, resulting in oversized images being created.
    • CHANGE: Move Image Handler5 help-text to a separate language file.
    • BUGFIX: Background checker not recognizing "transparent" (with no RGB) as a valid setting.
    • BUGFIX: Notifiers in the additional- and main-product-image modules need to be "globalized".
    • BUGFIX: Check for the presence of the zen_lightbox function before enabling the Fual Slimbox observer.
    • CHANGE: Major admin-level restructuring and additional logging for debug.
    • CHANGE: Remove 'allow_mixed_case_ext' handling.
    • BUGFIX: Correct interaction with Zen ColorBox.
    • BUGFIX: Correct 'missing' definition.
    • BUGFIX: Correct unwanted PHP warning when product-image is set, but missing.
    • CHANGE: Add admin-activity record when an admin clears the bmz_cache.
    • The following files were changed (all in the 1_Installation_Files (v1.5.5) directory):
      1. /includes/classes/bmz_image_handler.class.php
      2. /includes/classes/observers/ColorBoxObserver.php
      3. /includes/classes/observers/FualSlimboxObserver.php
      4. /includes/classes/observers/ImageHandlerObserver.php
      5. /includes/extra_configures/bmz_image_handler_conf.php
      6. /includes/extra_datafiles/image_handler_logging.php (Added)
      7. /includes/functions/extra_functions/functions_bmz_image_handler.php
      8. /includes/functions/extra_functions/functions_bmz_io.php
      9. /includes/modules/YOUR_TEMPLATE/additional_images.php
      10. /includes/modules/YOUR_TEMPLATE/main_product_image.php
      11. /YOUR_ADMIN/image_handler.php
      12. /YOUR_ADMIN/image_handler_uninstall.php
      13. /YOUR_ADMIN/image_handler_view_config.php (Added)
      14. /YOUR_ADMIN/includes/ih_manager.php
      15. /YOUR_ADMIN/includes/classes/ImageHandlerAdmin.php
      16. /YOUR_ADMIN/includes/extra_datafiles/image_handler.php
      17. /YOUR_ADMIN/includes/extra_datafiles/image_handler_admin_logging.php (Added)
      18. /YOUR_ADMIN/includes/init_includes/init_image_handler.php
      19. /YOUR_ADMIN/includes/languages/english/image_handler.php
      20. /YOUR_ADMIN/includes/languages/english/image_handler_about.php (Added)
      21. /YOUR_ADMIN/includes/languages/english/image_handler_view_config.php (Added)
      22. /YOUR_ADMIN/includes/languages/english/extra_definitions/image_handler_extra_definitions.php
  • v5.0.0, 2017-11-10:
    • Major changes to the plugin's distribution, installation and uninstall procedures.
      1. Drops support for Zen Cart versions prior to 1.5.5.
      2. Installation no longer auto-removes the plugin's installation/upgrade modules.
      3. No more core-file overwrites; only two template-override file changes needed.
      4. Includes integration with Fual Slimbox and ColorBox.
      5. Separate uninstall script included.
    • Correct javascript error in imagehover processing.
    • Detect and correct invalid transparency settings.
    • Use CSS3 media-queries to "hide" imagehover pop-up on smaller devices.
    • Restore search functionality.

Based on Image Handler2 Ver 2.0 Rev 7 for Zen Cart 1.3.8a updated by ckosloff.

Image Handler4 v4.0 modifications by:

  • nagelkruid (nagelkruid@gmail.com)
  • Nigelt74 (http://webzings.com)
  • C Jones (http://overthehillweb.com)
  • K Hudson (http://empowermentsanctuary.com)
  • N Collie (http://www.clearright.co.uk)
  • Jörg Schönberger (http://www.webchills.at)
  • lat9 (https://vinosdefrutastropicales.com)
  • Chad M (mc12345678@cox.net)

and Image Handler5 modifications by:

  • lat9 (https://vinosdefrutastropicales.com)
  • jazzman346 (https://github.com/jazzman346)
  • jeking (https://www.zen-cart.com/member.php?16702-jeking)
  • Zen4All (https://github.com/Zen4All)
  • brittainmark (https://github.com/brittainmark)