dutchheight/aws-serverless-image-handler

Craft CMS 插件,用于生成资源 URL

1.1.3 2020-04-17 07:22 UTC

This package is auto-updated.

Last update: 2024-09-17 17:17:37 UTC


README

All Contributors

从 twig 内部生成 AWS 无服务器图像处理器的图像处理。 更多信息 自动检测客户端 webp 支持。

Flow

需求

  • 此插件需要 Craft CMS 3.0.0-beta.23 或更高版本。
  • 需要工作状态下的 S3 卷。使用 Craft AWS S3
  • 需要工作状态下的 cloudformation 堆栈 更多信息及说明。(说明即将推出)

安装

S3

  1. 安装 S3 卷插件 使用 Craft AWS S3。以下 IAM 策略允许 craft 访问您的存储桶
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:DeleteObject",
                "s3:GetObject",
                "s3:GetObjectAcl",
                "s3:GetBucketLocation",
                "s3:ListBucket",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name/*",
                "arn:aws:s3:::bucket-name"
            ]
        }
    ]
}
  1. 创建具有以下设置的卷
    • 基础 URL 是您的 cloudfront url (*.cloudfront.net)
    • 访问密钥 ID 是您的 IAM ID
    • 秘密访问密钥 是您的 IAM 秘密密钥
    • 存储桶名称 是您的 S3 存储桶名称
    • 存储桶区域 例如 us-east-1
    • 使上传公开 false
    • 焦点 false

AWS 无服务器图像处理器

设置 S3 卷后,请按照以下说明安装插件。

  1. 打开您的终端并进入您的 Craft 项目

     cd /path/to/project
    
  2. 然后告诉 Composer 加载插件

     composer require dutchheight/aws-serverless-image-handler
    
  3. 在控制面板中,转到设置 → 插件,并单击 AWS Serverless Image Handler 的“安装”按钮。

  4. 切换 aws 图像处理器 添加到您的 s3 卷字段布局中。

用法

在您的 twig 模板中,您可以使用

{% set settings = {
    width: 2600,
    height: 450
} %}
    
{{ craft.awsserverlessimagehandler.getImgUrl(entry.slider.one(), settings) }}

这将生成资产的正确 URL。

如果您使用 asset.url 加载图像,则将提供原始源。

可用设置

贡献

欢迎拉取请求。对于主要更改,请首先提交一个问题以讨论您想要更改的内容。请确保根据需要更新测试。

额外信息

有关 AWS 无服务器图像处理器和在其他方法中使用 AWS SIH 与 Craft CMS 的更多信息,请参阅: 设置您自己的图像转换服务

许可

Craft

贡献者 ✨

感谢以下这些出色的人们 (emoji key)

此项目遵循 all-contributors 规范。欢迎任何形式的贡献!