README

丹，你能优化这份文档吗？

Elgentos Convert

这是一个将 Magento 2 连接到Convert的模块。

安装

Composer

要安装此模块，请运行

composer require elgentos/magento2-convert
bin/magento setup:di:compile
bin/magento setup:upgrade

配置

当模块在 Composer 中需要并通过设置安装时，我们需要配置商店配置设置。

导航

进入 Magento 后台
按 Stores
按 Settings -> Configuration
按 Extensions (取决于 Magento 版本) -> Elgentos -> Convert

现在您已进入模块的设置。这里有两个选项

Enabled（是/否）- 这决定了功能是否激活。
Convert JS URL（从 Convert 获得的 URL）- 这是用于从 Convert 加载 JavaScript 的 URL

页面类型

要设置 _conv_page_type 值，您可以使用我们的准备好的块 convert.page-type。这是一个示例，我们将页面类型设置为 Foo Bar。

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceBlock name="convert.page-type">
            <arguments>
                <argument name="_conv_page_type" xsi:type="string">Foo Bar</argument>
            </arguments>
        </referenceBlock>
    </body>
</page>

通过使用此布局并正确处理，您可以配置在哪个位置使用哪种页面类型。

事件

通过 JavaScript

如果您想向 conv 推送事件，我们有一个可以使用的函数

convQPush(12345);

这可以在整个页面上使用，并且会在您加载脚本的任何地方加载。如果模块在商店配置中未启用，此函数不会破坏您的应用程序。它将创建一个模拟函数，以便应用程序不会崩溃。

通过 XML

这将在页面加载时触发一个事件以转换。您可以在任何您想要的处理中创建布局文件。

这是一个示例，当用户在布局文件 checkout_cart_index.xml 中打开购物车时触发事件。

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceContainer name="head.additional">
            <block
                    name="convert.event.view_cart"
                    template="Elgentos_Convert::event.phtml"
                    ifconfig="elgentos_convert/general/enabled"
            >
                <arguments>
                    <argument name="event_id" xsi:type="number">12345</argument>
                </arguments>
            </block>
        </referenceContainer>
    </body>
</page>

elgentos/ magento2-convert

维护者

详细信息