gumlet/magento-image-optimization

Magento 2 module to optimize image delivery for Product and Store Images using Gumlet CDN.

1.0.6 2025-09-01 13:33 UTC

Requires

• php: >=7.4.0
• magento/framework: >=102.0.0

MIT

• Gumlet

README

Automatically optimize images in Magento using Gumlet CDN.

Features

• Seamless integration with Gumlet CDN for optimized image delivery
• Works with product images, CMS, email, and widget images
• Uses theme configuration for width detection

Installation

Composer (Recommended)

composer require gumlet/magento-image-optimization

After Composer Install

Enable and activate the module in your Magento installation:

bin/magento module:enable Gumlet_Image
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Manual

1. Copy the Image folder to app/code/Gumlet/ in your Magento installation.
2. Run:

   bin/magento setup:upgrade
   bin/magento cache:flush
   

Usage

No manual configuration required. All product and media images will automatically be optimized using Gumlet CDN.

Configuration

• Width is determined from the theme's view.xml or block context.
• No admin configuration required.

Compatibility

• Magento 2.3 and above

Changing Secure Base URL for Media to Gumlet

To deliver all Magento media assets (images, etc.) via Gumlet, update your secure base media URL:

1. Login to Magento Admin
2. Go to Stores > Configuration > General > Web
3. Expand the Base URLs (Secure) section
4. Find Base URL for User Media Files
5. Change the value from:

   {{secure_base_url}}media/
   

   to your Gumlet media URL, e.g.:

   https://your-gumlet-domain.gumlet.io/media/
   

6. Click Save Config
7. Flush cache: bin/magento cache:flush

Note:

• This will route all media requests through Gumlet. Make sure your Gumlet origin is set to your Magento media directory.
• If you want to revert, simply change the value back to {{secure_base_url}}media/.

Support

For issues, please open an issue on the repository or contact Gumlet support.

License

MIT