diesdasdigital/kirby-3-imgix

Kirby 3 imgix 插件

安装数: 1,756

依赖: 0

建议者: 0

安全性: 0

星标: 20

关注者: 4

分支: 4

开放问题: 4

类型:kirby-plugin

2.0.0 2020-01-22 16:47 UTC

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()

用法

如果配置中设置了imgiximgix.domain,所有图像将通过imgix自动提供服务。

可以通过thumb()函数传递imgix提供的选项

$page->someImage()->image()->thumb([
  'blur' => '10',
  'con' => '40',
])->url();

从版本1.1.0开始,对Kirby内置的srcset()方法的支持得到改进,现在自动使用imgix的wh参数,而不是宽度或高度。

$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插件

diesdas.digital创建