1.4 2017-08-22 18:03 UTC

This package is not auto-updated.

Last update: 2020-07-25 05:23:40 UTC


Automatically optimise images that are uploaded to the SilverStripe CMS


Installation can be done either by composer or by manually downloading a release.

Via Composer

$ composer require joshcronin/silverstripe-optimisedimages


  1. Download the module from the releases page.
  2. Extract the files.
  3. Make sure the folder after being extracted is named 'silverstripe-optimisedimages'.
  4. Place this directory in your sites root directory. This is the one with framework and cms in it.
  5. Run /dev/build on your site.


The plugin extends to the onAfterUpload method of the Image object. Whenever an Image object is uploaded it will optimise the image using the options defined in app.yaml.

There are three keys in the config that are used regardless of the optimisation provider. These are Use, SaveOriginal and OriginalDir.


Use accepts two values Kraken or TinyPNG. The value is used to decide which service to use to optimise the images.


SaveOrginal accepts a boolean, if true it will keep the original image - unoptimised - at the directory specified in the OriginalDir key.


OriginalDir accepts a string representing the path to the directory that the original images should be saved to. This is only used if SaveOriginal is set to true.