====== Magento 2 Product Image Gallery Extension ======

The **Magento 2 Product Image Gallery Extension** enhances your Magento storefront with advanced image zoom, fullscreen viewing, responsive galleries, and Hyvä-compatible performance.

===== Extension Overview =====

The extension improves product presentation by providing a modern and interactive image gallery experience for Magento 2 stores.

===== Product Information =====

^ Attribute ^ Details ^
| Platform | Magento 2 |
| Compatibility | Magento 2.x |
| Frontend Support | Hyvä & Luma |
| Media Types | Images and Videos |
| Responsive Support | Desktop, Tablet, Mobile |

===== What This Extension Does =====

  * Provides advanced image zoom functionality
  * Adds immersive fullscreen viewing
  * Supports responsive image galleries
  * Works seamlessly with Hyvä themes
  * Supports image and video galleries
  * Improves customer engagement and product presentation

===== Installation =====

Please refer to the official installation guide for step-by-step setup instructions:

https://toweringmedia.com/installation

===== Configuration =====

To configure the extension, navigate to:

<code>
Stores > Configuration > Toweringmedia > Product Image Gallery
</code>

The extension includes multiple configuration options for controlling zoom behavior, fullscreen viewing, image navigation, thumbnails, and overall gallery functionality.

==== General ====

  * **Enable Gallery:** Enables or disables the custom product image gallery. When disabled, the default Magento gallery template is used.

==== Desktop Zoom ====

  * **Enable Hover Zoom:** Enables hover lens and side zoom preview on desktop devices.
  * **Zoom Magnification:** Defines the zoom preview magnification level from 1.0 to 10.0.

==== Fullscreen Viewer ====

  * **Enable Fullscreen:** Opens images in fullscreen mode from the expand button or image click.
  * **Show Main Image Arrows:** Displays previous and next navigation arrows on the main image.
  * **Keyboard Navigation:** Allows arrow keys and Escape key navigation in fullscreen mode.
  * **Touch Swipe:** Enables swipe gestures on touch devices to navigate gallery images.
  * **Show Thumbnails:** Displays thumbnail previews below the main image.
  * **Show Fullscreen Title:** Displays product or image captions in fullscreen mode.

{{:magento2:extensions:zoom-config.png?400|}}

===== User Experience =====

==== Fullscreen Experience ====

Customers can open product images in a distraction-free fullscreen popup view for detailed product inspection and seamless navigation. Combined with keyboard controls, swipe gestures, and thumbnail previews, the fullscreen viewer creates an immersive browsing experience across desktop and mobile devices.

{{:magento2:extensions:popup.jpg?400|}}

==== Image Zoom ====

The extension includes advanced hover zoom functionality that allows customers to inspect textures, materials, stitching, and other fine product details with precision. A hover-based zoom lens highlights specific areas while displaying a magnified preview alongside the image.

{{:magento2:extensions:zoom.jpg?400|}}

==== Performance & Compatibility ====

Built using modern frontend technologies, the gallery is lightweight, fast, and optimized for Hyvä themes. The extension delivers smooth interactions and fast loading performance without relying on heavy third-party libraries.

The module supports both product images and videos, allowing merchants to create more engaging and informative product galleries.

==== Conversion-Driven Experience ====

With its clean design, enhanced interactivity, and optimized performance, the gallery helps improve customer engagement and product presentation. Better image viewing experiences can increase customer confidence and positively influence conversion rates.

==== Magic Zoom Replacement ====

This extension provides a modern alternative to Magic Zoom with improved performance, faster load times, and better compatibility with Hyvä themes.

Unlike traditional zoom solutions that depend on heavy JavaScript libraries, this extension is powered by Alpine.js, making it lightweight, fast, and future-ready for modern Magento stores.

==== Key Features & Capabilities ====

  * **Alpine.js Powered:** Lightweight performance without jQuery or Knockout dependencies.
  * **Magic Zoom Replacement:** Optimized zoom experience for Hyvä themes.
  * **Fully Responsive:** Works seamlessly across mobile, tablet, and desktop devices.
  * **Hybrid Media Support:** Combine images and YouTube/Vimeo videos in one gallery.
  * **Zero Dependencies:** Improves page speed and reduces Total Blocking Time.

==== Why Switch from Magic Zoom? ====

Traditional solutions like Magic Zoom Plus were designed for older Magento themes and can be difficult to integrate with modern frontends such as Hyvä. This extension provides a native, high-performance alternative built specifically for the modern Magento ecosystem.

===== Operational Checklist =====

  * Verify the extension is enabled from the Magento admin configuration.
  * Clear Magento cache after changing gallery settings.
  * Run static content deployment if frontend changes are not visible.
  * Confirm product images are properly assigned to products.
  * Test hover zoom functionality on desktop devices.
  * Verify fullscreen popup behavior on desktop and mobile devices.
  * Test swipe navigation functionality on touch devices.
  * Check gallery responsiveness across different screen sizes.
  * Verify Hyvä theme compatibility after installation or updates.
  * Test video playback if product videos are enabled in the gallery.

===== Troubleshooting =====

  * **Gallery Not Displaying:** Ensure the extension is enabled in configuration, clear Magento cache, and redeploy static content if necessary.
  * **Zoom Feature Not Working:** Verify that "Enable Hover Zoom" is enabled in the extension configuration and confirm product images are available.
  * **Fullscreen Popup Does Not Open:** Check that fullscreen viewing is enabled in the admin configuration settings.
  * **Images Not Loading:** Confirm that product images are properly assigned and Magento media permissions are correct.
  * **Layout Issues on Frontend:** Flush Magento cache and verify theme compatibility with the installed Magento version.
  * **Touch Swipe Not Working on Mobile:** Ensure the touch swipe feature is enabled in the fullscreen viewer configuration section.
  * **Changes Not Visible After Configuration Updates:** Clear Magento cache and browser cache after saving configuration changes.

===== Related Magento 2 docs =====

  * [[magento2:extensions:toweringmedia-admin-allow-out-of-stock-order|Magento2 Admin Allow Out Of Stock Order]]
  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[start|Global docs home]]