【三瑞】折扣超市 · Discuz! 插件介绍

admin

# 【三瑞】折扣超市 · Discuz! 插件介绍

> 版本：2.07 ｜ 适配：Discuz! X2 / X2.5 / X3 / X3.1 / X3.2 / X3.3 / X3.4 / X3.5 / X5.0 / X5.1


## 一、插件简介

一款**开箱即用的折扣超市 / 小型电商插件**，让 Discuz! 论坛在几分钟内变身成一间完整的在线超市。从商品上架、分类管理、购物车、下单支付到订单发货与售后，前台体验与主流电商一致，后台操作简单直观，无需任何编程基础即可运营。

插件自带商品、分类、购物车、订单、优惠券、会员等级、积分、卡密、收货地址、快递运费等**完整闭环**，支持**电脑版 + 手机版**双端自适应，并内置字体图标（iconfont）导航、数据统计、隐私脱敏等细节，既适合真实经营，也适合作为论坛的积分商城 / 福利超市使用。

**一句话概括：一套插件 = 一个完整的在线折扣超市。**

---

## 二、核心亮点

| 亮点 | 说明 |
|---|---|
| **完整电商闭环** | 商品 → 分类 → 购物车 → 结算 → 支付 → 发货 → 收货 → 订单管理，全流程覆盖 |
| **三尺寸轮播 Banner** | 每张轮播可分别上传大 / 中 / 小三张图，前台按屏幕自动匹配，多图自动轮播 |
| **双端自适应** | 电脑版与手机版均为独立精美模板，自动识别设备；可选套用论坛头尾 |
| **四种支付方式** | 系统积分支付、余额支付、支付卡密、线下付款，可按需开关 |
| **会员等级体系** | 按累计消费自动匹配等级，等级折扣实时作用于下单金额 |
| **积分体系** | 积分支付可选用站点任一系统积分类型（积分名称自动跟随系统）；单一「积分与现金比率」全站统一（默认 100 积分 = 1 元），展示与支付同口径 |
| **优惠券** | 后台发行 → 前台领券中心领取 → 结算页选券抵扣 |
| **无限级分类** | 支持任意层级子分类，可粘贴文本批量导入、一键生成超市常用分类 |
| **字体图标导航** | 手机版底部导航内置 iconfont 图标，可视化点选，随主题缩放着色 |
| **卡密自动发货** | 卡密类商品付款后自动发放卡密，无需人工发货 |
| **隐私安全** | 首页「最新成交」仅展示脱敏用户名与商品信息，杜绝隐私外泄 |
| **数据报表** | 后台经营统计 + 会员个人消费统计（趋势、排行、状态分布） |
| **不影响论坛** | 独立数据表、独立页面，安装/卸载干净，不改动论坛核心数据 |

---

## 三、环境与兼容

- **适用程序**：Discuz! X2 / X2.5 / X3 / X3.1 / X3.2 / X3.3 / X3.4 / X3.5 / X5.0 / X5.1
- **数据库**：MySQL 5.5 及以上（兼容 5.7 / 8.0）
- **独立数据表**：19 张（全部以 `pre_sanree_supermarket_` 开头，与论坛数据互不干扰）
- **插件文件**：138 个，安装于 `source/plugin/sanree_supermarket/`
- **语言编码**：简体中文（UTF-8）/ 繁体中文（UTF-8）
- **移动端**：自动识别手机访问，展示手机版页面，可选套用论坛手机版框架

---

## 四、前台功能详解

### 4.1 首页
- **顶部轮播 Banner**：支持多张图片自动轮播（圆点指示 / 左右箭头 / 触屏滑动），**每张图可分别上传大（电脑）/ 中（平板）/ 小（手机）三种尺寸**，前台按屏幕宽度自动选用最合适的一张，既保证清晰度又节省流量；未添加轮播图时自动回退为默认横幅。
- **分类九宫格**：以图标 + 名称展示商品分类，点击进入分类商品页。
- **推荐商品**：后台标记为「推荐」的商品优先展示。
- **最新商品**：按上架时间倒序展示最新商品。
- **热门商品**：按商品浏览量智能排序，自动推荐最受欢迎的商品。
- **最新成交动态**：实时滚动展示全站最近成交记录（**用户名已脱敏、仅含商品名与数量**，保护买家隐私）。
- **数据概览**：显示全站商品总数、分类总数等统计信息。

### 4.2 商品列表 / 分类页
- 支持按分类筛选，多级分类逐层下钻。
- **多种排序**：默认、最新、价格从低到高、价格从高到低、人气（浏览量）。
- 分页浏览，每页数量后台可配置。
- 商品卡片统一展示：主图、名称、卖点副标题、折扣价、市场价、会员价标签、已售件数、浏览量。

