Novactive Nova eZ Platform Bundles

Novactive eZ Responsive Images Bundle

Downloads Latest version License

Novactive eZ Responsive Images is a lightweight eZ Publish 5.x|6.x bundle for Responsive Images management.


Usage and main feature

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

By default this bundle will use picturefill to load the good version of the your variations.

You can also decide to lazy load the images, in this case the bundle uses unveil.js to load the good version of the variation alias name.

Today it handles 3 versions:

  • Mobile: viewport width < 640px
  • Desktop: default choice
  • Retina: devicePixelRatio > 1,

Then it is really interesting to understand that only the good version will be loaded in the browser. The Lazy loading is based on the view port too, if an image is not visible on the screen it will be pre-loaded and loaded on the scroll action.

It means:

  • it reduces drastically the size and the load time of the page by not loading the non visible images
  • when an image is loaded, it ensures that is the adapted one.
        {{ ez_render_field(content, 'image', {
            parameters: {
                alias: 'blog_post_line_home',
                class: 'img-responsive img-rounded',
                unveiled: true,
        }) }}

Unveiled means "Lazy Loading"

Read below, you will need 2 more aliases for each current alias that you have.

Use Composer

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

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

    Novactive\Bundle\eZResponsiveImagesBundle\NovaeZResponsiveImagesBundle::class => [ 'all'=> true ],

Create the _mobile and _retina Alias Names

The bundle requires that you create 2 more alias for each alias you are using. Ex:

        reference: ~
            - { name: geometry/scaledownonly, params: [354, 224] }

        reference: gallery_full_thumbnail
            - { name: geometry/scalewidthdownonly, params: [175] }

        reference: ~
            - { name: geometry/scaledownonly, params: [708, 448] }

Load the resources in your pagelayout

        {% include 'NovaeZResponsiveImagesBundle::novaezresponsiveimages.html.twig' %}

Updated on 04--04--2022 06:10:21