studiomitte / brevo
将新闻通讯SaaS解决方案brevo.com(以前称为sendinblue)集成到TYPO3 CMS中
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
- 启用双确认:请始终使用双确认!
- 重定向页面ID:用户在确认双确认后将被发送到的页面
- DOI模板:用于DOI邮件的brevo模板的ID
- 属性
- 用于首名的属性:用于首名的属性名称
- 用于姓氏的属性:用于姓氏的属性名称
- 用于跟踪信息的属性:用于跟踪信息的属性名称
用法
一个新的终结器 Brevo Finisher 拦截表单数据并添加联系人。
示例配置 可在
EXT:brevo/Resources/Private/Example/brevo-example.form.yaml
中找到。
由于任何表单的字段都可能不同,您需要提供所有重要字段的对映信息
- 启用复选框:新闻通讯订阅必须是可选的。因此提供询问用户是否应发送新闻通讯的复选框。
- 电子邮件地址字段:提供包含电子邮件地址的字段信息
- 首/姓氏字段:提供包含姓名信息的字段信息
- 附加列表ID:提供字段信息或用户应添加到的静态逗号分隔的联系人列表列表。
- 附加跟踪信息:此字符串添加到联系人中,可以用作信息,或通过在此自动化过程中使用来处理联系人。
附加提示
入门
要开始一切可能有点棘手。对于发送邮件,账户需要经过验证。这已在 https://help.brevo.com/hc/en-us/articles/360016175440 中记录。
简而言之,您需要
- 至少 11 个联系人。您可以创建任何联系人
- 一个准备好的活动
(DOI)双确认邮件
对于初学者来说,开始这个过程也是有点棘手的。这已在 https://help.brevo.com/hc/en-us/articles/211244629 中记录,但仍然缺少一些重要的事情
- DOI模板需要标记为
optin
。 - DOI模板中触发确认的按钮的链接值必须为
{{ doubleoptin }}
。
按表单覆盖全局配置
以下配置可用于覆盖全局设置
- options: doiTemplateId: '14' defaultListIds: '12,34' identifier: Brevo
作者
本扩展由 StudioMitte 创建