onedesign/oneimgix

在Craft中处理Imgix的工具

安装: 350

依赖: 0

建议: 0

安全: 0

星标: 0

关注者: 16

分支: 1

开放问题: 0

类型:craft-plugin

2.0-beta.10 2020-11-19 03:29 UTC

README

在Craft中处理Imgix的工具

安装

  1. 下载并解压文件,将oneimgix目录放入你的craft/plugins目录
  2. -或者- 使用Composer安装:composer require onedesign/oneimgix
  3. 在Craft控制面板下的设置 > 插件中安装插件
  4. 插件文件夹应该命名为oneimgix,这样Craft才能识别它。GitHub最近开始在zip文件下载的文件夹名称中附加-master(分支名称)。
  5. 如以下说明更新插件的设置。

使用

配置

OneImgix需要配置以下设置

  • Imgix API密钥: 从Imgix控制面板获取的Imgix API密钥。
  • Imgix源名称: 在Imgix控制面板中定义的源名称。
  • 安全URL令牌: 如果你的Imgix源启用了安全URL,这应该是那里列出的安全URL令牌值。
  • 资产基本URL: 原始资产的基路径,该路径将由本插件替换为Imgix基本URL。这通常是类似http://mysite.com/assets/https://s3.amazonaws.com/my-bucket-name/的路径。

在Twig中生成图像URL

{% set url = craft.oneImgix.url(myAssetField.first, {
    w: 1000,
    h: 800,
    q: 50,
    auto: 'format',
    fit: 'max'
}) %}

可以将Imgix图像API支持的任何选项传递到这些选项中。OneImgix将负责根据插件设置将原始资产URL转换为相应的Imgix URL。

清除Imgix缓存

每当Craft中的资产被替换或删除时,OneImgix将尝试自动清除该资产的相应Imgix缓存。