zhicms插件wordpress安装和使用说明

ZhiCms 发布于 阅读：209 开发动态

ZhiCms 产品库 — WordPress 版插件说明

一、插件简介

ZhiCms 产品库是一款集联盟商品搜索、选品采集、商品卡片展示、AI 导购助手于一体的 WordPress 插件。支持对接大淘客和好单库两大联盟 API，覆盖淘宝/天猫、京东、拼多多、唯品会四大主流电商平台，帮助站长快速搭建好物推荐内容。

此外，插件内置 WordPress 性能优化模块，可自动移除多个无用功能，有效加速网站加载速度。

二、核心功能

1. 联盟库商品搜索

接入大淘客 + 好单库双 API，支持跨平台搜索淘宝、京东、拼多多、唯品会商品。搜索结果自动合并去重，按销量排序。

2. 选品采集入库

3. 选品库管理

进入后台 → 产品库，可管理本地商品库：

4. 商品卡片短代码

两种短代码供灵活使用：

商品卡片短代码 — 在文章任意位置插入商品：

施华蔻专业id补色发膜固色补色锁色红色紫色蓝色去黄洗发水护发素
¥0.00

渲染为美观的商品卡片，含商品图、标题、价格、优惠券标签、销量、店铺名。

产品库整页短代码 — 在页面中嵌入完整产品库：

[zhicms_page]

适用于创建独立的好物推荐页面。

5. 转链跳转

用户点击商品卡片跳转到 /zhicms/go/?id=xxx&platform=xxx，插件自动完成三级降级转链：

  1. 通过转链接口获取推广链接（含淘口令）
  2. 兜底查询本地选品库
  3. 最后调用商品详情 API 获取链接

6. 前端产品库页面

独立访问地址 /zhicms/（Rewrite Rule 虚拟页面），也可通过 [zhicms_page] 短代码嵌入任意页面。支持：

7. AI 导购助手

启用后在所有页面右下角显示悬浮机器人按钮，用户点击即可对话：

8. 编辑器按钮

在文章编辑页面，编辑器上方出现「插入商品」按钮：

9. WordPress 性能优化（内置）

插件激活后自动启用以下优化，无需额外配置：

三、安装说明

方法一：后台上传

  1. 下载插件压缩包 zhicms.zip
  2. 进入 WordPress 后台 → 插件 → 安装插件 → 上传插件
  3. 选择 zip 文件，点击「现在安装」
  4. 安装完成后点击「启用」

方法二：手动上传

  1. 将插件文件夹 zhicms 上传到 /wp-content/plugins/ 目录
  2. 进入 WordPress 后台 → 插件，找到「ZhiCms 产品库」点击启用

首次激活

插件激活时自动完成以下操作：

卸载

停用插件后，如需完全卸载，删除插件文件夹即可。停用时会自动刷新固定链接。

四、插件设置

进入后台 → 产品库 → 设置。

API 密钥配置

配置项 说明 必填
大淘客 AppKey 大淘客开放平台的应用 Key 否*
大淘客 AppSecret 大淘客开放平台的应用 Secret 否*
大淘客 PID 淘宝联盟推广位 ID，用于佣金归属 否
好单库 API Key 好单库开放平台的 API 密钥 否*

* 至少配置大淘客 AppKey+AppSecret 或好单库 ApiKey 其中一组，否则无法使用联盟搜索和采集功能。

AI 导购配置

配置项 说明 必填
启用 AI 导购 勾选后，网站所有页面右下角显示悬浮导购按钮 否
AI 接口地址 OpenAI 兼容 API 地址，例如 https://api.openai.com/v1/chat/completions 启用时必填
API Key AI 服务的 API 密钥（密码框） 启用时必填
模型名称 使用的模型，默认 gpt-3.5-turbo，支持 gpt-4、deepseek-chat 等 启用时必填
系统提示词 自定义 AI 导购角色设定，留空使用默认提示词（推荐） 否

固定链接设置

插件使用了自定义 Rewrite Rules（/zhicms/ 和 /zhicms/go/），请确保 WordPress 固定链接设置为非「朴素」模式。如果访问 /zhicms/ 404，进入设置 → 固定链接，点击「保存更改」即可刷新规则。