### 4.3 商品详情页
- **图片展示**：主图 + 图集（支持批量上传多张）。
- **价格体系**：折扣价 / 市场价（划线价）双价对比，会员登录后额外显示**会员专享价**。
- **商品信息**：卖点副标题、库存状态（剩余件数 / 不限量 / 已售罄）、已售件数、浏览量。
- **商品类型**：实物商品 / 卡密商品（卡密商品下单后自动发放，无需物流）。
- **购买入口**：加入购物车、立即购买。
- **买家评论**：评分 + 图文评论展示（可设置是否需要审核）。
- **收藏功能**：一键收藏 / 取消收藏。

### 4.4 购物车
- 商品的加入、删除、数量增减、批量选择结算。
- 实时库存校验，超出库存自动提示。
- 小计 / 合计金额计算。
- 会员登录后显示**会员价小计、折扣金额与预计应付**。

### 4.5 结算下单
- **收货地址**：从地址簿选择，支持新增 / 管理，**省市区三级联动**。
- **配送方式**：选择快递公司，运费按规则自动计算（见下方「运费规则」）。
- **优惠券**：选择可用券，实时抵扣（满门槛可用，抵扣额不超过商品金额）。
- **会员折扣**：按会员等级自动折扣商品金额。
- **支付方式**：积分支付 / 余额支付 / 支付卡密 / 线下付款（按后台开关展示）。
- **订单备注**：可填写配送要求等买家留言。
- **智能判断**：全为卡密商品时无需填写收货地址；含实物商品时强制选择地址与配送方式。

### 4.6 四种支付方式
| 支付方式 | 说明 |
|---|---|
| **积分支付** | 消耗站点系统积分（类型后台可选）下单，消耗数量按全站唯一汇率「积分与现金比率」折算（默认 100 积分 = 1 元） |
| **余额支付** | 使用论坛账户余额直接支付 |
| **支付卡密** | 输入卡号 + 卡密，按卡内余额一次性抵扣订单金额 |
| **线下付款** | 提交订单后与商家联系付款，由管理员在后台确认收款 |

### 4.7 订单中心
- **我的订单**：按状态分类查看（全部 / 待付款 / 待发货 / 待收货 / 已完成 / 已取消）。
- **订单详情**：商品清单、收货信息、支付信息、订单状态流转、物流信息（快递公司 + 运单号）。
- **订单操作**：立即支付、取消订单、确认收货、删除订单（已付款订单不可删除）、**再来一单**（一键复购）。
- **卡密订单**：付款后自动发放卡密，订单详情页查看并可随时保存（提示「遗失不补」）。

### 4.8 会员中心「我的」
- 会员等级卡片：显示当前等级、积分、升级进度。
- 快捷入口：我的订单、我的收藏、浏览历史、我的优惠券、我的评论、我的卡密、收货地址、消费统计、使用教程。
- 欢迎信息与个人中心一站式管理。

### 4.9 会员等级与积分
- **会员等级**：按累计成交金额自动匹配等级；等级名称、门槛区间、折扣率均可后台自定义；实时显示当前等级、升级进度与等级权益。
- **积分体系**（仅两项设置，口径唯一）：
  - **积分类型**：全站积分口径的唯一来源——既决定积分支付扣减的系统积分类型（威望 / 金钱 / 贡献…），也决定前台积分显示的名称（如选「金钱」则前台显示「金钱」）。
  - **积分与现金比率**：全插件唯一汇率，N 积分 = 1 元，**默认 100（即 1 元 = 100 积分）**；前台展示换算与积分支付折算均按此计算，两处天然同口径。
  - 等级门槛与等级判定**始终以订单金额（元）为口径**，不受展示换算影响。

### 4.10 优惠券
- **领券中心**：展示在售优惠券，一键领取。
- **我的券**：查看已领优惠券及使用状态。
- 优惠券支持金额、使用门槛（满减 / 无门槛）、发行数量、有效期等规则，结算页可直接抵扣。

### 4.11 其他前台功能
- **我的收藏**：收藏商品列表，支持取消收藏、清空收藏夹。
- **浏览历史**：自动记录浏览过的商品，支持清空记录。
- **评论**：对已购商品发表评分与评论。
- **收货地址簿**：多地址管理、省市区联动、默认地址设置。
- **我的卡密**：集中查看已购买 / 已发放的卡密信息。
- **消费统计**：会员个人维度的数据报表——累计消费 / 累计订单 / 客单价、近 30 天消费与下单趋势曲线、订单状态环形图、我买过的商品 Top 10。
- **帮助中心**：内置「优惠券使用教程」「商品卡密使用教程」两篇图文教程，顶部导航「帮助」下拉、会员中心「使用教程」入口、页脚帮助链接三处可达；教程内容可在后台自由修改。

