Gallery
v1.2.1
v1.2.1
Annual Subscription
Updated Aug 14, 2026
Gallery
Custom product image gallery for Magento 2 that replaces the default Fotorama gallery with a Slick-based slider, carousel thumbnails, and lightbox.
Hyvä Compatible
Magento 2.4.4
Magento 2.4.5
Magento 2.4.6
Magento 2.4.7
Mage-OS 2.0
Mage-OS 2.1
- Updates and support included for 12 months
- License key delivered immediately by email
- 30-day money-back guarantee
- Full documentation included
- Compatible with Hyvä themes
- Composer-ready installation
Product Gallery
Replace Magento's default Fotorama product gallery with a modern Slick-based slider, a thumbnail carousel and a fullscreen lightbox — all configurable from the admin, with no theme rewrite required.
The default Magento gallery shows its age: heavy, slow on mobile, awkward keyboard handling, and surprisingly hard to skin. This module drops in a lighter alternative that respects Magento's image cache and configurable-product behaviour, while giving merchants the controls they actually need: how many thumbnails to show, whether to lazy-load, whether to expose the zoom button, whether to update the URL in the lightbox.
Who it's for
- Merchants whose product pages live or die by image presentation (apparel, furniture, jewellery, B2C catalogues with rich photography)
- Stores running configurable products with swatches, where the gallery must reload cleanly on every option change
- Teams that want a modern, accessible gallery without committing to a full Hyvä migration
Key benefits
- Modern slider with thumbnail carousel — main image slides on click or swipe, paired with a configurable thumbnail carousel (1 to 10 visible at a time, optional infinite scroll).
- Fullscreen lightbox — open any image full-size with keyboard navigation (Arrow keys, Enter, Space, Escape) and optional History API support so links to specific slides are shareable.
- Configurable product aware — gallery reloads automatically when a swatch or option is selected, keeping original high-resolution image URLs intact for the fullscreen view.
- Performance-friendly — lazy-load is enabled by default so thumbnails outside the viewport stay off the network until needed.
- Admin-controlled, no code edits — every behaviour (zoom button, pagination dots, lazy-load, infinite scroll, History API) toggles from Stores → Configuration.
- Graceful fallback — disable the module from admin and Magento's default gallery returns instantly. No risk of locking yourself in.
- Accessible by design — full keyboard support, semantic markup, ARIA-friendly lightbox.
Compatibility
- Magento 2.4.x / Mage-OS equivalent
- PHP 7.4, 8.0, 8.1, 8.2, 8.3
- Designed for Luma and Luma-derived themes (uses RequireJS + jQuery + Slick)
- Works with simple and configurable products, including swatch renderer
- Compatible with Magento's Full Page Cache (gallery JS hydrates on page load)
Install this module via Composer. Make sure your auth.json is configured with your Wimakeit credentials.
Terminal
$ composer require wimakeit/gallery:^1.2.1
$ bin/magento setup:upgrade
$ bin/magento setup:di:compileInstallation notes
The standard composer require + setup:upgrade + setup:di:compile + setup:static-content:deploy flow applies. The points below cover what's specific to this module.
ACL permissions
The module registers one ACL resource under System → Permissions → User Roles:
| Resource | Default |
|---|---|
Wimakeit_Gallery::config (edit Product Gallery configuration) | granted to Administrator role only |
Configuration
The module ships with safe defaults that match the legacy Fotorama experience while enabling the modern slider. Go to Stores → Configuration → Wimakeit → Product Gallery to adjust them.
General Settings
| Setting | Default |
|---|---|
| Enable Custom Gallery | Yes |
Disabling this single toggle returns the page to Magento's native Fotorama gallery — useful for A/B testing or quick rollback.
Carousel Settings
| Setting | Default |
|---|---|
| Thumbnails to Show | 4 (range 1–10) |
| Enable Infinite Scroll | Yes |
Image Viewer Settings
| Setting | Default |
|---|---|
| Enable Lazy Loading | Yes |
| Show Zoom Button | Yes |
| Show Pagination Dots | Yes |
Lightbox Settings
| Setting | Default |
|---|---|
| Use History API | Yes — updates the browser URL when navigating lightbox slides |
Static content deploy
The module ships JavaScript (Slick.js, Slick Lightbox), LESS and templates under view/frontend/. Run bin/magento setup:static-content:deploy (with the appropriate locales) after install on production, or clear pub/static/frontend/ and var/view_preprocessed/ in developer mode.
Theme overrides
To customise the markup, override the template at:
app/design/frontend/Vendor/Theme/Wimakeit_Gallery/templates/product/gallery.phtml
Keyboard shortcuts (out of the box): ArrowLeft / ArrowRight to move between images, Enter or Space to open the lightbox, Escape to close it.
- Version
- v1.2.1
- License
- Annual Subscription
- Support
- 12 months
- Last updated
- Aug 14, 2026
- Magento
- Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
- PHP
- PHP 8.1 PHP 8.2 PHP 8.3
- Hyvä
- Compatible
- Package
-
wimakeit/gallery
Compatibility checker
Pick your stack to see if this module fits.
Compatible with your stack — ready to install.
Not compatible with this combination. Contact us for a custom build.
Compatibility 4
Yes. Gallery is tested against Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce on the same line, and Mage-OS 2.0+ — on PHP 8.1, 8.2 and 8.3. The Specifications tab lists the exact tested combinations. If your stack is in the list, we guarantee a clean install. Wimakeit is an Adobe-certified Magento agency based in Presles (Charleroi / Namur region), Wallonia, Belgium and runs every module against the same matrix we ship to enterprise clients across Belgium, France and the Netherlands.
Yes — fully. Gallery ships a native Hyvä-compatible frontend (Tailwind + Alpine.js) and integrates with Hyvä Checkout when applicable. No companion fallback module needed. Every Hyvä-marked module is built and maintained by the same Wimakeit team that ships Hyvä builds for production stores.
Hyvä Storefront (Tailwind + Alpine.js, server-rendered) and Hyvä Checkout (React-based, headless on top of Magento) are two distinct packages. Gallery ships native Hyvä Storefront compatibility — its frontend is rendered through Hyvä templates with no Luma fallback. Hyvä Checkout integration is delivered when the module has a checkout-step touchpoint (custom payment input, terms checkbox, etc.); otherwise the module runs server-side without any Hyvä Checkout customisation needed. See the Specifications tab for the exact Hyvä integration scope of this module.
Yes. Gallery respects the standard Magento scope (default / website / store / store_view). Every configuration is overridable per store view. Frontend labels use Magento's standard translation files — shipped in French, English and Dutch out of the box. Currencies follow your Magento currency setup with no extra wiring. A typical Wimakeit Magento store runs an fr_BE / nl_BE / en_GB triplet from a single backend — Gallery is ready for this B2B / international setup.
Pricing & licensing 4
€79 — one-time payment, perpetual licence, no recurring fees. Includes 1 year of minor updates + email support in French, English and Dutch, 1 production domain + 1 staging/dev domain. Renewing the support window after year 1 is optional. Volume licences are negotiated directly — write to contact@wimakeit.com for agency or multi-store pricing.
Yes. Gallery has a live demo on demo.wimakeit.be/module-gallery where you can poke around the admin and frontend with a real install pre-populated with sample data. For longer evaluations, request an evaluation licence via our contact form — evaluations cover the same scope as the paid licence and convert to a permanent key on purchase.
We review refund requests case by case. If the module doesn't deliver what was advertised, email contact@wimakeit.com from the address tied to your licence. The refund policy is published on the terms page and applies to every module sold through this marketplace.
Gallery is distributed under a commercial proprietary licence — not MIT, GPL or any other open-source licence. The PHP source ships in
vendor/wimakeit/ once you composer require the package, so you can read it, audit it, and patch it locally for your own Magento install. You may NOT redistribute it, sublicense it, publish it on a public package registry, or sell it on. One licence = one production domain + one staging/dev domain (see terms for the full EULA). Wimakeit modules are NOT part of Magento's open-source repository on packagist.org — they are distributed exclusively via the private Composer registry packages.wimakeit.be. Installation & updates 6
Run
composer require wimakeit/gallery:^1.2.1, then bin/magento setup:upgrade, bin/magento setup:di:compile, and finally bin/magento cache:flush. The Installation tab on this page lists every configuration step (ACLs, cron jobs, default values) so a deploy takes minutes, not hours. If you need a hand, Wimakeit offers Magento installation services from our Wallonian office (Presles, between Charleroi and Namur).
Step 1: get a token on packages.wimakeit.be → My account → Tokens. Step 2: at the root of your project add to
auth.json: {"http-basic": {"packages.wimakeit.be": {"username": "YOUR-EMAIL", "password": "YOUR-TOKEN"}}}. Step 3: register the repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Step 4: composer require wimakeit/gallery:^1.2.1. In CI/CD pipelines, inject COMPOSER_AUTH as a JSON env var instead of committing auth.json.
Most merchants are live within 30 minutes: composer install (1-2 min) → setup:upgrade + di:compile (5-10 min depending on stack size) → admin configuration (5-15 min following the Installation tab) → smoke test on a product or order. Allow extra time if you have a custom theme overriding similar templates. The Wimakeit team has shipped this exact module to B2B and DTC stores across Belgium.
Gallery is built for Magento 2.4.x / Mage-OS 2.0+ and has no Magento 1 equivalent. When migrating from Magento 1, the Wimakeit team handles the audit, the data migration and the integration of Gallery into the new backend as part of a Magento migration project. Migrating from Adobe Commerce to Mage-OS is transparent for Gallery: same
composer require, same module code, same database schema — no fork to maintain, no licence change.
Updates ship through your composer dependency (this exact package), hosted on Wimakeit's private Composer repository at packages.wimakeit.be. Each release is announced on the Changelog tab + the Wimakeit news and follows semantic versioning —
composer update is safe within a major.
All .phtml templates are overridable from your theme: copy the file into
app/design/frontend/{YourVendor}/{theme}/Wimakeit_{Module}/templates/ keeping the same relative path. Blocks, ViewModels and Helpers are overridable via DI preference in your own custom module — declare <preference for="Wimakeit\…\OriginalClass" type="YourVendor\Override\Class" /> in etc/di.xml. Layout XML is extended (preferred) or overridden the standard Magento way. Wimakeit modules never use the final keyword on classes you might reasonably want to override — overriding is a first-class scenario, not a hack. Support & security 3
Open a ticket through the contact form on wimakeit.be or email
contact@wimakeit.com with the module name, version, Magento/Mage-OS version and the steps to reproduce. Fixes ship in the next patch release. Wimakeit support is staffed in French, English and Dutch on business days (CET working hours).
Send security reports privately to
contact@wimakeit.com with a clear [SECURITY] subject prefix — please include the module name, version and the steps to reproduce. We acknowledge promptly on business days and credit reporters in the Changelog if they wish. Wimakeit is a Belgian SRL (société à responsabilité limitée) bound by Belgian and EU privacy and disclosure law.
Yes. Gallery stores only the data its feature scope requires, never tracks shoppers across sites, and ships zero third-party calls by default. Combine it with the Wimakeit GDPR module to publish cookie banners and data-subject request forms compliant with Belgian, French and Dutch DPA guidance. Wimakeit's EU-based hosting partners (OVH Roubaix / Gravelines, Cblue Gembloux) keep every customer's data inside the EU.
About Wimakeit 1
Wimakeit is an Adobe-certified Magento partner agency based in Presles, Wallonia (between Charleroi and Namur), Belgium, building Magento and Mage-OS stores since 2020 across BE / FR / NL. Every module on this marketplace runs in production on at least one Wimakeit client (we eat our own dog food). Direct line to the developers who built the code, multilingual support (FR / EN / NL), CET business hours, no offshore handoff. See our portfolio for the kind of Magento builds we ship.
Found something not covered by the FAQ?
Report a bug or ask a question — the form is prefilled with this module.
Found a bug? Tell us about it.
A short form opens in a new tab — the module name and your language are already filled in. Share what you tried, what went wrong, and we will get back to you within one business day.
Report a bug for Gallery
Module SKU: wimakeit-module-gallery · Language: en_US
Need help?
Our team is available to assist with integration.