undkonsorten/html-mail-utility

邮件工具：内联 CSS 和纯文本

维护者

详细信息

github.com/undkonsorten/html_mail_utility

源代码

问题

安装: 4

依赖关系: 1

建议者: 0

安全: 0

星级: 0

关注者: 4

分支: 0

开放性问题: 0

类型：typo3-cms-extension

1.0.0 2024-03-14 08:42 UTC

Requires

GPL-2.0+ 1798cbba1674266367434427f2f2917d67ea1924

  • Felix Althaus <felix.althaus.woop@undkonsorten.com>

This package is auto-updated.

Last update: 2024-09-14 09:48:00 UTC

README

这是做什么的？

扩展 html_mail_utility 集成了一些第三方库，这些库是进行 HTML 电子邮件营销活动所需的。每个库都包含一个适用于 USER 或 USER_INT 的 Fluid 视图助手或类。

  • Inky 是一组标签，如 <container> 或 <row>，将被转换为备受喜爱的石时代 <table> 标记。本扩展利用了 PHP 实现 hampe/inky

  • CSS 内联是邮件营销中另一个常见的任务。为此目的，集成了 tijsverkoyen/css-to-inline-styles。

  • 对于 HTML 和纯文本的多部分消息，集成了 html2text/html2text，以便您可以在邮件构建过程的最后将 HTML 转换为纯文本。

所有三个依赖项都通过接口解耦。因此，可以通过配置或运行时切换具体实现。

安装

Composer 安装

只需要求扩展。依赖项将自动安装。

composer require undkonsorten/html-mail-utility

非 Composer 模式

不支持使用 composer 以外的模式使用！

Fluid 视图助手

要开始使用视图助手，请勿忘记在模板文件中包含相应的命名空间

<html xmlns:m="http://typo3.org/ns/Undkonsorten/HtmlMailUtility/ViewHelpers">

Inky 视图助手

<m:format.inky gridColumns="16" aliases="{bricks:'column'}">

参数

  • markup (字符串，可选)：您可以通过此属性传递标记。留空不设置以使用标签内容。
  • gridColums (整数，可选)：设置此值以更改基于网格系统的列计算。默认为 12。
  • aliases (数组，可选)：别名允许您为 inky 标签定义别名，例如在上述示例中用 <bricks> 替换 <column>。

输出

具有 inky 标签的标记转换为表格旧格式。

小心未缓存的动作!!!

未缓存的动作将不会使用 Inky 渲染。转换不会工作，并且此动作的完整输出将不会显示！您没有未缓存动作的输出！

CSS 内联视图助手

<m:css.inline cssFile="EXT:my_ext/Resources/Public/Css/Mail.css">

参数

  • html (字符串，可选)：您可以通过此属性传递 HTML 标记。留空不设置以使用标签内容。
  • css (字符串，可选)：在此处放置额外的 CSS 样式。
  • cssFile (字符串，可选)：您可以为内联指定 CSS 文件。您可以使用 EXT: 语法。

输出

根据匹配的 CSS 规则具有内联 style 属性的 HTML 标记。

纯文本视图助手

<m:format.plainText>
  • html (字符串，可选)：您可以通过此属性传递 HTML 标记。留空不设置以使用标签内容。
  • baseUrl (字符串，可选)：如果设置，此值将被添加到所有站点链接之前，以便从纯文本中访问。如果您的标记包含绝对链接，则不需要此设置。