studiomitte / sendinblue
2.0.2
2024-05-22 18:35 UTC
Requires
- getbrevo/brevo-php: ^1
- typo3/cms-core: ^11.5||^12.4
- typo3/cms-form: ^11.5||^12.4
Requires (Dev)
- phpunit/phpunit: ^8.5.14
- typo3/testing-framework: ^6.4
README
此扩展将新闻通讯 SaaS https://brevo.com/ 集成到 TYPO3。目前此扩展仅支持核心的表单框架,但要添加到 powermail 也非常容易。
安装与配置
目前此扩展需要基于 composer 的安装。使用 composer req studiomitte/brevo
安装它。
前往扩展配置并提供所有需要的设置
- 基本
- API 密钥:添加您可以从 https://account.brevo.com/advanced/api 获取的 API 密钥。
- 合作伙伴密钥:目前未使用
- 默认列表*:添加要添加到每个联系人的 brevo 联系人列表的 ID
- DOI
- 启用双重 opt in:请始终使用双重 opt in!
- 重定向页面 ID:用户在确认双重 opt in 后被发送到的页面
- DOI 模板:用于 DOI 邮件的 brevo 模板的 ID
- 属性
- 用于名字的属性:用于名字的属性的名称
- 用于姓氏的属性:用于姓氏的属性的名称
- 用于跟踪信息的属性:用于跟踪信息的属性的名称
使用
一个新的终结器 Brevo 终结器 拦截表单的数据并添加联系人。
示例配置 可以在
EXT:brevo/Resources/Private/Example/brevo-example.form.yaml
中找到。
由于任何表单的字段都可能不同,您需要提供所有重要字段映射信息
- 启用复选框:新闻通讯订阅必须是可选的。因此,提供询问用户是否应发送新闻通讯的复选框。
- 电子邮件地址字段:提供包含电子邮件地址的字段信息
- 名字/姓氏字段:提供包含名字信息的字段信息
- 附加列表 ID:提供字段信息或一个静态的逗号分隔的联系人列表 ID 列表,用户应被添加到其中。
- 附加跟踪信息:此字符串被添加到联系人中,可以用作信息或通过在自动化过程中使用它来处理联系人。
附加提示
入门
开始使用有些复杂。为了发送邮件,账户需要经过验证。这已在 https://help.brevo.com/hc/en-us/articles/360016175440 中记录
简而言之,您需要
- 至少 11 个联系人。您可以创建任何联系人
- 一个准备好的活动
(DOI)双重 opt in 邮件
对于初学者来说,入门也有些复杂。这已在 https://help.brevo.com/hc/en-us/articles/211244629 中记录,但仍然缺少一些重要事项
- DOI 模板需要标记为
optin
。 - DOI 模板中触发确认的按钮的链接值必须为
{{ doubleoptin }}
。
按表单覆盖全局配置
以下配置可以用于覆盖全局设置
- options: doiTemplateId: '14' defaultListIds: '12,34' identifier: Brevo
作者
此扩展由StudioMitte创建