### 4.12 手机版与底部导航
- 自动识别手机访问，呈现独立的手机版页面（与电脑版一一对应）。
- **底部导航栏**：图标 + 名称，内置 **iconfont 字体图标**可视化选择，可自由增删、排序、显示 / 隐藏；清空则不显示导航栏。
- 可选套用论坛手机版框架（含论坛底部导航），或使用插件独立页面。

---

## 五、后台功能详解

后台入口：**Discuz! 后台 → 应用 → 插件 → 【三瑞】折扣超市**，共 14 个功能模块：

| 模块 | 功能说明 |
|---|---|
| **基本设置** | 17 项插件参数配置（见第六节），包括开关、数量、SEO、支付、积分、会员等级等 |
| **商品** | 商品增删改查；主图上传或外链；图集批量上传；商品类型（实物 / 卡密）；折扣价 / 市场价；库存；推荐标记；排序；批量上架 / 下架 / 删除 |
| **分类管理** | 无限级分类增删改；分类图标；拖拽式排序；**粘贴文本批量导入**（按缩进层级、自动去重）；**一键载入超市常用分类示例**；分类树折叠；商品数量统计 |
| **轮播图** | 首页顶部轮播图增删改；**大 / 中 / 小三尺寸图片**（电脑 / 平板 / 手机）分别上传或填外链；跳转链接；排序与显示 / 隐藏；未添加时前台显示默认横幅 |
| **订单管理** | 订单列表与筛选；订单详情；**确认收款**（线下付款）；**发货**（填写快递公司与运单号）；取消订单；删除订单；卡密发放状态 |
| **数据统计** | 经营数据报表：成交额、订单量、趋势、商品排行等 |
| **会员等级** | 等级增删改（名称、消费额区间、折扣率、显示顺序）；积分设置（**积分类型** + **积分与现金比率**，共两项） |
| **消费会员** | 会员列表；累计消费与等级信息；手动调整会员等级 |
| **快递管理** | 快递公司增删改（名称、编码）；**基础运费**；**满额包邮**门槛设置 |
| **卡密管理** | 卡密库维护，为卡密商品配置可发放的卡号 / 卡密；内置**「使用教程」子页签**，就地查看「后台设置卡密教程」并可一键跳转编辑 |
| **优惠券管理** | 优惠券发行：名称、优惠金额、使用门槛、发行数量、开始 / 结束日期、排序、状态 |
| **评论管理** | 评论审核（开启审核后需通过才显示）；删除不良评论 |
| **底部导航** | 手机版底部导航增删改；**iconfont 字体图标可视化选择**；排序与显示 / 隐藏 |
| **教程管理** | 编辑三篇内置教程——**优惠券使用教程**（前台帮助中心）、**商品卡密使用教程**（前台帮助中心）、**后台设置卡密教程**（后台卡密管理页）；标题 / 副标题 / 正文（支持简单 HTML）/ 显示状态均可修改，保存时自动过滤脚本与内联框架 |

### 运费规则
订单运费 = 快递公司**基础运费** + **每件加收运费** ×（商品件数  1），商品金额达到**满额包邮**门槛时整单免运费。

---

## 六、插件设置项（17 项）

| # | 设置项 | 说明 |
|---|---|---|
| 1 | 是否启用 | 关闭后前台显示「暂未开放」提示 |
| 2 | 开启手机版 | 自动识别手机访问并展示手机版页面 |
| 3 | 前台使用论坛头尾 | 电脑版 / 手机版前台套用论坛页头页脚 |
| 4 | 列表每页数量 | 前台商品列表每页显示数量 |
| 5 | 首页显示数量 | 首页推荐商品与最新商品的显示数量 |
| 6 | 货币符号 | 显示在价格前的符号（默认 ￥） |
| 7 | 页面标题 | 前台页面标题与默认名称 |
| 8 | SEO 关键词 | 首页 keywords 标签内容 |
| 9 | SEO 描述 | 首页 description 标签内容 |
| 10 | 版权隐藏密码 | 输入后可隐藏前台底部出品方信息 |
| 11 | 留言需审核 | 评论是否需后台审核后显示 |
| 12 | 积分类型 | 全站积分口径唯一来源：积分支付扣减的系统积分类型（extcredits 1-8），同时决定前台积分显示名称；推荐在「会员等级 → 积分设置」里下拉选择 |
| 13 | 积分与现金比率 | 全插件唯一汇率：N 积分 = 1 元，默认 100（即 1 元 = 100 积分），前台展示换算与积分支付折算均按此计算 |
| 14 | 每件加收运费 | 快递基础运费之外每多一件加收的运费，0 表示不加收 |
| 15 | 开启卡密支付 | 结算时可使用支付卡密抵扣 |
| 16 | 开启线下付款 | 结算时可选择线下付款 |
| 17 | 开启会员等级 | 开启后按等级折扣率优惠商品金额 |

