子比工单系统 (Zib Ticket System)

插件信息

功能特性

用户端功能

• ✅ 用户中心入口 – 在用户中心侧边栏显示工单中心按钮，带待处理数量角标
• ✅ 工单列表 – 分页展示用户所有工单，支持按状态筛选（全部 / 待处理 / 处理中 / 已解决）
• ✅ 工单提交 – 弹窗式提交工单，支持选择分类、设置优先级、添加附件说明
• ✅ 工单详情 – 查看工单完整内容、分类标签、优先级、处理状态及时间线
• ✅ 对话回复 – 用户可与管理员进行多轮实时对话交流
• ✅ 工单管理 – 用户可自主标记已解决或关闭工单
• ✅ 工单编号 – 自动生成唯一的工单编号，便于追踪查询

管理端功能

• ✅ 工单管理 – 后台独立工单列表，支持关键词搜索、多条件筛选、排序
• ✅ 工单处理 – 查看工单详情，进行回复处理，支持富文本编辑
• ✅ 状态管理 – 一键更新工单状态（待处理→处理中→已解决）
• ✅ 分类管理 – 后台自定义工单分类（默认：技术支持 / 账户问题 / 功能建议 / 其他）
• ✅ 优先级设置 – 支持低 / 中 / 高 / 紧急四个优先级等级，紧急工单高亮显示
• ✅ 站内信通知 – 工单状态变更、管理员回复时自动发送站内信通知用户

技术特性

• ✅ 主题原生融合 – 完全使用子比主题内置样式、图标、弹窗组件，无需额外适配
• ✅ 响应式设计 – 完美适配桌面端和移动端，支持子比主题日间 / 夜间模式
• ✅ AJAX 无刷新交互 – 前后端分离，所有操作无需页面刷新
• ✅ 完整安全机制 – 包含 nonce 验证、权限校验、输入过滤，防止 SQL 注入和 XSS 攻击
• ✅ 独立数据库设计 – 采用独立的数据表结构，不修改主题核心数据
• ✅ 自动初始化 – 插件激活时自动创建所需数据表和默认配置
• ✅ 钩子扩展支持 – 预留多个 action 和 filter 钩子，方便二次开发

文件结构

zib-ticket-system/
├── zib-ticket-system.php          # 主插件文件（入口）
├── README.md                      # 说明文档
├── assets/                        # 静态资源目录
│   ├── css/admin.css             # 管理后台样式
│   ├── js/admin.js               # 后台交互脚本
│   ├── js/frontend.js            # 前端用户脚本
│   └── images/                   # 图片资源
├── includes/                      # 核心类文件目录
│   ├── class-ticket-admin.php    # 管理功能类
│   ├── class-ticket-ajax.php     # AJAX请求处理类
│   ├── class-ticket-api.php      # API接口类
│   ├── class-ticket-database.php # 数据库操作类
│   ├── class-ticket-notify.php   # 通知系统类
│   ├── class-ticket-settings.php # 插件设置类
│   └── class-ticket-system.php   # 核心系统类
├── templates/                     # 模板文件目录
│   ├── admin/                    # 后台管理模板
│   └── user/                     # 用户端模板
└── languages/                     # 语言包目录（预留）

安装说明

系统要求

• WordPress 5.0 及以上版本
• 子比主题 (Zibll) 最新版
• PHP 7.0 及以上版本
• MySQL 5.6 及以上版本

安装步骤

1. 下载插件压缩包 zib-ticket-system-v2.0.0.zip
2. 登录 WordPress 后台，进入「插件」→「添加新插件」→「上传插件」
3. 选择下载的压缩包，点击「现在安装」
4. 安装完成后点击「启用插件」
5. 插件会自动创建所需的数据表和默认配置
6. 刷新页面后，在用户中心侧边栏即可看到「工单中心」入口

使用指南

用户操作流程

1. 登录网站账号，进入个人用户中心
2. 在「我的服务」区域点击「工单中心」进入工单列表
3. 点击右上角「提交工单」按钮，在弹窗中填写工单信息
4. 选择工单分类、设置优先级，填写标题和详细内容（支持添加附件）
5. 提交后等待管理员处理，可在工单列表查看状态
6. 收到站内信通知后，进入工单详情页查看回复并继续沟通
7. 问题解决后，点击「标记已解决」完成工单流程

管理员操作流程

1. 登录 WordPress 后台
2. 在左侧导航栏找到「工单管理」菜单
3. 查看所有用户提交的工单，支持按状态、分类、优先级筛选
4. 点击工单标题进入详情页，查看工单内容和历史回复
5. 在回复框中输入处理意见，点击「提交回复」
6. 根据处理进度更新工单状态（待处理→处理中→已解决）
7. 系统会自动发送站内信通知用户工单状态变更

数据库表结构

wp_tickets 工单主表

wp_ticket_replies 工单回复表

更新日志

v2.0.0 (2026-05-18)

• ✨ 新增工单优先级设置功能，支持 4 个等级
• ✨ 新增后台工单分类管理功能，可自定义分类
• ✨ 优化用户中心入口显示逻辑，添加待处理数量角标
• 🐛 修复工单按钮在部分浏览器不显示的问题
• 🐛 优化数据库查询性能，减少不必要的查询
• 🔄 重构代码架构，完善代码注释和文档
• 🔄 统一使用子比主题 zib_get_svg () 函数获取图标

v1.4.2 (2026-05-14)

• 🐛 修复工单提交失败问题（移除 ticket_id 字段唯一索引）
• 🐛 修复图标不显示问题（统一使用子比主题支持的图标）
• 📝 更新插件说明文档，完善常见问题解答

v1.4.1 (2026-05-14)

• 🐛 修复用户中心侧边栏图标不显示问题
• 🐛 修复工单提交时数据库字段缺失问题
• 🔄 适配现有数据库表结构，确保升级兼容性

v1.4.0 (初始版本)

• ✨ 实现用户中心工单提交功能
• ✨ 实现工单列表展示和筛选功能
• ✨ 实现工单详情查看和多轮对话功能
• ✨ 实现后台工单管理和回复功能
• ✨ 实现站内信自动通知功能
• 🎨 UI 风格与子比主题完全融合

常见问题

Q: 插件激活后用户中心看不到工单按钮？

1. 清除浏览器缓存和网站静态资源缓存
2. 清除 WordPress 对象缓存（如 Redis、Memcached）
3. 确认当前已登录用户账号
4. 检查 PHP 版本是否≥7.0
5. 确认使用的是子比主题最新版

Q: 点击提交工单按钮没有反应？

1. 是否填写了必填的标题和内容字段
2. 是否选择了工单分类
3. 打开浏览器开发者工具，查看控制台是否有 JavaScript 报错
4. 确认 WordPress 的 AJAX 功能正常工作
5. 检查是否有其他插件与本插件冲突

Q: 管理员收不到工单通知？

1. 插件已正确激活并完成初始化
2. 子比主题的站内信功能正常工作
3. 管理员账号已正确设置，且拥有管理工单的权限
4. 检查是否有安全插件拦截了站内信发送

技术支持

• 官方网站：https://1z345.cn
• 作者主页：https://1z345.cn
• 问题反馈：请通过网站工单系统提交反馈