五、API 密钥获取

大淘客开放平台

  1. 访问 https://www.dataoke.com/ 注册账号
  2. 进入开放平台控制台 → 应用管理，创建应用
  3. 获取 AppKey 和 AppSecret 填入插件
  4. （可选）在淘宝联盟后台获取 PID（推广位），填入插件用于佣金归属

好单库开放平台

  1. 访问 https://www.haodanku.com/ 注册账号
  2. 进入个人中心 → API 管理
  3. 获取 ApiKey 填入插件

AI 大模型 (OpenAI 兼容接口)

  1. OpenAI 官方：访问 https://platform.openai.com/ 注册并获取 API Key
  2. 国产模型：支持 DeepSeek、通义千问、智谱 GLM 等兼容 OpenAI 接口格式的服务
  3. 将 API 地址和 Key 填入插件设置即可

六、REST API 接口

插件提供 REST API 供前端页面调用（不影响已禁用的 WordPress 默认 REST 端点）。

GET /wp-json/zhicms/v1/products

参数 类型 默认值 说明
source string local 数据源：local（选品库）或 api（联盟库）
keyword string — 搜索关键词
page int 1 页码
page_size int 20 每页条数（最大 50）
platform string all 平台筛选：all / taobao / jd / pdd / vip

七、WordPress 性能优化说明

插件内置 ZhiCmsOptimize 性能优化模块，激活后自动生效，移除以下 WordPress 默认功能以提升加载速度：

优化项 效果
CSS/JS 版本号 移除 ?ver=x.x.x 查询参数，利于浏览器和 CDN 缓存
版本 Generator 隐藏 WordPress 版本号，提升安全性
Emoji 脚本 减少 wp-emoji-release.min.js 等 2 个 HTTP 请求
Feed 链接 移除 head 中 RSS/Atom 订阅链接
WLW Manifest 移除 Windows Live Writer 支持链接
RSD 链接 移除 Really Simple Discovery 链接
短链接 移除 wp_shortlink_wp_head
DNS Prefetch 移除 wp_resource_hints 的 dns-prefetch
文章修订 修订版本数设为 0，不保留历史修订
自动保存 取消自动保存脚本加载
上传重命名 文件自动 MD5 重命名，防中文路径

注意：REST API 本身未被禁用（zhicms 前端搜品功能依赖 /wp-json/zhicms/v1/products），仅移除了 head 中的 REST API 链接标签。

八、常见问题

Q：为什么搜索不到商品？
A：请先检查是否已配置大淘客或好单库的 API 密钥，两个 API 至少配一组。

Q：访问 /zhicms/ 页面 404？
A：进入 WordPress 后台 → 设置 → 固定链接，点击「保存更改」刷新 Rewrite Rules。确保固定链接模式非「朴素」。

Q：商品卡片在文章中不显示？
A：检查短代码格式是否正确：

施华蔻专业id补色发膜固色补色锁色红色紫色蓝色去黄洗发水护发素
¥0.00
。确认商品已采集入库或联盟 API 可正常访问。

Q：转链跳转提示链接获取失败？
A：检查大淘客 PID 是否填写正确。同时确认 API 密钥有效且调用额度未用完。

Q：AI 导购不显示？
A：确认以下三项均已正确配置：

  1. AI 导购开关已勾选
  2. AI 接口地址和 API Key 已填写
  3. 模型名称已填写

Q：AI 导购调用报错？
A：检查 API 地址能否从服务器正常访问（支持 cURL），确认 API Key 有效且有余额。

Q：Gutenberg 编辑器无法插入短代码？
A：确认浏览器控制台无 JS 报错。插件使用 wp.data.dispatch('core/block-editor') 插入 shortcode 块，如使用自定义区块模板可能受影响，可切换到经典编辑器使用。

Q：支持哪些 PHP 版本？
A：支持 PHP 5.6 至 PHP 8.4，已做全版本兼容适配（包括 PHP 8.0 嵌套三元运算符等兼容性修复）。

Q：性能优化会和其他插件冲突吗？
A：已排除可能冲突的项（不禁用 REST API 本身）。如与其他优化插件重复设置，通常不会产生问题，多个 remove_action 调用是安全的。