diesdasdigital / kirby-3-imgix
Kirby 3 imgix 插件
2.0.0
2020-01-22 16:47 UTC
Requires
This package is auto-updated.
Last update: 2024-09-11 21:51:06 UTC
README
如果此插件被激活,则所有图像(除GIF外)将通过imgix提供服务。
安装
composer require diesdasdigital/kirby-3-imgix
配置
在任何配置文件或默认的site/config/config.php
return [ 'imgix' => true, 'imgix.domain' => 'https://project-name.imgix.net/', 'imgix.defaults' => [ 'auto' => 'compress', ], ];
imgix.defaults
接受一个选项映射,所有图像将自动应用这些选项,而无需调用thumb()
。
用法
如果配置中设置了imgix
和imgix.domain
,所有图像将通过imgix自动提供服务。
可以通过thumb()
函数传递imgix提供的选项
$page->someImage()->image()->thumb([ 'blur' => '10', 'con' => '40', ])->url();
从版本1.1.0
开始,对Kirby内置的srcset()
方法的支持得到改进,现在自动使用imgix的w
和h
参数,而不是宽度或高度。
$page->someImage()->toFile()->srcset([300, 800, 1024]) // with additional parameters $page->someImage()->toFile()->srcset([ 300 => [ 'width' => 300, 'crop' => 'top,left' ], 500 => [ 'width' => 500 ] ])
有关所有选项的详细信息,请参阅imgix API参考。
imgIX 源配置
如果您是imgIX的新用户,您需要执行几个额外步骤
- 注册账户
- 设置新的源
- 选择一个子域名,您希望您的资产被引用。
- 选择适合您的服务器设置的设置(如果您使用默认的Kirby设置,则为Webfolder ☺️)
- 添加Webfolder URL(对于Kirby,这将是在:project-name.com/)
受Kirby网站启发,它使用一个自定义cloudinary插件。