j-jalving/statamic-autograph

Statamic 的电子邮件签名 <HTML> 代码生成器

1.5.1 2024-05-21 22:14 UTC

This package is auto-updated.

Last update: 2024-09-21 22:57:35 UTC


README

alt text

Statamic Autograph 是一个 Statamic 插件,可以轻松为您的团队中的每个成员创建 HTML 签名。创建您自己的独特模板,然后使用 Autograph 生成个性化的 HTML 代码,可以直接在他们的电子邮件客户端中使用。

功能

使用此插件,您可以

  • 使用 Antlers 或 Blade 文件创建电子邮件签名模板。
  • 生成可在团队喜欢的电子邮件客户端中使用的 HTML 代码。
  • 预览每个团队成员的电子邮件签名的外观。
  • 从控制面板账户或任何其他集合获取用户数据。
  • 完全可定制的布局,支持多个模板文件。

如何安装

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

composer require j-jalving/statamic-autograph

如何使用

使用 Statamic Autograph 非常简单

  1. 请确保模板文件夹(默认:resources/views/autograph)中至少有一个模板文件。一个简单的默认模板可以作为起点发布(见下文说明)。
  2. 打开 Autograph 页面,选择一个用户并点击生成按钮。
  3. 将出现一个 HTML 代码块,将其复制到您首选的电子邮件客户端。

注意:我无法为每个客户端提供说明,但通过快速 Google 搜索应该可以解决问题。

创建模板

默认情况下,插件在 resources/views/autograph 文件夹中查找 .antlers.html.blade.php 模板文件(尽管此路径可以在配置中更改)。您可以在模板中做任何其他 Antlers 视图中可以做的事情,但除此之外,还有一个 autograph 变量,其中包含所选用户的所有数据。

重要!

为了确保您的图像和链接在所有地方都能正常工作,请确保您在所有相对 URL 上使用包含的 full_url 修饰符,如下所示

<img src="{{ url | full_url }}" />

这将它们转换为在任何地方都能正常工作的绝对 URL。

配置

可以发布一个配置文件(见下文),以指定您自己的个人偏好。所有选项都在配置文件中有说明。

可发布内容

您可以使用以下方式发布所有可发布内容

php artisan vendor:publish --provider="JJalving\Autograph\ServiceProvider"

或者使用标签单独发布它们

php artisan vendor:publish --provider="JJalving\Autograph\ServiceProvider" --tag="config"
php artisan vendor:publish --provider="JJalving\Autograph\ServiceProvider" --tag="templates"

界面

界面设计得尽可能简单,以便用户使用。只需选择一个用户和一个模板,然后提交。将显示预览和 HTML 代码,可以复制。

alt text

故障排除

• 用户下拉列表为空

确保 user_collection 配置值正确。

• 模板下拉列表为空

检查配置中模板文件夹的路径(默认:resources/views/autograph),并确保其中至少有一个 .antlers.html.blade.php 模板文件。

• 我的图像无法加载

您的图像在预览窗口中可以正常工作,但无法在您的电子邮件客户端中加载?请确保您在图像 URL 上使用 full_url 修饰符。