README

Sylius Mautic 插件 是一个为 Sylius 电子商务平台设计的插件，可以将您的网站与营销自动化工具 Mautic 集成。通过此集成，您可以跟踪网站上用户的行为，以便运行有效的营销活动。

安装

1. 使用 Composer 安装插件

   composer require iam-sayco/sylius-mautic-plugin

2. 将插件添加到您的 config/bundles.php

   // config/bundles.php
   return [
       // ...
       Sayco\SyliusMauticPlugin\SaycoSyliusMauticPlugin::class => ['all' => true],
   ];

3. 在您的 config/packages/_sylius.yaml 的导入部分注册插件配置

   # config/packages/_sylius.yaml
   imports:
       ...
       - { resource: "@SaycoSyliusMauticPlugin/Resources/config/config.yml" }

4. 通过创建 config/packages/sayco_sylius_mautic.yaml 来配置插件

   在 parameters 键下放置以下配置

   sayco_sylius_mautic.tracking_config:
   track_outbound: 'true'
   track_mailto: 'true'
   track_tel: 'true'
   track_download: 'true'
   track_download_extensions: [ ".pdf", ".zip", ".doc" ]

   tracking_host 参数应设置为您的 Mautic 实例的 URL。它用于嵌入您网站中的跟踪脚本，以便将用户行为发送到 Mautic。其他配置参数用于启用或禁用特定用户行为的跟踪。

   # config/packages/sayco_sylius_mautic_plugin.yaml
   sayco_sylius_mautic.api.auth:
       baseUrl: 'https://your-mautic-instance.com'
       version: 'BasicAuth'
       userName: 'your-api-mautic-username'
       password: 'your-api-mautic-password'
   

   api.auth 参数应设置为您的 Mautic API 的身份验证详情。目前仅支持基本认证。在 Mautic 中创建一个新用户并设置该用户的角色和权限。最好仅限制为 API 操作。

5. 安装资产

   此插件使用跟踪用户行为所需的资产。要安装它们，请运行以下命令

   bin/console assets:install

用法

只需访问您的 Mautic，查看您从 Sylius 网站收集的跟踪数据。

路线图

为此插件计划了几个功能，但尚未实现（超出 MVP 范围）。如果您想为此插件做出贡献，请考虑致力于以下功能之一

1. 改进文档。
2. 增加测试覆盖率。
3. 增加实用 Twig 函数，以便轻松嵌入来自 Mautic 的内容，如表单和动态内容。
4. 使用 Mautic 邮件为 Sylius 邮件通知添加功能。
5. 使用 Mautic OAuth 在 Sylius 中验证用户。
6. 使用 Mautic 段落改进交叉销售/关联产品。
7. 根据 Mautic 段落添加基于促销条件/规则的促销。

如果您有其他功能想法，请打开问题进行讨论或提出拉取请求。

贡献

请随意通过打开问题或提交拉取请求为此插件做出贡献。所有帮助都受到欢迎，尤其是在文档和测试方面。

许可证

此插件根据 MIT 许可证发布。有关详细信息，请参阅 LICENSE 文件。

联系方式

由 Mariusz Andrzejewski 制作，致力于开源 Sayco。