amadeco/module-gallery-extras

Extends the Fotorama Product Gallery with additional parameters. This module is developed following Adobe Commerce coding standards.

Maintainers

Details

github.com/iparmentier/magento2-gallery-extras

Source

Issues

Installs: 4

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:magento2-module

v1.0.0 2025-03-26 15:55 UTC

Requires

  • php: ~8.1.0||~8.2.0||~8.3.0
  • magento/module-catalog: *

MIT 23aaccdf84fcbf611e1a9c525ffa26a6617fad79

This package is auto-updated.

Last update: 2025-04-15 11:16:07 UTC

README

Latest Stable Version Magento 2 PHP License

SPONSOR: Amadeco

Overview

The Amadeco GalleryExtras module enriches your Magento store by extending the native Fotorama Product Gallery. Born from the desire to overcome Magento’s limitations, this module breathes new life into your gallery by adding custom parameters that allow you to control the stage container dimensions with finesse and precision.

Features

  • Enhanced Gallery Options: Seamlessly inject extra parameters into Fotorama options:
    • minwidth: Sets the minimum width of the stage container in pixels or percentages.
    • maxwidth: Sets the maximum width of the stage container in pixels or percentages.
    • minheight: Sets the minimum height of the stage container in pixels or percentages.
    • maxheight: Sets the maximum height of the stage container in pixels or percentages.
  • Precision & Flexibility: Fine-tune your product gallery’s presentation beyond the native Magento limitations.
  • Smooth Integration: Automatically extends Magento's GalleryOptions without disrupting your theme's design.

Installation

Composer Installation

Execute the following commands in your Magento root directory:

composer require amadeco/module-gallery-extras
bin/magento module:enable Amadeco_GalleryExtras
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Manual Installation

  1. Create directory app/code/Amadeco/GalleryExtras in your Magento installation
  2. Clone or download this repository into that directory
  3. Enable the module and update the database:
bin/magento module:enable Amadeco_GalleryExtras
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Usage

Once installed, the GalleryExtras module automatically extends the Fotorama gallery options with the following new parameters (defined in theme etc/view.xml file):

  • minwidth: Stage container minimum width.
  • maxwidth: Stage container maximum width.
  • minheight: Stage container minimum height.
  • maxheight: Stage container maximum height.

Note: Magento’s default view.xml does not support these options. GalleryExtras elegantly fills this gap by injecting these parameters at runtime, giving you unparalleled control over your product gallery’s layout.

Compatibility

  • Magento 2.4.x
  • PHP 8.1, 8.2, 8.3

Contributing

Contributions are welcome! Please read our Contributing Guidelines.

Support

For issues or feature requests, please create an issue on our GitHub repository.

License

This module is licensed under the Open Software License ("OSL") v3.0. See the LICENSE.txt file for details.