---

## 七、安装与升级

### 安装
1. 通过 Discuz! 后台「应用中心」在线安装，或手动将 `sanree_supermarket` 目录上传至 `source/plugin/`。
2. 进入 **后台 → 应用 → 插件**，找到【三瑞】折扣超市，点击「安装」。
3. 安装时自动创建 18 张数据表，并写入示例分类、常用快递公司与默认底部导航，可直接体验。
4. 在「插件 → 设置」中完成基本参数配置，即可开始上架商品。
5. （可选）在论坛导航中添加入口链接：`plugin.phpid=sanree_supermarket`

### 升级
- 直接覆盖插件文件后，进入后台插件列表点击「升级」即可。
- 升级脚本幂等安全，自动补齐新增数据表与字段，**不影响已有商品、订单与配置数据**。

### 卸载
- 后台卸载插件即可移除配置；数据表可选择保留或清理，卸载过程不影响论坛其它数据。

---

## 八、更新日志

| 版本 | 主要更新 |
|---|---|
| **2.11** | **新增帮助教程体系**：前台新增「帮助中心」（优惠券使用教程 / 商品卡密使用教程），顶部导航「帮助」下拉、会员中心「使用教程」入口、页脚帮助链接三处可达；后台新增「教程管理」模块与卡密管理「使用教程」子页签（后台设置卡密教程），教程内容后台可编辑（支持简单 HTML，保存时自动过滤脚本 / 内联框架 / 事件属性），新增 `sanree_supermarket_help` 数据表，安装 / 升级自动补种内置教程 |
| **2.10** | **积分设计重做**：设置项由 4 项精简为 2 项——**积分类型**（全站唯一来源，同时决定支付扣减类型与前台显示名称）+ **积分与现金比率**（全插件唯一汇率，默认 100 积分 = 1 元）。删除「积分单位名称」「积分换算单位」两个易与比率冲突的反向配置，彻底消除「展示口径 ≠ 支付口径」问题 |
| **2.09** | 积分支付改为消耗**站点系统积分**：「会员等级 → 积分设置」新增**积分类型下拉**（威望 / 金钱 / 贡献…），并可设置**「元  积分」比率（默认 100 积分 = 1 元）**；所选类型未启用时自动回退到可用类型 |
| **2.08** | 新增首页顶部轮播图：每张可分别上传大 / 中 / 小三尺寸图片（电脑 / 平板 / 手机），前台按屏幕自动匹配；后台新增「轮播图」管理模块 |
| **2.07** | 新增「积分与现金比率」后台设置（默认 1:1）；修复电脑版「我的订单」商品图撑大界面问题 |
| **2.06** | 积分单位名称、积分换算单位可后台设置；等级门槛与判定仍按元计算 |
| **2.05** | 前台全站价格位置按会员等级显示会员价；未登录显示引导；购物车会员折扣与预计应付 |
| **2.04** | 后台分类管理支持子分类折叠 / 展开（状态自动记住） |
| **2.03** | 修复手机版首页分类字体图标未居中显示问题 |
| **2.02** | 首页 / 详情 / 订单详情 / 购物车页新增「按浏览量显示热门商品」 |
| **2.01** | 订单「再来一单」一键复购功能 |
| **1.99** | 商品已售件数实时统计与展示 |
| **1.98** | 首页「最新成交」动态（用户名脱敏，保护隐私） |
| **1.97** | 分类支持独立字体图标（iconfont），随主题缩放着色 |
| **1.95** | 消费会员模块：会员消费数据实时聚合、限制会员拦截 |
| **1.93 ~ 1.94** | 会员等级体系：按累计成交金额自动匹配等级、等级折扣、下单快照 |

---

## 九、为什么选择【三瑞】折扣超市

- **真·开箱即用**：安装即自带示例分类、常用快递与导航，省去从零搭建的麻烦。
- **双端精美**：电脑版与手机版均经过独立设计与实测，移动端体验与主流电商看齐。
- **够用且专业**：会员等级、积分、优惠券、卡密、运费规则、数据报表——经营所需一应俱全。
- **注重隐私**：成交动态脱敏展示，绝不泄露买家信息。
- **运营友好**：后台 12 个功能模块布局清晰，参数说明详尽，非技术人员也能轻松上手。
- **持续迭代**：版本持续更新，功能与体验不断打磨。

---

## 十、版权与支持

- **开发者**：淮南市三瑞网络科技有限公司
- **官网**：dx.sanree.magicfafa.com
- **版权声明**：本插件为商业软件，购买后请遵循授权许可使用。

> 如需定制功能、二次开发或技术支持，欢迎通过官方渠道联系我们。