bnomei / kirby3-thumb-imageoptim
Kirby 3 Thumb Driver using Imageoptim
Fund package maintenance!
bnomei
Patreon
buymeacoff.ee/bnomei
paypal.me/bnomei
Installs: 349
Dependents: 0
Suggesters: 1
Security: 0
Stars: 7
Watchers: 1
Forks: 0
Open Issues: 3
Type:kirby-plugin
Requires
- php: >=7.2.0
- getkirby/composer-installer: ^1.1
- imageoptim/imageoptim: ^1.3
Requires (Dev)
- getkirby/cms: ^3.2
- php-coveralls/php-coveralls: ^2.1
- phpunit/phpunit: ^8.3
Suggests
- bnomei/kirby3-srcset: Srcsets for img and picture element with optional lazyloading markup (js lib not included)
- dev-master
- 2.0.2
- 2.0.1
- 2.0.0
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.0
- 1.1.7
- 1.1.6
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.1
- 1.0.0
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.7
- 0.5.6
- 0.5.5
- 0.5.4
- 0.5.3
- 0.5.2
- 0.5.1
- 0.5.0
- dev-dependabot/composer/guzzlehttp/guzzle-7.4.5
- dev-dependabot/composer/guzzlehttp/psr7-2.2.1
- dev-dependabot/composer/getkirby/cms-3.5.8
This package is auto-updated.
Last update: 2022-07-29 14:53:12 UTC
README
The used php lib will most likely not recieve an update for php 8 so I decieded to drop support for this plugin.
Kirby 3 Thumb Imageoptim
Kirby 3 CMS Thumb Component to optimize images using ImageOptim Api.
Commercial Usage
Support open source!
This plugin is free but if you use it in a commercial project please consider to sponsor me or make a donation.
If my work helped you to make some cash it seems fair to me that I might get a little reward as well, right?
Be kind. Share a little. Thanks.
‐ Bruno
M | O | N | E | Y |
---|---|---|---|---|
Github sponsor | Patreon | Buy Me a Coffee | Paypal dontation | Hire me |
Installation
- unzip master.zip as folder
site/plugins/kirby3-thumb-imageoptim
or git submodule add https://github.com/bnomei/kirby3-thumb-imageoptim.git site/plugins/kirby3-thumb-imageoptim
orcomposer require bnomei/kirby3-thumb-imageoptim
Requirements
- ImageOptim API key (trial available). This plugin uses v1.3.1.
Setup
In your site/config.php
options set the ImageOptim API key.
'options' => [ 'bnomei.thumbimageoptim.apikey' => 'YOUR_API_KEY_HERE', // ... other options ]
TIP: You can also set a callback if you use the dotenv Plugin.
'bnomei.thumbimageoptim.apikey' => function() { return env('IMAGEOPTIM_APIKEY'); },
Usage
Generate thumbs as usual using resize()
File Method or the srcset()
function.
$img = $page->image('ukulele.jpg'); echo $img->resize(234)->html();
If you want your image to be optimized but retain their original size use: $img->thumbimageoptim()
. You can providing a width or height but its optional.
$img = $page->image('ukulele.jpg'); echo $img->thumbimageoptim()->html(); // matches echo $img->resize($img->width())->html();
TIP: if you use
$img->resize()
without a param you will not generate a thumb and it will not be optimized.
This plugin will work with the Srcset Plugin but be aware that depending on your srcset config a lot of files might be requested to be optimized. The requests are not send aync but one after another waiting for the response. The plugin will discard unfinished requests on next retry.
Settings
bnomei.thumbimageoptim. | Default | Description |
---|---|---|
apikey | callback or null |
Your imageoptim apikey as string. |
enabled | true |
set to false to disable optimization with this plugin |
forceupload | false |
set to true when images are not public available (like a website with htpasswd). |
timelimit | null or int |
if int value is set set_time_limit will be called for each request |
apirequest | array |
default io_quality and io_dpr values |
Localhost and forceupload
Content is always uploaded on localhost. The allow_url_fopen
PHP setting must be enabled for the API to do uploading. Check with ini_get('allow_url_fopen')
. Please be aware of the potential security risks caused by allow_url_fopen
!
Disclaimer
This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.
License
It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.