i-lateral/silverstripe-deferedimages

Deferres loading of template images

Silverstripe Defered Images Module

, _(*1)

Module that loads images as a very low res version first, then uses JavaScript to load the full version, _(*2)

Now implements heyday/silverstripe-responsive-images without any extra configuration. Simply configure the responsive images module as you normally would and call them in the template., _(*3)

Installation

install via composer, _(*4)

composer require i-lateral/silverstripe-deferedimages

Setup

By default this is added to the PageController if it's available. This can be added to extra controller via config.yml:, _(*5)

<YourController>:
  extensions:
    - DFT\SilverStripe\DeferedImages\ControllerExtension

Theme

This module has a small theme addon that needs to be added you your theme stack in config.yml to load it's template., _(*6)

SilverStripe\View\SSViewer:
  themes:
    - 'custom' //your_theme
    - 'deferedimages'
    - '$default'

Alternatively, you can copy the template into your own theme., _(*7)

Configuration

By default all images called in the templates using the standard $Image.Type() call will be defered., _(*8)

The temporary image can be customised in size, quality and appearance via config:, _(*9)

DFT\SilverStripe\DeferedImages\DeferedImage:
    pixelate: 15 // Applies a pixelation effect to the current image with a given size of pixels.
    blur: 50 // Apply a gaussian blur filter with a optional amount on the current image. Use values between 0 and 100.
    quality: 10  // Define the quality of the encoded image. Data ranging from 0 to 100.
    scale: 100 // Will resize the image to a percentage amount. 100 = current size, 50 = half size, etc.
    limit: 1000 // sets a maximum width for the defered image - will force scaling if original image is larger than this.

To enable deferring of images added in a HTMLEditorField you will need to enable the included shortcode parser via _config.php:, _(*10)

<?php

use SilverStripe\View\Parsers\ShortcodeParser;
use DFT\SilverStripe\DeferedImages\DeferedImageShortcodeProvider;

ShortcodeParser::get('default')
    ->register('image', [DeferedImageShortcodeProvider::class, 'handle_shortcode']);