# 子比超级插件 使用教程
集成 16 大功能模块的 Zibll 主题超级扩展插件，本文档逐一介绍每个模块的配置和使用方法。
—
## 目录
1. [基础设置](#基础设置)
2. [美化模块](#1-美化模块)
3. [统计模块](#2-统计模块)
4. [排行榜模块](#3-排行榜模块)
5. [广告模块](#4-广告模块)
6. [举报模块](#5-举报模块)
7. [工单模块](#6-工单模块)
8. [团购模块](#7-团购模块)
9. [商城团购模块](#8-商城团购模块)
10. [砍价模块](#9-砍价模块)
11. [抽奖模块](#10-抽奖模块)
12. [悬赏模块](#11-悬赏模块)
13. [聊天室模块](#12-聊天室模块)
14. [AI摘要模块](#13-ai摘要模块)
15. [AI文章模块](#14-ai文章模块)
16. [AI工具模块](#15-ai工具模块)
17. [字体定制模块](#16-字体定制模块)
18. [常见问题](#常见问题)
—
## 基础设置
### 环境要求
– WordPress 6.0+，PHP 8.0+
– 必须启用 **Zibll (子比) 主题**（v7.0 以上推荐 v8.x）
– 推荐开启伪静态 + `Permalink` 设置为非朴素模式
### 模块开关
前往 **子比超级插件 → 总览**，每个模块卡片右上角有开关按钮。所有模块默认启用，关闭后该模块的前后端功能均不加载。
### 前端资源
插件自动在前端注入 `zm_ajax` 对象（含 `ajax_url` 和 `nonce`），所有模块的 AJAX 请求共用此对象，无需额外配置。
—
## 1. 美化模块
提供 40+ 个 CSS/JS 美化片段，分为 5 大类别，每个片段独立开关，按需加载不影响性能。
### 使用方法
1. 前往 **子比超级插件 → 美化设置**
2. 片段按分类展示：全局效果、导航栏、卡片列表、组件装饰、交互特效
3. 点击每个片段旁的开关来启用/关闭
4. 部分片段支持鼠标光标预设（黑神话悟空/科技纪元/水晶猫/熊猫/简约灰）
5. 前端即时生效，无需刷新缓存
### 片段分类
**🌐 全局效果：** 彩虹滚动条、图标美化（86个渐变图标）、鼠标美化（5套预设）、全屏飘雪、樱花飘落、选中颜色、加载动画
**🧭 导航栏：** Logo扫光
**🃏 卡片列表：** 大屏五列卡片、卡片装饰、图片悬停发光、模块背景美化、彩色标签（5色循环）、新文章徽章、macOS圆点、标题前缀徽章（可在文章编辑时选择SVG/文字徽章）
**🧩 组件装饰：** 底部徽章按钮、翻页美化、悬浮按钮渐变、弹窗背景美化、时钟小工具、六宫格导航、侧栏动态时钟（公历/农历/节日倒计时）、数据统计条（数字滚动动画）、二次元排行榜、火焰徽章、用户信息卡片（SVG波浪封面）、新版排行榜、信息统计卡片、区块渐变背景（6套预设色）、B2风格页脚、精品推荐横幅
**✨ 交互特效：** 自定义右键菜单（毛玻璃风格）、彩色消息提示（Toast通知）、评论通知弹窗、波浪下划线、评论框装饰（企鹅背景）、评论二次元背景（25张轮换）、登录提示栏、灵动岛（iPhone风格通知）、热评弹窗、夸夸评论（随机语录一键提交）、二次元不倒翁（可拖拽互动）
> **提示：** 部分小工具类片段（六宫格导航、数据统计条、精品推荐横幅等）启用后需到 **外观 → 小工具** 中配置内容。
—
## 2. 统计模块
PV/UV 实时统计 + 每日自动收集（新注册、订单、收入、新文章、新评论）+ 可视化面板。
### 使用方法
1. 启用模块后自动开始统计，无需额外配置
2. 前往 **统计面板** 查看图表
3. 支持选择时间范围（7天/30天/365天）查看趋势
4. 数据通过 `wp_cron` 每日自动汇总
### 统计维度
– **PV** — 页面浏览量（实时）
– **UV** — 独立访客（基于IP去重）
– **新注册** — 每日新注册用户数
– **订单 / 收入** — 与子比 ZibPay 支付系统联动
– **新文章 / 新评论** — 每日新增内容统计
> **提示：** 统计使用 `transient` 缓存当日PV/UV，不依赖第三方服务，完全本地化。
—
## 3. 排行榜模块
5种排行维度 × 4种时间周期 + Widget侧栏 + 每日 cron 自动刷新。
### 排行类型
– `income` — 收入排行
– `points` — 积分排行
– `posts` — 发文排行
– `comments` — 评论排行
– `likes` — 获赞排行
### 时间周期
`daily` 日榜 | `weekly` 周榜 | `monthly` 月榜 | `all` 总榜
### 短代码
“`
“`
参数说明：
– `type` — 排行类型
– `period` — 时间周期
– `limit` — 显示数量（默认10）
– `tabs` — 是否显示Tab切换（默认1）
### Widget
前往 **外观 → 小工具**，添加 “子比排行榜” Widget 到侧栏。
> **提示：** 排行数据每日凌晨通过 `wp_cron` 自动刷新，也可在后台手动触发。
—
## 4. 广告模块
自助广告管理系统：11个广告位 + 图片/文字双类型 + 定价体系 + 审核机制 + 用户自助购买。
### 广告位
– **首页顶部全宽** — 首页导航下方，流量最大
– **文章页顶部全宽** — 文章页标题区上方
– **文章正文开头/中间/底部** — 正文内不同位置插入
– **侧边栏** — 所有页面右侧（仅PC）
– **评论区上方** — 文章评论区上方
– **页脚上方全宽** — 网站底部页脚上方
– **浮动广告** — 页面右下角浮动窗口，可关闭
– **弹窗广告** — 进入页面弹窗展示，每次会话仅一次
– **小工具专用** — 可拖拽到任意小工具区域
### 使用方法
1. 前往 **广告管理**
2. 配置各广告位的展示设置（图片/文字类型开关、每行显示数量、图片尺寸等）
3. 设置各广告位的定价方案（按天/按周/按月等）
4. 可开启审核机制：用户购买后需管理员审核通过才能上线
5. 空位自动显示占位符（”广告位招租”），支持显示最低价格和购买按钮
### 用户自助购买
广告模块自动创建前端购买页面，用户可自助选择广告位、上传素材、在线付款。支付通过子比 ZibPay 系统完成。
> **提示：** 每个广告位的图片和文字类型可以独立开关和配置，灵活组合使用。
—
## 5. 举报模块
支持举报文章、评论、用户三种类型 + 前端弹窗表单 + 后台审核管理。
### 举报原因
内置 6 种原因分类：垃圾广告、辱骂攻击、色情低俗、欺诈信息、侵犯版权、其他原因。用户可附加详细说明。
### 前端
启用后，登录用户可通过页面上的举报按钮触发举报弹窗。使用方式：在任意元素上添加 `data-zm-report=”post”` 和 `data-zm-report-id=”123″` 属性。
### 后台管理
1. 前往 **举报管理**
2. 筛选状态：待处理 / 已接受 / 已驳回
3. 点击 “接受” 或 “驳回” 处理每条举报，可附加处理备注
> **提示：** 同一用户对同一内容的重复举报会被自动拦截，需等待上一条处理完毕。
—
## 6. 工单模块
用户提交工单 + 分类/优先级 + 管理员回复 + 站内消息通知。
### 工单分类与优先级
– **分类：** 问题反馈、功能建议、账号问题、支付问题、其他
– **优先级：** 低、普通、紧急、非常紧急
– **状态：** 待处理 → 已回复 → 已关闭
### 短代码
“`
请先登录后提交工单。
— 提交工单表单请先登录查看工单。
— 我的工单列表“`
### 使用方法
1. 创建一个页面，内容写入 `
请先登录后提交工单。
`，作为用户提交入口2. 创建另一个页面，内容写入 `
请先登录查看工单。
`，用于用户查看自己的工单3. 用户提交工单后，管理员在 **工单管理** 查看和回复
4. 管理员回复时自动通过子比站内消息 `zib_message` 通知用户
—
## 7. 团购模块
文章/资源团购：Meta Box 快速开启 + 前端进度条 + 定时自动过期 + ZibPay 支付集成。
### 使用方法
1. 编辑任意文章，在右侧栏找到 **”🛒 团购设置”** 区域
2. 勾选 “开启团购”，设置原价、团购价、成团人数、截止时间
3. 发布文章后，团购组件自动显示在文章内容下方
4. 用户通过 ZibPay 支付团购价参团，达到成团人数后自动标记为成功
### 短代码（可选）
“`
“`
通常无需手动插入，开启团购后文章页会自动展示。可通过短代码手动控制展示位置。
### 后台管理
前往 **团购管理** 查看所有团购活动的状态（进行中/已成功/已失败）、参团人数等。
> **提示：** 过期的团购会被 `wp_cron` 每小时自动检查并标记为失败状态。
—
## 8. 商城团购模块
面向商城商品（`product` 类型）的团购功能，自动在商品页注入团购面板。
### 使用方法
1. 编辑任意商品（product），在右侧栏找到 **”商城团购设置”**
2. 勾选 “启用团购”，设置团购价、最少/最多人数、有效时长（小时）
3. 发布后，商品页底部自动出现团购面板（价格、进度条、参团按钮）
4. 用户余额扣费参团，达到最低人数后自动标记为成功
### 短代码（可选）
“`
“`
> **提示：** 商城团购面板通过 `the_content` 过滤器自动注入，无需手动插入短代码。
—
## 9. 砍价模块
用户发起砍价 → 分享链接给好友 → 好友帮砍随机金额 → 砍到底价后购买。与子比付费阅读价格联动。
### 使用方法
1. 编辑任意文章，在右侧栏找到 **”🔪 砍价设置”** 区域
2. 勾选 “开启砍价”，原价自动从子比「付费阅读」价格读取
3. 设置底价、总砍价次数、每人帮砍次数、库存数量
4. 可选设置活动开始/结束时间
5. 发布后，砍价组件自动显示在文章内容下方
### 短代码（可选）
“`
“`
### 功能特点
– 活动进行中时文章标题自动添加 “⚡ 砍价中” 前缀标签
– 支持库存控制：-1 = 不限，0 = 已售罄
– 支持活动时间控制：可设置开始和结束时间
– 全局默认值可在 **砍价管理** 中配置
—
## 10. 抽奖模块
大转盘 / 九宫格抽奖 + 概率算法 + 余额/积分扣费发奖 + 每日限次。
### 创建抽奖
1. 前往 **抽奖管理**，点击创建
2. 填写活动标题、选择类型（大转盘/九宫格）
3. 设置费用类型（免费/余额/积分）和消费金额
4. 配置奖品列表：每个奖品设置 名称、类型（无奖/余额/积分）、奖品值、概率权重
5. 设置每日限次（0=不限制）
6. 保存后获得抽奖ID
### 短代码
“`
抽奖加载中...
中奖公告
抽奖加载中...
中奖公告
“`
### 奖品概率说明
概率为相对权重。例如 4 个奖品的概率分别为 40、20、25、1，则谢谢参与概率为 40/86≈46.5%，大奖概率为 1/86≈1.2%。
> **注意：** 余额/积分不足时会提示用户。奖品自动通过子比 ZibPay 系统发放到用户账户。
—
## 11. 悬赏模块
论坛帖子积分悬赏系统：发帖设置悬赏 → 积分冻结 → 评论回答 → 采纳发放赏金。
### 使用方法
1. 用户在论坛发帖时勾选 “设置悬赏”，输入悬赏金额（积分）
2. 发布后积分自动从用户账户扣除冻结
3. 其他用户通过评论回答问题
4. 发帖者采纳最佳回答，赏金自动发放给回答者
5. 悬赏过期后可选自动奖励给点赞最多的回答
### 后台设置
前往 **悬赏管理**，可配置：
– 默认/最小/最大悬赏金额
– 悬赏有效期（天）
– 作者提成比例 / 平台提成比例
– 过期自动奖励、管理员介入权限
– 标题悬赏标记、内容悬赏信息框开关
### 用户中心集成
自动在子比用户中心添加 “我的悬赏” 和 “我的回答” 标签页，含悬赏统计数据。同时提供侧栏小工具。
> **提示：** 悬赏基于子比论坛帖子类型 `forum_post`，需确保论坛功能已开启。
—
## 12. 聊天室模块
实时聊天室：多房间 + 撤回 + 禁言 + @提及 + 引用 + 右键菜单 + 表情/图片。
### 短代码
“`
“`
每个页面自动创建独立房间，无需手动指定房间ID。`height` 为聊天区高度(px)。
### 功能特性
– **@提及** — 输入 @用户名 或 @全体 通知指定用户
– **引用回复** — 右键点击消息可引用回复
– **撤回消息** — 指定分钟内可撤回自己的消息
– **禁言管理** — 房间管理员可对用户禁言/解除禁言
– **表情/图片** — 支持子比主题表情包和图片上传
– **悬浮聊天按钮** — 可选注入到子比右侧悬浮栏，点击弹出聊天面板
### Widget
前往 **外观 → 小工具**，添加 “💬 子比聊天室” Widget。
### 后台设置
1. 前往 **聊天室管理**
2. 设置轮询间隔、撤回时限、图片上传开关、快捷短语等
3. 配置房间创建规则和悬浮按钮开关
> **提示：** 聊天室通过 AJAX 轮询实现实时通信，轮询间隔可在后台调整（默认3秒）。
—
## 13. AI摘要模块
文章发布时自动调用 AI 生成摘要，在文章顶部显示摘要卡片。兼容多种 AI 服务商。
### 支持的 AI 服务商
OpenAI / DeepSeek / 通义千问 / 豆包 / 智谱GLM / Kimi / 零一万物 / 百度文心（自动兼容不同响应格式）
### 配置步骤
1. 前往 **AI摘要设置**
2. 填写 API URL 和 API Key
3. 设置模型名称（如 `gpt-3.5-turbo`、`deepseek-chat` 等）
4. 自定义提示词（Prompt），控制摘要风格和长度
5. 选择启用的文章类型（默认仅 post）
6. 勾选 “自动生成” 后，新发布的文章会自动调用AI生成摘要
### 手动生成
在文章编辑页面侧栏 “AI摘要” MetaBox 中，点击 **生成/重新生成** 按钮即可。
### 前端展示
摘要自动以卡片形式插入到文章内容顶部，标注 “🤖 AI摘要” 标签和生成时间。
> **注意：** API Key 请妥善保管。文本超过 3000 字符会自动截断后送入AI处理。
—
## 14. AI文章模块
AI自动生成文章 + RSS新闻采集改写 + 自动配图 + 批量入队 + 定时发布。
### 支持的 AI 服务商
OpenAI / DeepSeek / 通义千问 / 豆包 / 智谱ChatGLM / Kimi / 零一万物 / 百川 / 百度文心 — 内置快速选择预设。
### 单篇生成
1. 前往 **AI文章**
2. 配置好 API（URL、Key、模型）
3. 在 “单篇生成” 区输入主题、选择分类和状态（草稿/直接发布）
4. 支持定时发布：选择日期时间后文章将在指定时间发布
5. 点击 “生成文章”，AI自动写出标题+正文并创建文章
### 批量生成
1. 在 “批量生成” 区，每行输入一个主题
2. 选择分类和发布间隔（分钟）
3. 点击 “加入队列”，系统通过 `wp_cron` 按间隔逐篇生成
### 📰 RSS新闻采集
1. 在 “新闻源配置” 区添加 RSS 源（内置预设：人民网/新华网/36氪/少数派/财联社等）
2. 也可输入任意自定义 RSS URL
3. 启用定时采集：设置频率（每N小时）和每次采集数量
4. 系统自动采集新闻 → AI改写为原创文章 → 自动发布
### 🖼️ 自动配图
三种图片来源可选：
– **新闻原图** — 从 RSS 提取原始图片（免费）
– **Unsplash** — 根据文章标题自动搜索高质量配图（需填 API Key）
– **AI生图** — 调用 AI 绘图接口生成封面图（需填API地址和Key）
### 生成日志
页面底部显示所有已生成文章的记录，包括文章链接、主题、模型、消耗Token数。
—
## 15. AI工具模块
集成多种 AI 功能：AI文章生成、长尾关键词批量生成、前端 AI 对话窗口、文章采集伪原创、视频生成等。
### API 配置
1. 前往 **AI工具 → API设置**
2. 选择 AI 服务商（支持 OpenAI / 智谱AI / Kimi / DeepSeek 等）
3. 填写对应的 API Key，选择模型
4. 可选：启用 “自定义API” 或 “腾讯云 DeepSeek API”（二选一）
5. 保存设置
### 功能一：长尾关键词生成
1. 前往 **关键词生成** 页面
2. 输入核心关键词（多个用逗号分隔），设置生成数量
3. 可填写额外要求（如 “希望关键词与电商相关”）
4. 点击 “生成长尾关键词”，AI 会自动调用并返回结果
5. 生成的关键词自动保存到数据库，可直接 “生成文章” 或批量操作
### 功能二：AI 文章生成
1. 前往 **文章生成** 页面
2. 输入主题关键词或自定义内容
3. 选择发布状态、分类、文章长度等参数
4. 点击生成，AI 自动生成标题 + 正文并创建文章
### 功能三：前端 AI 对话窗口
1. 在 API 设置页勾选 “启用前端交互窗口”
2. 可自定义窗口标题、欢迎消息、CSS/JS
3. 启用后前端会显示一个 AI 对话浮窗，用户可直接与 AI 交互
### 功能四：定时自动发文
1. 前往 **定时任务** 页面
2. 设置自动发文的关键词、分类、频率等
3. 启用后系统通过 `wp_cron` 按设定频率自动生成并发布文章
> **提示：** 支持多种 API 服务商：OpenAI、智谱AI（有免费模型）、Kimi（注册送额度）、DeepSeek、自定义API、腾讯云DeepSeek等。
> **注意：** “自定义API” 和 “腾讯云DeepSeek API” 只能二选一，启用一个必须禁用另一个。如需使用默认API，请确保两个功能均处于禁用状态。
—
## 16. 字体定制模块
基于 Google Fonts 的全站字体定制，支持按区域独立设置字体和字号，自动排除图标字体影响。
### 配置方法
1. 前往 **子比超级插件 → 字体定制**
2. 可分别设置 5 个区域的字体：
– **全局字体** — 影响整个站点的默认字体
– **导航栏字体** — 仅影响顶部导航区域
– **菜单字体** — 仅影响菜单和子菜单
– **文章内容字体** — 仅影响文章正文区域
– **标题字体** — 影响 H1~H6 标题，可单独设置 H1/H2/H3 字号
### 设置步骤
1. 从下拉列表选择 Google 字体（含思源黑体、思源宋体等中文字体）
2. 可选填写字号（px），留空则使用默认大小
3. 点击 “保存设置”，前端即时生效
4. 如需清除字体缓存，点击 “清除缓存” 按钮
> **提示：** 插件自动排除图标字体（FontAwesome、Dashicons、Iconfont等）的影响，确保修改字体后图标仍能正常显示。
> **注意：** 使用 Google Fonts 需确保服务器可访问 `fonts.googleapis.com`。国内服务器如无法访问，可配合 Google Fonts 镜像代理使用。
—
## 常见问题
### Q: 启用模块后前端没有效果？
**A:** 检查浏览器缓存和CDN缓存。如果使用了缓存插件（如 WP Super Cache、LiteSpeed Cache），需要清理缓存。
### Q: AJAX请求返回 403 或 0？
**A:** 通常是 nonce 过期。确保页面没有被全页缓存（登录用户应跳过缓存），或者检查安全插件是否拦截了 `admin-ajax.php`。
### Q: AI模块调用失败？
**A:** 1) 检查 API Key 是否正确；2) 检查服务器能否访问 API URL（可在服务器终端执行 `curl API地址` 测试）；3) 国内服务器建议使用兼容API代理地址或国内AI服务商。
### Q: 数据库表未创建？
**A:** 停用再重新启用插件，会触发 `dbDelta` 重建表结构。或检查数据库用户是否有 `CREATE TABLE` 权限。
### Q: 卸载插件后数据会删除吗？
**A:** 卸载（删除插件）时会清理所有 `wp_zm_*` 数据表和 `zibll_mega_settings` 选项。停用不删数据。
### Q: AI工具生成关键词无结果？
**A:** 1) 检查API设置页的API Key是否已填写并保存；2) 查看服务器日志 `debug.log` 中是否有报错；3) 确保服务器可访问所选的API服务地址；4) “自定义API”和”腾讯云API”只能二选一。
### Q: 字体定制设置后前端没效果？
**A:** 1) 检查浏览器缓存和CDN缓存；2) 确保服务器可访问 `fonts.googleapis.com`；3) 国内服务器可能需要配合Google Fonts镜像代理。
### Q: 广告位不显示？
**A:** 1) 检查广告位是否被禁用（后台广告位管理）；2) 浮动/弹窗广告需有对应类型的广告素材；3) 清除页面缓存后刷新查看。
### Q: 悬赏功能无效？
**A:** 悬赏基于子比论坛帖子类型 `forum_post`，需要确保子比主题的论坛功能已开启并正常运行。
—
> 子比超级插件 | 需要 Zibll 主题 v7.0+ | WordPress 6.0+ | PHP 8.0+ | 如有问题请联系管理员
