README

欢迎来到官方Mautic TYPO3扩展。

支持的版本

我们目前支持Mautic v4。

• 对于PHP8上的TYPO3 v11及以上版本，请使用扩展版本4.4.x
• 对于PHP7上的TYPO3 v10和v11版本，请使用扩展版本4.3.x
• 对于TYPO3 v9版本，请使用扩展版本3.x

功能

Mautic TYPO3扩展具有许多功能，可让您在TYPO3中集成营销自动化工作流程。

动态内容块

是否想过根据用户的Mautic段向不同的用户提供不同的内容？使用此扩展，您将能够为特定的Mautic段在您的TYPO3网站上设置内容。这样，您将能够决定向哪些人提供哪些内容。按照好的TYPO3风格，这不仅适用于内容元素，还可以适用于整个页面或数据集、模板等。

表单同步

使用TYPO3的Mautic扩展，您可以在TYPO3后端创建表单，并且所有收集的数据也会在Mautic中！您不再需要维护两个表单，扩展会自动同步您标记为“Mautic表单”的所有表单与Mautic。然后您可以轻松地将表单结果发布到Mautic，同时您的表单将始终与您的TYPO3编辑保持最新。

自定义TYPO3表单

如果您在EXT:form组件中拥有自己的元素或类似的自定义，您应该意识到可能需要进行的适应性调整。自定义元素需要一个转换和字段属性，这取决于元素的内容和您想用它做什么。例如，对于提供GDPR复选框和链接文本的LinkedCheckbox元素，您可能不希望将数据传输到mautic。在这种情况下，您可以这样做

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['mautic']['transformation']['formField']['LinkedCheckbox'] = \Bitmotion\Mautic\Transformation\FormField\IgnoreTransformation::class;

如果您确实想将数据传输到mautic，您需要选择一个合适的转换类，并扩展自定义元素的继承以使用mautic混合。这提供了在表单模块中选择元素属性的可能性。

不处理这些自定义元素的副作用可能是表单数据无法正确传输到mautic。这只在初始设置和第一次提交带有此类未配置元素的表单时发生。一旦表单提交，这些自定义元素就会被忽略。

Mautic表单操作

直接从TYPO3表单创建联系人或修改联系人的点。

Mautic表单内容元素

如果您希望直接使用Mautic表单，您现在可以使用此扩展附带 的Mautic表单内容元素来添加它们。

跟踪脚本集成

只需单击一下按钮即可将Mautic跟踪脚本集成到您的前端！

OAuth支持

此扩展发出的所有请求都使用OAuth（Mautic最近版本仅支持OAuth2）进行安全保护。您可以在TYPO3扩展管理器中轻松配置您的API令牌。

标签

当用户访问页面时设置用户标签！

资产

使用文件关系或TYPO3链接向导，直接在TYPO3中链接到Mautic资源！

API

Mautic API（请参阅"ContactRepository"）https://developer.mautic.org/#rest-api 已提供。

安装

首先，在您的TYPO3中安装扩展marketing_automation和mautic。

之后，建立API连接

• 在Mautic中转到"API凭据"，创建一个新的"OAuth2"凭据集（将您的TYPO3网站域名作为"重定向URI"）
• 记下公开密钥和密钥
• 转到TYPO3中的"API连接"后端模块，选择"OAuth2"，并输入上述密钥
• 现在点击"通过Mautic授权"
• 会出现一个Mautic登录窗口。登录并点击"接受"

文档

文档和入门指南可在此处找到：here。

已知问题

TYPO3表单构建器

想要映射到一个字段（例如"联系电子邮件"），但找不到它？

目前，在TYPO3的字段映射中仅提供30个Mautic自定义字段。

-> 您可以使用Mautic的字段排序作为解决方案，从而控制提供的字段。

为扩展管理器打包

克隆存储库，并在扩展根目录中运行以下命令

composer package

贡献伙伴

• Beech
• Leuchtfeuer Digital Marketing
• TYPO3 GmbH

贡献

您可以通过向此存储库的master分支提交拉取请求来做出贡献。

有疑问或建议吗？

如果您发现错误或有功能请求，您始终可以在此存储库中打开一个问题。此外，您还可以访问我们的Slack（Mautic或TYPO3> 在频道#typo3-mautic上）。