PHPackages                             elgentos/magento2-imgproxy-prismic-support - 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. [Utility & Helpers](/categories/utility)
4. /
5. elgentos/magento2-imgproxy-prismic-support

ActiveMagento2-module[Utility & Helpers](/categories/utility)

elgentos/magento2-imgproxy-prismic-support
==========================================

Integration between Elgentos Imgproxy and Prismic IO modules for Magento 2

1.0.0(4mo ago)0634↓43.8%1MITPHPPHP ^8.3

Since Jan 9Pushed 4mo agoCompare

[ Source](https://github.com/elgentos/magento2-imgproxy-prismic-support)[ Packagist](https://packagist.org/packages/elgentos/magento2-imgproxy-prismic-support)[ RSS](/packages/elgentos-magento2-imgproxy-prismic-support/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

elgentos/magento2-imgproxy-prismic-support
==========================================

[](#elgentosmagento2-imgproxy-prismic-support)

Integration module that connects the [elgentos/magento2-imgproxy](https://github.com/elgentos/magento2-imgproxy) and the [elgentos/magento2-prismicio](https://github.com/elgentos/magento2-prismicio) extensions for Magento 2.

What it does
------------

[](#what-it-does)

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

Requirements
------------

[](#requirements)

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

Installation
------------

[](#installation)

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

Configuration
-------------

[](#configuration)

No additional configuration needed. The module:

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

Scope
-----

[](#scope)

**Supported:**

- Standalone Prismic Image blocks (`Elgentos\PrismicIO\Block\Dom\Image`)

**Not supported:**

- Images embedded in RichText blocks (different rendering pipeline)

How it works
------------

[](#how-it-works)

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.

Troubleshooting
---------------

[](#troubleshooting)

### Images not transforming

[](#images-not-transforming)

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
    ```

### Inspect rendered HTML

[](#inspect-rendered-html)

To verify URL transformation is working:

```

```

### Enable debug logging

[](#enable-debug-logging)

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
```

Architecture
------------

[](#architecture)

- **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.

License
-------

[](#license)

MIT

Support
-------

[](#support)

For issues or feature requests, please contact

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance77

Regular maintenance activity

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60% 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

Unknown

Total

1

Last Release

129d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88a6d8dc588e8f2a0948335563a754687f71304f0bd3b7f7049d4bcdc00a563c?d=identicon)[peterjaap](/maintainers/peterjaap)

---

Top Contributors

[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (3 commits)")[![rjnicolai](https://avatars.githubusercontent.com/u/47178192?v=4)](https://github.com/rjnicolai "rjnicolai (2 commits)")

### Embed Badge

![Health badge](/badges/elgentos-magento2-imgproxy-prismic-support/health.svg)

```
[![Health](https://phpackages.com/badges/elgentos-magento2-imgproxy-prismic-support/health.svg)](https://phpackages.com/packages/elgentos-magento2-imgproxy-prismic-support)
```

###  Alternatives

[yireo/magento2-webp2

Magento 2 module to add WebP support to the Magento frontend

2091.2M7](/packages/yireo-magento2-webp2)[tig/postnl-magento2

TIG Magento 2 PostNL extension

58544.2k4](/packages/tig-postnl-magento2)[lillik/magento2-price-decimal

Magento 2 Price Decimal Precision

111147.5k](/packages/lillik-magento2-price-decimal)[nosto/module-nostotagging

Increase your conversion rate and average order value by delivering your customers personalized product recommendations throughout their shopping journey.

27659.1k4](/packages/nosto-module-nostotagging)[magepal/magento2-customeraccountlinksmanager

Customer Account Links Manager for Magento2 allows you to quickly and easily remove unwanted links from customer account dashboard

4084.9k](/packages/magepal-magento2-customeraccountlinksmanager)[doofinder/doofinder-magento2

Doofinder module for Magento 2

13204.0k1](/packages/doofinder-doofinder-magento2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)