PHPackages mage2kishan/module-productgallery - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. mage2kishan/module-productgallery ActiveMagento2-module[Image & Media](/categories/media) mage2kishan/module-productgallery ================================= Custom product image gallery for Magento 2 product detail pages. Features configurable thumbnail layouts (horizontal, vertical, grid), image zoom (inner/lens), fullscreen lightbox, and responsive navigation. Compatible with Hyva and Luma themes. 1.0.3(1mo ago)025↓50%1proprietaryPHPPHP >=8.1 Since Apr 14Pushed yesterdayCompare [ Source](https://github.com/mage2sk/module-productgallery)[ Packagist](https://packagist.org/packages/mage2kishan/module-productgallery)[ Docs](https://kishansavaliya.com)[ RSS](/packages/mage2kishan-module-productgallery/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (8)Versions (5)Used By (1) Custom Product Image Gallery for Magento 2 | Panth Product Gallery ================================================================== [](#custom-product-image-gallery-for-magento-2--panth-product-gallery) [![Magento 2.4.4 - 2.4.8](https://camo.githubusercontent.com/079c832211eed4f9451ebe264e3865f825b0f9f31b041cbf03676c6e254535d4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e342532302d2d253230322e342e382d6f72616e67653f6c6f676f3d6d6167656e746f266c6f676f436f6c6f723d7768697465)](https://magento.com)[![PHP 8.1 - 8.4](https://camo.githubusercontent.com/56b3cce18841623e2cbed2ebf09b06be1be8807e99e6e054a89d304ab4790b8e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532302d2d253230382e342d626c75653f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://php.net)![Hyva + Luma](https://camo.githubusercontent.com/d4d6a05401973034a5aae392f030440eefa40afc9191ffb06ed897af5d25adb1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5468656d65732d487976612532302532422532304c756d612d313462386136)[![Packagist](https://camo.githubusercontent.com/3f16016e93645655c6737c43ac93a9724ee77e4413ba63c5bde83861c852d698/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d6d616765326b697368616e2532466d6f64756c652d2d70726f6475637467616c6c6572792d6f72616e67653f6c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/mage2kishan/module-productgallery)[![Upwork Top Rated Plus](https://camo.githubusercontent.com/6f72584179420c41ed90432fd2579a4ed36199d4229e8181d20f353c1c4ee4eb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5570776f726b2d546f702532305261746564253230506c75732d3134613830303f6c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465)](https://www.upwork.com/freelancers/~016dd1767321100e21)[![Panth Infotech Agency](https://camo.githubusercontent.com/401a792e990131002e91054d1b04494af5a2152fcc891ca000eb683786770abf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4167656e63792d50616e7468253230496e666f746563682d3134613830303f6c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465)](https://www.upwork.com/agencies/1881421506131960778/)[![Website](https://camo.githubusercontent.com/f1ae86d28e2b505aee60f240d3e5508e390b0a8dc7a9b7ecf1b450fad862053f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f576562736974652d6b697368616e736176616c6979612e636f6d2d304439343838)](https://kishansavaliya.com)[![Get a Quote](https://camo.githubusercontent.com/0b6c02cc1ad00f11bf1b0164a9998734bd716473db36cc2a5c1517e3d3578d1b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4765742532306125323051756f74652d46726565253230457374696d6174652d444332363236)](https://kishansavaliya.com/get-quote) > **Custom Product Image Gallery for Magento 2** — replace the default product media gallery with a fast, configurable gallery supporting horizontal, vertical and grid thumbnail layouts, inner and lens image zoom, fullscreen lightbox, responsive navigation, full Hyva and Luma compatibility, and an optional soft dependency on Panth Advanced SEO for automatic image alt-text generation. **Panth Product Gallery** gives merchants total control over how product images are presented on the product detail page. Choose between **horizontal thumbnails** (classic below-main-image strip), **vertical thumbnails** (side rail on desktop, strip on mobile), or a **grid layout** (Amazon/Etsy style). Enable **inner zoom** for hover magnification directly inside the main image, **lens zoom** for a floating magnifier window, or a **fullscreen lightbox** that opens the full-resolution image with swipe and keyboard navigation. Everything is responsive, touch-friendly, and tuned for Core Web Vitals on both **Hyva** (Alpine.js + Tailwind) and **Luma** (Knockout.js) storefronts. When **Panth Advanced SEO** is installed, the gallery automatically pulls AI-generated alt text into every `` tag for better accessibility and SEO. --- 🚀 Need Custom Magento 2 Gallery or Product Page Work? ----------------------------------------------------- [](#-need-custom-magento-2-gallery-or-product-page-work) > **Get a free quote for your project in 24 hours** — custom gallery layouts, PDP redesigns, Hyva migration, performance optimization, and Adobe Commerce Cloud. [ ![Get a Free Quote](https://camo.githubusercontent.com/eac8c45d21cff8b139ddc392325f3bd6c8266a6f3d7b23f15131c958f3d3c8d0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f476574253230612532304672656525323051756f74652532302545322538362539322d5265706c7925323077697468696e2532303234253230686f7572732d4443323632363f7374796c653d666f722d7468652d6261646765) ](https://kishansavaliya.com/get-quote) ### 🏆 Kishan Savaliya [](#-kishan-savaliya) **Top Rated Plus on Upwork** [![Hire on Upwork](https://camo.githubusercontent.com/b69353d3c6e192f4d03cc36bb8883612004e32f54dd2dbcc1e700dd791acd875/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f486972652532306f6e2532305570776f726b2d546f702532305261746564253230506c75732d3134613830303f7374796c653d666f722d7468652d6261646765266c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465)](https://www.upwork.com/freelancers/~016dd1767321100e21) 100% Job Success • 10+ Years Magento Experience Adobe Certified • Hyva Specialist ### 🏢 Panth Infotech Agency [](#-panth-infotech-agency) **Magento Development Team** [![Visit Agency](https://camo.githubusercontent.com/bbf04bdd2aff502082508568ec42ace3a7475c98756f596e2013056c89726ed6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56697369742532304167656e63792d50616e7468253230496e666f746563682d3134613830303f7374796c653d666f722d7468652d6261646765266c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465)](https://www.upwork.com/agencies/1881421506131960778/) Custom Modules • Theme Design • Migrations Performance • SEO • Adobe Commerce Cloud **Visit our website:** [kishansavaliya.com](https://kishansavaliya.com) | **Get a quote:** [kishansavaliya.com/get-quote](https://kishansavaliya.com/get-quote) --- Table of Contents ----------------- [](#table-of-contents) - [Key Features](#key-features) - [Compatibility](#compatibility) - [Installation](#installation) - [Configuration](#configuration) - [Advanced SEO Integration](#advanced-seo-integration) - [FAQ](#faq) - [Support](#support) - [About Panth Infotech](#about-panth-infotech) - [Quick Links](#quick-links) --- Key Features ------------ [](#key-features) ### Configurable Thumbnail Layouts [](#configurable-thumbnail-layouts) - **Horizontal layout** — traditional strip of thumbnails below the main image - **Vertical layout** — thumbnails on the side rail (desktop), collapsing to a horizontal strip on mobile - **Grid layout** — Amazon/Etsy-style multi-column grid showing all images at once - **Thumbnail count & size** — configurable number of visible thumbnails and pixel dimensions - **Active state styling** — border, shadow, and scale transitions for the selected thumbnail ### Image Zoom Modes [](#image-zoom-modes) - **Inner zoom** — magnify the image in place on hover, no overlay required - **Lens zoom** — floating magnifier lens with a side preview window - **Fullscreen lightbox** — click to open the full-resolution image in a modal with swipe, pinch-zoom, and keyboard navigation - **Zoom level control** — adjustable zoom factor (1.5x to 4x) - **Touch-friendly** — pinch-zoom and swipe gestures on mobile and tablet ### Responsive Navigation [](#responsive-navigation) - Prev/next arrows with keyboard support (arrow keys, Escape to close) - Dot indicators and image counter (e.g. "3 / 12") - Swipe navigation on touch devices - Auto-slide option with configurable interval - Infinite loop or stop-at-ends behaviour ### Theme Support [](#theme-support) - **Hyva compatible** — Alpine.js components, Tailwind CSS utility classes, no jQuery - **Luma compatible** — Knockout.js bindings that cleanly replace the default `gallery.phtml` - **Automatic theme detection** — via `Panth\Core\Helper\Theme`, the correct template is served without any manual switching - **Child-theme safe** — templates can be overridden from your own custom theme ### SEO & Accessibility [](#seo--accessibility) - **Alt text from Panth Advanced SEO** — optional soft dependency; when installed, every image pulls its AI-generated alt text automatically - **Semantic HTML** — proper ``, ``, `aria-label`, and `role` attributes - **Keyboard navigable** — full keyboard support (Tab, Enter, arrows, Escape) - **Lazy loading** — `loading="lazy"` and `decoding="async"` on non-primary images - **Structured image URLs** — preserves Magento media paths for CDN compatibility ### Performance [](#performance) - **No jQuery on Hyva** — pure Alpine.js, minimal JS payload - **CSS-only transitions** where possible — hardware-accelerated transforms - **Lazy-loaded thumbnails** — off-screen thumbs defer loading - **Optimized for Core Web Vitals** — minimal CLS, fast LCP on the main image --- Compatibility ------------- [](#compatibility) RequirementVersions SupportedMagento Open Source2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8Adobe Commerce2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8Adobe Commerce Cloud2.4.4 — 2.4.8PHP8.1.x, 8.2.x, 8.3.x, 8.4.xHyva Theme1.3+ (fully supported)Luma ThemeNative supportPanth\_CoreRequired (free)Panth\_AdvancedSEOOptional (soft dependency for alt text)Tested on: - Magento 2.4.8-p4 with PHP 8.4 (Hyva 1.3.x) - Magento 2.4.7 with PHP 8.3 (Luma) - Magento 2.4.6 with PHP 8.2 --- Installation ------------ [](#installation) ### Composer Installation (Recommended) [](#composer-installation-recommended) ``` composer require mage2kishan/module-productgallery bin/magento module:enable Panth_Core Panth_ProductGallery bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy -f bin/magento cache:flush ``` ### Manual Installation via ZIP [](#manual-installation-via-zip) 1. Download the latest release ZIP from [Packagist](https://packagist.org/packages/mage2kishan/module-productgallery) or the [Adobe Commerce Marketplace](https://commercemarketplace.adobe.com) 2. Extract the contents to `app/code/Panth/ProductGallery/` in your Magento installation 3. Run the same commands as above starting from `bin/magento module:enable` ### Verify Installation [](#verify-installation) ``` bin/magento module:status Panth_ProductGallery # Expected output: Module is enabled ``` After installation, navigate to: ``` Admin → Stores → Configuration → Panth Extensions → Product Gallery ``` --- Configuration ------------- [](#configuration) All settings live at `Stores → Configuration → Panth Extensions → Product Gallery`. ### General [](#general) SettingDefaultDescriptionEnable ModuleYesMaster toggle for the custom gallery. Disable to fall back to Magento's default gallery.Thumbnail LayoutHorizontalChoose `Horizontal`, `Vertical`, or `Grid`.Thumbnail Count5Visible thumbnails before scrolling (horizontal/vertical).Thumbnail Size80pxPixel dimensions for each thumbnail.### Zoom [](#zoom) SettingDefaultDescriptionZoom ModeInnerChoose `Inner`, `Lens`, `Lightbox`, or `Disabled`.Zoom Level2.0xMagnification factor (1.5x - 4x).Enable Fullscreen LightboxYesClick to open the full-size image in a modal.Enable Pinch Zoom (mobile)YesPinch-to-zoom inside the lightbox.### Navigation [](#navigation) SettingDefaultDescriptionShow Prev/Next ArrowsYesDisplay navigation arrows on the main image.Show Dot IndicatorsNoShow a row of dot indicators below the main image.Show Image CounterYesShow "3 / 12" counter overlay.Enable Keyboard NavigationYesArrow keys, Escape, Enter.Enable Auto-SlideNoAuto-advance the main image.Auto-Slide Interval5sSeconds between slides when auto-slide is on.--- Advanced SEO Integration ------------------------ [](#advanced-seo-integration) Panth Product Gallery has a **soft dependency** on [Panth Advanced SEO](https://packagist.org/packages/mage2kishan/module-advanced-seo). When Advanced SEO is installed and enabled, the gallery automatically uses its AI-generated image alt text for every `` tag — no manual alt text management required. Without Advanced SEO, the gallery falls back to Magento's standard image label / product name pattern. You can still use the gallery fully without installing Advanced SEO; the integration is purely additive. --- FAQ --- [](#faq) ### Does this replace Magento's default product gallery? [](#does-this-replace-magentos-default-product-gallery) Yes, on the product detail page. When the module is enabled, the default `gallery.phtml` is replaced with the Panth gallery (one template for Hyva, another for Luma — chosen automatically). ### Does it work with configurable product swatches? [](#does-it-work-with-configurable-product-swatches) Yes. When a customer picks a colour/size swatch, the gallery swaps to the correct variant images using Magento's standard `gallery` JSON payload. ### Does it work with video (YouTube / Vimeo)? [](#does-it-work-with-video-youtube--vimeo) Yes. Magento product video entries are rendered inline with a play-button thumbnail; clicking opens the video in the lightbox. ### Is Hyva compatible? [](#is-hyva-compatible) Yes — fully. The module ships an Alpine.js implementation that does not depend on jQuery or Knockout, and installs automatically when the store theme is Hyva. ### Does it affect Core Web Vitals? [](#does-it-affect-core-web-vitals) Positively. The Hyva implementation uses a minimal JS payload and lazy-loads thumbnails, which typically improves LCP and reduces CLS versus the default gallery. ### Can I override the template in my child theme? [](#can-i-override-the-template-in-my-child-theme) Yes. Copy `view/frontend/templates/product/view/gallery.phtml` (Luma) or the equivalent file under the Hyva area into your own theme and customize freely. ### Does it support multi-store and multi-language? [](#does-it-support-multi-store-and-multi-language) Yes. All configuration respects Magento's scope hierarchy (default → website → store view) and all user-facing strings are translatable via Magento's `__()` function. ### Does it require Panth Advanced SEO? [](#does-it-require-panth-advanced-seo) No, it is an optional soft dependency. Advanced SEO only improves alt-text quality; the gallery works standalone. --- Support ------- [](#support) ChannelContactEmailWebsite[kishansavaliya.com](https://kishansavaliya.com)WhatsApp+91 84012 70422GitHub Issues[github.com/mage2sk/module-productgallery/issues](https://github.com/mage2sk/module-productgallery/issues)Upwork (Top Rated Plus)[Hire Kishan Savaliya](https://www.upwork.com/freelancers/~016dd1767321100e21)Upwork Agency[Panth Infotech](https://www.upwork.com/agencies/1881421506131960778/)Response time: 1-2 business days. ### 💼 Need Custom Magento Development? [](#-need-custom-magento-development) Looking for **custom gallery layouts**, **PDP redesigns**, **Hyva migration**, or **performance optimization**? Get a free quote in 24 hours: [ ![Get a Free Quote](https://camo.githubusercontent.com/0d9512dc4f89ef40179e9f650fd0786b6bc846d289ab2cb04a223a43f2833eeb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f254630253946253932254143253230476574253230612532304672656525323051756f74652d6b697368616e736176616c6979612e636f6d2532466765742d2d71756f74652d4443323632363f7374796c653d666f722d7468652d6261646765) ](https://kishansavaliya.com/get-quote) [ ![Hire on Upwork](https://camo.githubusercontent.com/fad56e8be7896e39593f090cd2ed32e6bf86b4b6e75974cf292aee99d45f5077/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f486972652532304b697368616e2d546f702532305261746564253230506c75732d3134613830303f7374796c653d666f722d7468652d6261646765266c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465) ](https://www.upwork.com/freelancers/~016dd1767321100e21) [ ![Visit Agency](https://camo.githubusercontent.com/fdf45a9d937d72b896f5e2557337d47efebc0e06b7ad4d4c162c0a64375a62fa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56697369742d50616e7468253230496e666f746563682532304167656e63792d3134613830303f7374796c653d666f722d7468652d6261646765266c6f676f3d7570776f726b266c6f676f436f6c6f723d7768697465) ](https://www.upwork.com/agencies/1881421506131960778/) [ ![Visit Website](https://camo.githubusercontent.com/7455559317a374eb3eb536c5ea201ca2c2a29bc13d82cc127278975a680d552c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5669736974253230576562736974652d6b697368616e736176616c6979612e636f6d2d3044393438383f7374796c653d666f722d7468652d6261646765) ](https://kishansavaliya.com) --- About Panth Infotech -------------------- [](#about-panth-infotech) Built and maintained by **Kishan Savaliya** — [kishansavaliya.com](https://kishansavaliya.com) — a **Top Rated Plus** Magento developer on Upwork with 10+ years of eCommerce experience. **Panth Infotech** is a Magento 2 development agency specializing in high-quality, security-focused extensions and themes for both Hyva and Luma storefronts. Our extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management — over 34 modules built to MEQP standards and tested across Magento 2.4.4 to 2.4.8. Browse the full extension catalog on the [Adobe Commerce Marketplace](https://commercemarketplace.adobe.com) or [Packagist](https://packagist.org/packages/mage2kishan/). --- Quick Links ----------- [](#quick-links) - 🌐 **Website:** [kishansavaliya.com](https://kishansavaliya.com) - 💬 **Get a Quote:** [kishansavaliya.com/get-quote](https://kishansavaliya.com/get-quote) - 👨‍💻 **Upwork Profile (Top Rated Plus):** [upwork.com/freelancers/~016dd1767321100e21](https://www.upwork.com/freelancers/~016dd1767321100e21) - 🏢 **Upwork Agency:** [upwork.com/agencies/1881421506131960778](https://www.upwork.com/agencies/1881421506131960778/) - 📦 **Packagist:** [packagist.org/packages/mage2kishan/module-productgallery](https://packagist.org/packages/mage2kishan/module-productgallery) - 🐙 **GitHub:** [github.com/mage2sk/module-productgallery](https://github.com/mage2sk/module-productgallery) - 🛒 **Adobe Marketplace:** [commercemarketplace.adobe.com](https://commercemarketplace.adobe.com) - 📧 **Email:** - 📱 **WhatsApp:** +91 84012 70422 --- **Ready to upgrade your Magento 2 product pages?** [ ![Get Started](https://camo.githubusercontent.com/66dee04430af977df988ac18454416f2f08a5169868a0d0689061b7e8db6f8ca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f254630253946253941253830253230476574253230537461727465642532302545322538362539322d4672656525323051756f7465253230696e2532303234682d4443323632363f7374796c653d666f722d7468652d6261646765) ](https://kishansavaliya.com/get-quote) --- **SEO Keywords:** magento 2 product gallery, magento 2 image zoom, magento 2 lightbox, magento 2 product images, magento 2 gallery widget, magento 2 thumbnail layout, hyva product gallery, luma product gallery, magento 2 product image slider, magento 2 fullscreen image, magento 2 zoom extension, magento 2 product media gallery, magento 2 inner zoom, magento 2 lens zoom, magento 2 product page gallery, magento 2 PDP gallery, magento 2 responsive gallery, magento 2 mobile gallery, magento 2 image alt text, magento 2 SEO gallery, panth product gallery, panth infotech, hire magento developer, top rated plus upwork, kishan savaliya magento, mage2kishan, mage2sk, magento 2.4.8 gallery, php 8.4 magento module, hyva gallery alpine js, luma gallery knockout, magento 2 product image customization ### Health Score 42 — FairBetter than 88% of packages Maintenance97 Actively maintained with recent releases Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 4 Last Release 32d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/343e344aa298f189db888b32d62f9202d31ced1a5ea23411850a63dc4a30299c?d=identicon)[kishansavaliya](/maintainers/kishansavaliya) --- Top Contributors [![KishanSavaliya](https://avatars.githubusercontent.com/u/16853223?v=4)](https://github.com/KishanSavaliya "KishanSavaliya (10 commits)") --- Tags lightboxmagento2hyvalumaimage zoomproduct-gallery ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/mage2kishan-module-productgallery/health.svg) ``` [![Health](https://phpackages.com/badges/mage2kishan-module-productgallery/health.svg)](https://phpackages.com/packages/mage2kishan-module-productgallery) ``` ### Alternatives [mollie/magento2 Mollie Payment Module for Magento 2 1131.8M12](/packages/mollie-magento2)[run-as-root/magento2-prometheus-exporter Magento2 Prometheus Exporter 68353.9k](/packages/run-as-root-magento2-prometheus-exporter)[loki/magento2-components Core module for defining Alpine.js components with advanced AJAX features 1010.0k22](/packages/loki-magento2-components)[mage-os/module-inventory-reservations-grid Add a grid with the list of inventory reservations. 1512.6k](/packages/mage-os-module-inventory-reservations-grid)[opengento/module-category-import-export This module add the capability to import and export the categories from the back-office. 1310.2k1](/packages/opengento-module-category-import-export)[loki/magento2-admin-components Admin Panel grids and forms created via Loki Components 173.7k7](/packages/loki-magento2-admin-components) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)