知识库 → 平台安装

如何在 WordPress 和 WooCommerce 上安装代理

介绍在 WordPress 上插入代码的三种方法，代理如何读取 WooCommerce 目录，如何处理缓存插件，以及如何将聊天与购物车关联。

2026年9月6日

在 WordPress 中，有三种插入代码的方式。您可以根据对主题文件编辑的熟悉程度进行选择。

方式 1：代码插入插件（推荐）#

这是最安全的选项：主题更新时，您的修改不会丢失。

重要提示：请编辑子主题。更新父主题时，文件将连同您的代码一起被覆盖。

适合熟悉代码的用户。在子主题的 functions.php 中：

add_action('wp_footer', function () {
    echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="your-slug" async></script>';
});

请在管理后台点击“复制代码”按钮获取准确的脚本行。

在设置中输入您的网站地址并启动分析。爬虫通过页面的结构化数据读取 WooCommerce 商品：名称、价格、库存、描述、图片、分类。

您需要了解：

在 WooCommerce 中，通常不会在聊天中包含支付功能：商店有自己的结账系统，包含配送、税费和优惠券。

在设置中指定购物车链接，通常是 https://您的域名/cart 或 /cart。代理会将顾客引导至此处。

为了查看哪些对话转化为订单，请在“感谢您的订单”页面添加购买像素代码片段。在 WooCommerce 中，这可以是 checkout/thankyou.php 模板，或者使用带有订单页面条件的相同代码插入插件。

代理回复中的商品卡片并非仅为美观。每张卡片都包含指向您商店商品页面的链接，代理能够利用 WooCommerce 标准的添加到购物车机制：即 ?add-to-cart=123 形式的地址。

顾客点击聊天中的按钮后，商品会进入购物车，接下来您的结账系统会与所有配送、优惠券和税费插件协同工作。无需任何集成或密钥：此机制自 WooCommerce 诞生之日起就已内置。

如果链接指向可变商品页面，代理会打开该页面——顾客需要自行选择尺寸和颜色，这是正确的做法：替顾客选择有风险。

还有一点值得注意：代理会看到聊天窗口打开的页面。它会读取商品标记——名称、SKU、价格——并根据上下文进行回复。访客停留在商品卡片上并询问“有更便宜的吗？”——代理会理解比较对象，并从您的商品目录中提供替代方案，而非抽象建议。

WordPress 上“小部件未出现”的主要原因是缓存。插入代码后：

如果插件启用了“合并和延迟加载脚本”，请将我们的脚本添加到排除项：合并第三方脚本有时会破坏加载。

小部件同时支持亮色和暗色主题。在设置中，您可以选择亮色主题、暗色主题或“与访客相同”——后者会遵循设备的系统设置，并作为默认选项。

如果您的 WordPress 主题有日夜模式切换功能，这会很方便：选择“与访客相同”，聊天界面将与用户已选择的模式保持一致。

不需要。只需一行代码即可，无需单独的插件，也不需要安装。

缓存：缓存插件和 CDN。其次，检查代码是否插入了页脚，而不是任意侧边栏小部件，以及主题是否确实输出了 wp_footer()。

不会了解优惠券：它们在 WooCommerce 购物车中应用。代理显示的价格是抓取时获取的，包括商品页面上显示的折扣价。

脚本是异步的，文件很小，不会阻塞页面渲染。对 PageSpeed 的影响微乎其微。

可以，如果通过带有显示条件的插件插入代码，或者在 functions.php 中使用 is_woocommerce() 进行检查。在简单情况下，代理在所有页面上都不会造成干扰：它也会回答博客中关于配送的问题。