PHPackages                             novactive/ezcloudinarybundle - 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. [Image & Media](/categories/media)
4. /
5. novactive/ezcloudinarybundle

AbandonedEzplatform-bundle[Image & Media](/categories/media)

novactive/ezcloudinarybundle
============================

Novactive eZ Cloudinary Bundle is an eZPlatform bundle for Images optimizations and manipulations.

1.0.0(5y ago)31.1k5MITPHPPHP ^7.3

Since Aug 25Pushed 4mo ago11 watchersCompare

[ Source](https://github.com/Novactive/NovaeZCloudinaryBundle)[ Packagist](https://packagist.org/packages/novactive/ezcloudinarybundle)[ Docs](https://github.com/Novactive/NovaeZCloudinaryBundle)[ RSS](/packages/novactive-ezcloudinarybundle/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

Novactive eZ Cloudinary Bundle
==============================

[](#novactive-ez-cloudinary-bundle)

---

This repository is what we call a "subtree split": a read-only copy of one directory of the main repository. It is used by Composer to allow developers to depend on specific bundles.

If you want to report or contribute, you should instead open your issue on the main repository:

Documentation is available in this repository via `.md` files but also packaged here:

---

[![Downloads](https://camo.githubusercontent.com/60e705dbc0422b5e3bfd2836be241a2dd592c081d5a9ac9393d5534b078c98fb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f766163746976652f657a636c6f7564696e61727962756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/novactive/ezcloudinarybundle)[![Latest version](https://camo.githubusercontent.com/869d2ec0695e928c6028e00e4b66a4b7e3c088888ee664cad7b413bd995c75bb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f4e6f766163746976652f4e6f7661655a436c6f7564696e61727942756e646c652e7376673f7374796c653d666c61742d737175617265)](https://github.com/Novactive/NovaeZCloudinaryBundle/releases)[![License](https://camo.githubusercontent.com/a436a252d6234546adf960980e75d1a5bed33938b39feeab53d32fc99939eb85/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e6f766163746976652f657a636c6f7564696e61727962756e646c652e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Novactive eZ Cloudinary Bundle is an eZPlatform bundle for Images optimizations and manipulations.

This bundle brings the power of [Cloudinary](https://demo.cloudinary.com/?mode=default) in your eZ Platform project.

For this first version, the plugin allows you to define Cloudinary Variation on top of eZ Variations. Images stay on your servers but the SRC is adapted to make Cloudinary rendering/manipulating images.

> All the configuration is SiteAccessAware then you can have different one depending on the SiteAccess

INSTALL
-------

[](#install)

### Use Composer

[](#use-composer)

Add the lib to your composer.json, run `composer require novactive/ezcloudinarybundle` to refresh dependencies.

Then inject the bundle in the `bundles.php` of your application.

```
    Novactive\Bundle\eZCloudinaryBundle\NovaeZCloudinaryBundle::class => [ 'all'=> true ],
```

### Setup your credentials

[](#setup-your-credentials)

```
nova_ezcloudinary:
    authentification:
        cloud_name: 'demo'
        api_key: "xxxxx"
        api_secret: "xxxx"
```

Usage
-----

[](#usage)

This bundle mimics the native image variation system.

```
parameters:
    nova_ezcloudinary.default.cloudinary_variations:
            simpletest1:
                ezreference_variation: 'Native eZ Variation Name, ~ means original'
                filters: # look at the documentation on Cloudinary
                    width: 200
                    height: 200
                    gravity: 'face'
                    radius: 'max'
                    effect: 'sepia'
            simpletest2: # look at the documentation on Cloudinary
                ezreference_variation: 'medium' # Cloudinary manipulation are going to be base on the medium alias
                filters: # look at the documentation on Cloudinary
                    transformation:
                        width: 300
                        height: 300
                        effect: 'sepia'
                        radius: 'max'
                        fetch_format: 'auto'
                        angle: 45
```

In your template

```
    {{ ez_render_field( content, "image",{
        "parameters": {"alias": 'simpletest2'},
        "attr" : { "class" : "img-responsive" }
    }
    ) }}
```

Automatically, `nova_ezcloudinary_alias` will be used instead of `ez_image_alias`. The bundle fallback on the native Variation system if the alias name does not exist in `cloudinary_variations`

Then basically there is no change in your code, just yaml configuration for your Variation.

> if you have overrided the content\_fields, be sure to update the call to `nova_ezcloudinary_alias`

### Chained Transformations

[](#chained-transformations)

Chained transformations can be done by adding an array to the configuration like so:

```
filters:
  transformation:
    - secure: 'true'
      crop: 'crop'
      height: 823
      width: 1920
      quality: 'auto:best'
    - crop: 'crop'
      y: 0
      x: 415
      width: 1234
      height: 823
      quality: 'auto:best'
    - crop: 'scale'
      width: 537
      height: 358
      aspect_ratio: '3:2'
      quality: 'auto:eco'
```

Local mode
----------

[](#local-mode)

This bundle uses the fetch mode of Cloudinary, then images have to be "reachable" to be converted. BUT, obviously your localhost is not public, to bypass that situation, we recommand the usage of `ngrok`

Let's assume your webserver listen on the TCP port 42080

```
$ ngrok http 42080
```

You will get something like: `http://xxxxx.ngrok.io`And you can set up that in the configuration:

```
parameters:
    nova_ezcloudinary.default.cloudinary_fecth_proxy:
        host: xxxxx.ngrok.io
```

> you can do your own tunnel, here, but `ngrok` is really good at it

Local mode without Cloudinary
-----------------------------

[](#local-mode-without-cloudinary)

You can also disable all Cloudinary variations for you local usages, using only native ezplatform variation:

```
parameters:
    nova_ezcloudinary.default.cloudinary_disabled: true
    nova_ezcloudinary.default.cloudinary_fallback_variation: original # Will replace all unknown variation by original
```

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance51

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

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

2136d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/313532?v=4)[Sébastien Morel](/maintainers/Plopix)[@Plopix](https://github.com/Plopix)

![](https://www.gravatar.com/avatar/7bf781acfc713c38985bfb2e7bee5fd2decefdeed1df550643af57aa8e315db7?d=identicon)[Almaviacx](/maintainers/Almaviacx)

---

Top Contributors

[![Plopix](https://avatars.githubusercontent.com/u/313532?v=4)](https://github.com/Plopix "Plopix (14 commits)")

---

Tags

imagesezpublishnovactiveezplatform

### Embed Badge

![Health badge](/badges/novactive-ezcloudinarybundle/health.svg)

```
[![Health](https://phpackages.com/badges/novactive-ezcloudinarybundle/health.svg)](https://phpackages.com/packages/novactive-ezcloudinarybundle)
```

###  Alternatives

[rosell-dk/webp-convert

Convert JPEG & PNG to WebP with PHP

6049.0M59](/packages/rosell-dk-webp-convert)[mmo/faker-images

Different images provider for Faker

56403.1k7](/packages/mmo-faker-images)[wp-media/imagify-plugin

Image optimization plugin for WordPress by WP Media.

8067.5k](/packages/wp-media-imagify-plugin)[spatie/pixelmatch-php

Compare images using PHP

58104.2k18](/packages/spatie-pixelmatch-php)[andrewgjohnson/imagettftextblur

imagettftextblur is a drop-in replacement for imagettftext with added parameters to add blur, glow and shadow effects to your PHP GD images

28249.2k2](/packages/andrewgjohnson-imagettftextblur)[moc/imageoptimizer

Flow package that optimizes generated thumbnail images (jpg, png, gif, svg) for web presentation.

31109.5k](/packages/moc-imageoptimizer)

PHPackages © 2026

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