j-jalving / statamic-autograph
Statamic 的电子邮件签名 <HTML> 代码生成器
Requires
- statamic/cms: ^4.0 || ^5.0
README
Statamic Autograph 是一个 Statamic 插件,可以轻松为您的团队中的每个成员创建 HTML 签名。创建您自己的独特模板,然后使用 Autograph 生成个性化的 HTML 代码,可以直接在他们的电子邮件客户端中使用。
功能
使用此插件,您可以
- 使用 Antlers 或 Blade 文件创建电子邮件签名模板。
- 生成可在团队喜欢的电子邮件客户端中使用的 HTML 代码。
- 预览每个团队成员的电子邮件签名的外观。
- 从控制面板账户或任何其他集合获取用户数据。
- 完全可定制的布局,支持多个模板文件。
如何安装
您可以在 Statamic 控制面板的“工具 > 插件”部分搜索此插件,然后点击“安装”,或者从项目根目录运行以下命令
composer require j-jalving/statamic-autograph
如何使用
使用 Statamic Autograph 非常简单
- 请确保模板文件夹(默认:
resources/views/autograph
)中至少有一个模板文件。一个简单的默认模板可以作为起点发布(见下文说明)。 - 打开 Autograph 页面,选择一个用户并点击生成按钮。
- 将出现一个 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 代码,可以复制。
故障排除
• 用户下拉列表为空
确保 user_collection
配置值正确。
• 模板下拉列表为空
检查配置中模板文件夹的路径(默认:resources/views/autograph
),并确保其中至少有一个 .antlers.html
或 .blade.php
模板文件。
• 我的图像无法加载
您的图像在预览窗口中可以正常工作,但无法在您的电子邮件客户端中加载?请确保您在图像 URL 上使用 full_url
修饰符。