state / og-generator

v1.0.0 2024-07-29 13:23 UTC

This package is auto-updated.

Last update: 2024-09-29 14:08:51 UTC


README

根据条目标题自动生成图片,通过cp自定义背景和字体!

如何安装

您可以在Statamic控制面板的“工具 > 扩展”部分搜索此插件并点击“安装”,或者从您的项目根目录运行以下命令

BASH

composer require state/og-generator

配置

您可以通过在侧边栏中点击“OG生成器”来配置cp,并自定义表单。

选项

背景

您可以通过选择背景图片或颜色来自定义背景,然后选择图片或选择颜色。

字体

您可以上传自己的ttf文件,您可以从Google Fonts下载ttf文件。然后您可以设置字体大小和颜色。

顶部和左侧将根据值进行偏移并放置文本。

大小

要设置图片大小,请设置宽度和高度。我建议最初创建一个更高分辨率的图片,因为低分辨率下的文字可能看起来模糊。

文本换行

要设置在特定点换行,请设置换行值,它是换行前的字符数,而不是像素。

集合

最后要配置的选项是选择OG生成器在保存时将运行哪些集合。

用法

如果您已配置插件在保存集合时生成,则可以像正常资产字段一样访问条目上的og_generator_image字段。

HTML

{{ if og_generator_image }}
    <meta property="og:image" content="{{ og_generator_image:permalink }}" />
{{ else }}
    {{ asset url="/assets/ogimage-default.jpg" }}
        <meta property="og:image" content="{{ permalink }}" />
    {{ /asset }}
{{ /if }}

否则,您可以使用内置标签,这些标签会在不存在时生成新图片,并在每个集合上工作。

HTML

{{ og_generator:og_image }}
<!-- outputs -->
<meta property="og:image" content="https://example.com/assets/post-slug.png" />

{{ og_generator:image class="rounded" }}
<!-- outputs -->
<img src="https://example.com/assets/post-slug.png" alt="Post Title" class="rounded" />