Creates thumbnails on demand.

Installs: 768

Dependents: 2

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0


v2.2.0 2015-08-24 19:48 UTC

This package is auto-updated.

Last update: 2021-01-07 14:03:20 UTC


Packagist Build Status HHVM Code Quality Code Coverage Downloads

The Thumbnailer module (thumbnailer) creates thumbnails from images and managed images using options or configured versions.

The module extends the Image active record with the thumbnail() method and the thumbnail lazy getter, and provides an interface to configure and manage its cache that integrates with the unified cache system of the "Cache" module (cache). The module also extends the core object with the thumbnail_versions lazy getter.


namespace ICanBoogie\Modules\Thumbnailer;

$versions = $app->thumbnailer_versions;
$versions['popover'] = [ 'width' => 420, 'height' => 340 ];
# or
$versions['popover'] = 'w:420;h:340';
# or
$versions['popover'] = '{"w":"420","h":"340"}';
# or 
$versions['popover'] = '420x340';

$thumbnail = new Thumbnail('/images/madonna.jpeg', 'popover');

echo $thumbnail;      // <img src="/api/thumbnail/420x340/fill?s=%2Fimages%2Fmadonna.jpeg&amp;v=popover" alt="" width="420" height="340" class="thumbnail thumbnail--popover" />
echo $thumbnail->url; // /api/thumbnail/420x340/fill?s=%2Fimages%2Fmadonna.jpeg&v=popover

$thumbnail = new Thumbnail('/images/madonna.jpeg', '64x64.png');

echo $thumbnail;      // <img src="/api/thumbnail/64x64/fill.png&amp;s=%2Fimages%2Fmadonna.jpeg" alt="" width="64" height="64" class="thumbnail" />
echo $thumbnail->url; // /api/thumbnail/64x64/fill.png&s=%2Fimages%2Fmadonna.jpeg

Event hooks


Adds our cache manager to the cache collection.


Adds a thumbnails section to the config block of modules defining thumbnail versions using the "thumbnails" config.


Pre-parses defined thumbnail versions before the config is saved.

Prototype methods


Adds the thumbnail_versions lazy getter to the core object. The getter returns a version collection configured with the versions saved in the registry. Third parties may alter this collection with an event hook attached to the ICanBoogie\Modules\Thumbnailer\Versions::alter event.


The package requires PHP 5.5 or later.


The recommended way to install this package is through Composer:

$ composer require icybee/module-thumbnailer

Cloning the repository

The package is available on GitHub, its repository can be cloned with the following command line:

$ git clone https://github.com/Icybee/module-thumbnailer.git thumbnailer


The test suite is ran with the make test command. Composer is automatically installed as well as all the dependencies required to run the suite. The package directory can later be cleaned with the make clean command.

The package is continuously tested by Travis CI.

Build Status Code Coverage


The package is documented as part of the Icybee CMS documentation. The documentation for the package and its dependencies can be generated with the make doc command. The documentation is generated in the docs directory using ApiGen. The package directory can later by cleaned with the make clean command.


This module is licensed under the New BSD License - See the LICENSE file for details.