Imgproxy Prismic Support

Integration module that connects the elgentos/magento2-imgproxy and the elgentos/magento2-prismicio extensions for Magento 2.

Automatically transforms Prismic CDN image URLs through imgproxy before rendering, with the main goal of Prismic API usage reduction.

These are also benefits, but these are also handled by Prismic (which uses Imgix internally);

• On-the-fly image optimization
• Responsive image sizing
• Format conversion (WebP, AVIF)
• Bandwidth savings

• PHP 8.3+
• Magento 2.4+
• elgentos/magento2-imgproxy - installed and configured
• elgentos/module-prismicio - installed and configured

composer require elgentos/magento2-imgproxy-prismic-support
bin/magento setup:upgrade
bin/magento cache:flush

No additional configuration needed. The module:

1. Respects imgproxy enable/disable setting
2. Automatically detects Prismic image blocks
3. Transforms URLs before rendering

Supported:

• Standalone Prismic Image blocks (Elgentos\PrismicIO\Block\Dom\Image)

Not supported:

• Images embedded in RichText blocks (different rendering pipeline)

The module uses a BEFORE plugin that:

1. Intercepts Elgentos\PrismicIO\Block\Dom\Image::fetchDocumentView() before it renders the HTML
2. Checks if imgproxy is enabled
3. Retrieves the image context (URL, width, height)
4. Transforms the URL through imgproxy's getCustomUrl() method
5. Modifies the context URL in-place
6. Allows the original method to proceed with the transformed URL

This ensures all standalone Prismic images are optimized through imgproxy without any template modifications.

1. Verify imgproxy module is enabled and configured:

   bin/magento module:status | grep Imgproxy

2. Check if imgproxy is enabled in system configuration:

   • Admin > Stores > Configuration > Imgproxy > General > Enabled

3. Check logs for transformation errors:

   tail -f var/log/system.log | grep IMGPROXY-PRISMIC

To verify URL transformation is working:

<!-- Before (original Prismic URL): -->
<img src="https://images.prismic.io/example/image.jpg" alt="..." width="800" height="600" />

<!-- After (imgproxy transformed URL): -->
<img src="https://imgproxy.example.com/[signature]/resize:fit:800:600/plain/https://images.prismic.io/example/image.jpg" alt="..." width="800" height="600" />

The module logs all transformations and errors with the [IMGPROXY-PRISMIC] prefix. Errors are logged at the ERROR level, so check:

grep IMGPROXY-PRISMIC var/log/system.log

• Plugin Type: BEFORE
• Target: Elgentos\PrismicIO\Block\Dom\Image::fetchDocumentView()
• Dependencies: Config and Image model from elgentos/magento2-imgproxy

The BEFORE plugin intercepts the method before HTML rendering, allowing clean URL transformation by reference modification of the context object.

MIT

For issues or feature requests, please contact info@elgentos.nl