Standalone image minification WordPress plugin

Installs: 10 427

Dependents: 1

Suggesters: 0

Security: 0

Stars: 10

Watchers: 8

Forks: 3

Open Issues: 1


1.3.1 2022-02-07 17:02 UTC

This package is auto-updated.

Last update: 2022-06-07 17:45:01 UTC


Build Status Latest Stable Version License

Standalone image minification WordPress plugin



wp-cubi-imagemin is a very simple image minification plugin for WordPress, meant to be used in a composer installation. It uses a couple of image minification tools to optimize uploaded images (jpg, png, gif and svg).

wp-cubi-imagemin is essentially a WordPress wrapper for psliwa/image-optimizer.


  • composer require globalis/wp-cubi-imagemin


The plugin will try to find the image minification tools it needs on the system. But you can provide your own binaries instead, and the plugin will use them.

To use your own binaries, just define the following constants in your configuration files, pointing to your binaries paths :

define('WP_CUBI_IMAGEMIN_PATH_BIN_ADVPNG', '/var/www/your-project/bin/advpng');
define('WP_CUBI_IMAGEMIN_PATH_BIN_GIFSICLE', '/var/www/your-project/bin/gifsicle');
define('WP_CUBI_IMAGEMIN_PATH_BIN_JPEGOPTIM', '/var/www/your-project/bin/jpegoptim');
define('WP_CUBI_IMAGEMIN_PATH_BIN_JPEGTRAN', '/var/www/your-project/bin/jpegtran');
define('WP_CUBI_IMAGEMIN_PATH_BIN_OPTIPNG', '/var/www/your-project/bin/optipng');
define('WP_CUBI_IMAGEMIN_PATH_BIN_PNGCRUSH', '/var/www/your-project/bin/pngcrush');
define('WP_CUBI_IMAGEMIN_PATH_BIN_PNGOUT', '/var/www/your-project/bin/pngout');
define('WP_CUBI_IMAGEMIN_PATH_BIN_PNGQUANT', '/var/www/your-project/bin/pngquant');
define('WP_CUBI_IMAGEMIN_PATH_BIN_SVGO', '/var/www/your-project/bin/svgo');

If you do not define one ot the binaries paths, the plugin will try to use the system version. If it doesn't find an installed version on the system, it will just skip this tool and use the other ones.

You don't need to have all the tools working, but it is recommanded to have at least pngquant, jpegoptim and gifsicle to provide a meaningfull level of minification.

Note: binary files must have execution permissions.


  • apply_filters('wp-cubi-imagemin\options', $options) : Filter the options of ImageOptimizer\OptimizerFactory (see the complete list), such as the JPG compression level (default to 85 in wp-cubi-imagemin).

  • apply_filters('wp-cubi-imagemin\custom_logger', null)) : Allow to provide a custom logger that implements Psr\Log\LoggerInterface. If no custom logger is provided, inpsyde/wonolog will be used if available.

  • apply_filters('wp-cubi-imagemin\wonolog_channel', \Inpsyde\Wonolog\Channels::DEBUG) : Filter inpsyde/wonolog log channel.

Bulk optimization

Bulk image optimization can be done using wp-cli :

  • Install wp-cli and ensure wp-cubi-imagemin is activated
  • Usage: wp media optimize <directories>... [--jpeg_level=<jpeg_level>]
  • Help: wp help media optimize

Note: thumbnails regeneration commands such as wp media regenerate will trigger plugin optimization functions as well.


Available binaries :