🎉 Good news: Since the latest versions Kirby have supported ICC profiles for quite a while now, this is plugin is now obsolete!
This is not directly related for ImageKit for Kirby 2, but based on the same idea of improving Kirby’s built-in image processing capabilities.
Adds support for color-managed thumbnails to Kirby 3. It does so by converting all thumbnails to sRGB color space and embeds an ICC v2 profile for best compatibility across devices and screens. It also provides basic (optional) image size optimization. In the future, it might also support more fine-grained control over the output profile and rendering intend.
⚠️ This is an experimental plugin and probably far from being complete. As Kirby’s built-in image processing will probably get an overhaul in the foreseeable future, this might also be just an intermediate solution.
Download and copy this repository to /site/plugins/imagekit
.
git submodule add https://github.com/fabianmichael/kirby3-imagekit.git site/plugins/imagekit
Composer setup is not yet available during early development.
⚠️ As the GD library does not support color management, you need to use the im
driver in order to make this plugin work.
Your server needs to have a recent version of ImageMagick available on the command line that was compiled with LittleCMS for color management support. You can check this by logging into to server via SSH and type convert --version
(assuming, that ImageMagick is in your PATH). This should give you a result like this:
Version: ImageMagick 7.0.11-14 Q16 x86_64 2021-05-31 https://imagemagick.org
Copyright: (C) 1999-2021 ImageMagick Studio LLC
License: https://imagemagick.org/script/license.php
Features: Cipher DPC HDRI Modules OpenMP(5.0)
Delegates (built-in): bzlib fontconfig freetype gslib heic jng jp2 jpeg lcms lqr ltdl lzma openexr png ps tiff webp xml zlib
If you can spot lcms
in the Delegates line, you’re good to go! :-)
If you also want to optimize your images for filesize, please also install the corresponding command line tools. This will probably not be possible in most shared hosting environments. ImageKit currently relies on a custom configuration of the spatie/image-optimizer package for that purpose, please refer to their installing instructions at https://github.com/spatie/image-optimizer#optimization-tools.
Delete the conents of your media
folder to clear existing thumbnails.
Option | Type | Required | Default | Description |
---|---|---|---|---|
optimize | bool | false |
false |
Will optimize your images by using a bunch of command-line tools, which need to be installed separately. |
MIT
Written by Fabian Michael and inspired by input from Florian Karsten and the Kirby community.