---
title: 如何在 WordPress 和 WooCommerce 上安装代理
description: 介绍在 WordPress 上插入代码的三种方法，代理如何读取 WooCommerce 目录，如何处理缓存插件，以及如何将聊天与购物车关联。
section: platforms
keywords: WordPress, WooCommerce, WordPress 小部件, WordPress 聊天插件, 网站聊天, 在线客服, footer.php, 代码插入插件, AI 代理, 人工智能客服, WordPress 集成, WooCommerce 聊天, 电子商务客服, 智能客服
updated: 2026-09-06
---
在 WordPress 中，有三种插入代码的方式。您可以根据对主题文件编辑的熟悉程度进行选择。

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

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

1. 安装任何脚本插入插件：WPCode、Insert Headers and Footers、Code Snippets。
2. 打开插件设置，找到页脚代码字段——通常命名为 **Footer** 或 **Body (before closing tag)**。
3. 粘贴管理后台提供的代码行并保存。

## 方式 2：主题文件

1. **外观 → 主题文件编辑器**。
2. 打开 `footer.php`。
3. 将代码插入 `</body>` 之前。
4. 更新文件。

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

## 方式 3：通过 functions.php

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

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

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

## WooCommerce 商品目录

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

您需要了解：

- **可变商品** 将以价格范围和特性显示在商品卡片中。
- **隐藏商品和草稿** 不会被读取——这是正常情况。
- 代理不会看到**仅限授权用户可见的商品**：它会像普通访客一样浏览网站。
- 如果您有 CSV 格式的商品导出文件，可以在“商品目录”部分上传——有时这比爬取更快、更准确。

## 购物车与支付

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

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

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

## 聊天中的按钮将商品添加到 WooCommerce 购物车

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

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

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

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

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

1. 清除插件缓存：WP Rocket、W3 Total Cache、LiteSpeed 或您正在使用的任何插件。
2. 如果您使用 Cloudflare，请清除 CDN 缓存。
3. 在隐身模式下检查网站。

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

## 亮色和暗色主题

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

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

## 缓存插件

## 检查

- 聊天按钮出现在网站任何页面的右下角。
- 关于商品的提问会显示带有价格的商品卡片。
- 结账按钮会引导至 WooCommerce 购物车。
- 在移动设备上，按钮不会遮挡菜单和购物车。

## 常见问题

### 是否需要单独的 Commerce Agents 插件

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

### 小部件未出现，首先检查什么

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

### 代理是否会了解折扣和优惠券

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

### 这会拖慢网站速度吗

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

### 是否可以只在商店而不是博客中显示小部件

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