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

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

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

Integration between Elgentos Imgproxy and Prismic IO modules for Magento 2

1.0.1(1mo ago)01.9k↓46.4%2MITPHPPHP ^8.3

Since Jan 9Pushed 1mo 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 today

READMEChangelog (2)Dependencies (3)Versions (3)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 &gt; Stores &gt; Configuration &gt; Imgproxy &gt; General &gt; 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

46

—

FairBetter than 92% of packages

Maintenance90

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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

Every ~122 days

Total

2

Last Release

52d 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 (3 commits)")[![luitzen-elgentos](https://avatars.githubusercontent.com/u/284002891?v=4)](https://github.com/luitzen-elgentos "luitzen-elgentos (1 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

[elgentos/regenerate-catalog-urls

Regenerate Catalog URL Rewrites (products, categories, cms pages)

2842.6M](/packages/elgentos-regenerate-catalog-urls)[nosto/module-nostotagging

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

27703.7k4](/packages/nosto-module-nostotagging)[tig/postnl-magento2

TIG Magento 2 PostNL extension

59570.5k5](/packages/tig-postnl-magento2)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1011.8k26](/packages/loki-magento2-components)[zwernemann/module-withdrawal

Magento 2 EU Withdrawal Button Module - Adds a withdrawal/revocation button for orders in compliance with EU Directive (EU) 2023/2673

244.8k2](/packages/zwernemann-module-withdrawal)

PHPackages © 2026

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