OV 虚拟商城 (ov-virtual-mall)

一个功能完整的虚拟商城插件，支持虚拟商品（积分包、VIP、勋章、邀请码、兑换码、自定义称号）和实物商品，深度集成宿主积分/VIP/勋章体系。

功能特性

核心功能

• 🛒 完整购物流程：商品浏览 → 加购 → 下单 → 支付 → 自动发货
• 💰 双支付方式：积分支付 + 真实货币支付（对接宿主支付网关）
• 🎁 6 种虚拟商品自动发货：积分包、VIP 会员、勋章、邀请码、兑换码、自定义称号
• 📦 实物商品：支持物流单号录入
• 🏷️ VIP 折扣：支持自定义比例或按等级自动计算（VIP1=5%, VIP2=10%, VIP3=15%）
• 🔒 等级门槛 + 限购控制
• ⏰ 未支付订单超时自动取消
• 📊 后台仪表盘：订单统计、收入概览

前台 UI

• 🎨 响应式设计，支持 2-6 列网格自定义
• 👤 用户信息卡片：显示头像、用户名、VIP等级、积分余额
• 🏷️ 商品标签：虚拟卡/实物卡、等级要求、VIP折扣标识
• 💲 原价划线显示
• ⚠️ 购买须知警告提示
• 🔍 分类筛选 + 关键词搜索
• 📄 订单分页浏览

后台管理

• 📝 商品参数说明
• 🖼️ 图片上传（集成宿主附件管理）
• 📋 订单筛选 + 分页 + 删除
• 🏷️ 分类管理
• ⚙️ 商城设置：名称、副标题、描述、网格列数、Header导航链接

安装

将 ov-virtual-mall 目录放入 addons/ 目录下，重启服务或在后台 /admin/addons 点击"同步"。

配置

在后台 /admin/addons/ov-virtual-mall/settings 可配置：

虚拟商品自动发货

版本历史

v1.0.1 (2026-06-30)

新增功能

• 前台UI重构：参考设计稿重新布局，标题+用户信息为公共区域
• 用户信息卡片：显示头像、用户名、VIP等级、积分余额
• 商品详情增强：显示标签（虚拟卡/实物卡、等级要求）、原价划线、已售数量、VIP折扣提示、限购信息、分类信息、购买须知
• Header导航链接：后台可自定义多个导航链接（图标+文字+链接）
• 商城设置增强：支持自定义商城名称、英文副标题、描述
• 订单筛选：后台订单管理支持按状态筛选（全部/待支付/已支付/已取消/已退款）
• 订单分页：前后台订单列表均支持分页
• 商品参数说明：移至商品管理页面，方便参考
• 购买须知：商品添加/编辑时可填写购买须知
• 图片上传优化：集成宿主附件管理，支持追踪和管理
• 商城启用开关：可关闭前台侧边栏商城推荐

UI/UX 改进

• 统一使用方形圆角样式（rounded-md/rounded-lg）
• 商品卡片显示积分+现金双价格
• 分类下拉框+搜索框样式统一
• 移除商品详情页图片点击放大（简化交互）
• 顶栏简化，移除重复Logo

Bug 修复

• 修复点击分类无反应（缺少 products 视图）
• 修复点击购买无反应（缺少 checkout 视图）
• 修复订单状态显示英文（添加中文翻译）
• 修复发货信息显示原始JSON（改为友好格式）
• 修复编辑商品时 pricing_mode 丢失
• 修复退款后无法删除订单
• 修复已售数量不更新（支付后调用 decrementStock）
• 修复退款不恢复库存（添加 restoreStock）
• 修复积分扣减失败不回滚库存
• 修复购物车不检查库存
• 修复删除商品不检查关联订单
• 修复 VIP 折扣上限未生效（前端添加 Math.min 限制）
• 修复 crypto.getRandomValues 兼容性（改用 node:crypto）
• 修复 pricing_mode 迁移缺失
• 修复 SQL 注入风险（updateProduct/updateCategory 添加列名白名单）
• 修复 XSS 风险（views.mjs 添加 HTML 转义）
• 修复 addon.json 缺少 API 声明
• 修复竞态条件（支付回调前存储 payment_order_id）
• 修复库存扣减失败后仍执行自动发货
• 修复积分扣减失败不回滚库存
• 修复退款时不恢复库存
• 修复 delivery_status 无意义三元表达式
• 移除 createProduct 中的重复迁移

v1.0.0 (2026-06-28)

• 初始发布
• 完整前台购物流程
• 完整后台管理（仪表盘/商品/订单/设置）
• 积分支付 + 真实货币支付
• 6 种虚拟商品自动发货
• VIP 折扣 + 等级门槛 + 限购

作者: OV 乐在途中-社区
官网: https://bbs.o0v0.com

暂不发布
暂不发布
暂不发布
暂不发布
暂不发布