README

Magento 2 扩展

概述

待办事项

要求

Magento 2.3.*, PHP >7.1

安装

使用 composer 安装

composer require snk/magento2-module-usercentrics

配置详情

转到 商店->配置->Snk->用户中心

• 启用 - 启用或禁用模块作用域。
• 设置 ID - 从您的用户中心账户获取的配置 ID。
• 启用智能数据保护器 - 启用用户中心智能数据保护器。
• 启用撤销同意后页面重新加载 - 如果用户撤销同意，则重新加载页面。
• 脚本 URL - 用户中心脚本 URL。它可能已更改。
• 选择器 - 决定哪些 Magento 应用程序部分必须处理的配置。

选择器

每个选择器的 Cookie 组 与 数据处理服务 下的单独服务名称相对应。

例如，这里为 "Matomo"

有三种类型的选择器

• 块
• 模板
• 正则表达式

模块遍历 Magento 块的输出，并尝试将它们与选择器匹配。

块 选择器在布局中查找 Magento 块名称。

模板 选择器查找特定模板的 HTML。

正则表达式 选择器是最灵活且最危险的类型，它们尝试将配置的正则表达式与每个块匹配。

集成

模块通过将 <script> 标签的 type 更改为 text/plain 并添加带有 Cookie 组的 data-usercentrics 属性来调整所选 HTML 输出块中的 <script> 标签。

一些 Magento 脚本以声明方式初始化，例如

<!--- Won't work with Usercentrics -->
<script type="text/x-magento-init">
    {
        "*": {
            "Vendor_Module/js/some-cool-script": {
                "config": "value"
            }
        }
    }
</script>

遗憾的是，用户中心无法将脚本类型重置为 x-magento/init，因此必须以命令式方式执行此类调用，以便用户中心能够正常运行。

因此，上述代码应重写如下

<!--- Will work with Usercentrics -->
<script type="text/javascript">
    require([
        'jquery',
        'mage/apply/main'
    ], function ($, mage) {
        $(function () {
            mage.applyFor(
                '*',
                {
                    "config": "value"
                },
                'Vendor_Module/js/some-cool-script',
            );
        });
    });
</script>

作者

Oleh Kravets oleh.kravets@snk.de

许可证

MIT