onedesign / oneimgix
在Craft中处理Imgix的工具
2.0-beta.10
2020-11-19 03:29 UTC
Requires
- php: ^7.0
- craftcms/cms: ^3.0.0-RC1
- imgix/imgix-php: dev-main
Requires (Dev)
- roave/security-advisories: dev-master
- dev-master
- v2.x-dev
- 2.0-beta.10
- 2.0-beta.9
- 2.0-beta.8
- 2.0-beta.7
- 2.0-beta.5
- 2.0-beta.4
- 2.0-beta.3
- 2.0-beta.2
- 2.0-beta.1
- 1.3.0
- 1.2.1
- 1.2.0
- 1.1.1
- v1.1.0
- v1.0.0
- dev-feature/api-update
- dev-bugfix/composer-package
- dev-bugfix/update-imgix-dep
- dev-feature/175101592-publications-should-support-multiple-authors
- dev-dev
- dev-craft-3
This package is auto-updated.
Last update: 2024-09-11 16:14:46 UTC
README
在Craft中处理Imgix的工具
安装
- 下载并解压文件,将
oneimgix
目录放入你的craft/plugins
目录 - -或者- 使用Composer安装:
composer require onedesign/oneimgix
- 在Craft控制面板下的设置 > 插件中安装插件
- 插件文件夹应该命名为
oneimgix
,这样Craft才能识别它。GitHub最近开始在zip文件下载的文件夹名称中附加-master
(分支名称)。 - 如以下说明更新插件的设置。
使用
配置
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缓存。