如何购买
1
登录您的BeikeShop商城后台
2
点击右上角“插件市场”
3
选择需要购买的插件
4
购买&安装
插件描述
Product Ranking 商品榜单装修模块
概述
Product Ranking 是一个为商城后台「设计 → 装修」功能增加商品排行榜展示模块的插件。它以选项卡形式展示「浏览榜 / 热销榜 / 加购榜」三类行为的商品排行。每个榜单可独立设置标题、统计窗口期（最近 N 天）和商品总数，无数据的榜单会自动隐藏。非常适合用于首页热门推荐、爆款展示、用户行为引导等场景。
主要功能
📊 三大商品榜单
| 榜单类型 | 说明 | 排序依据 |
|---|---|---|
| 浏览榜 | 按商品浏览次数排名 | 统计窗口期内 product_views 表的浏览次数 |
| 热销榜 | 按商品销量排名 | 统计窗口期内已支付/已发货/已完成订单的商品数量合计 |
| 加购榜 | 按加购次数排名 | 统计窗口期内 cart_products 表的加购数量合计 |
📐 灵活的配置选项
| 配置项 | 说明 |
|---|---|
| 独立榜单标题 | 每个榜单可单独设置标题（支持多语言），留空时使用默认标题 |
| 最大窗口期 | 每个榜单可独立设置统计天数（1~365天） |
| 商品总数 | 每个榜单可独立设置展示商品数量（1~50个） |
| PC每排数量 | 可设置 1~8 列 |
| 移动端每排数量 | 可设置 1~3 列 |
| 模块宽度 | 窄屏(container) / 宽屏(container-fluid) / 全屏(w-100) |
🏷️ 视觉特性
| 特性 | 说明 |
|---|---|
| 排名标记 | 每个商品左上角显示排名数字，前三名使用品牌色高亮 |
| 选项卡切换 | 点击选项卡即可切换不同榜单 |
| 无数据自动隐藏 | 窗口期内无数据的榜单在前台自动隐藏（装修预览时展示占位商品） |
| 复用商品卡片 | 使用系统主题的 shared.product 组件，保持风格统一 |
技术特点
-
✅ 精准数据统计：浏览榜按
product_views表统计，热销榜按订单状态筛选（paid/shipped/completed），加购榜按cart_products表统计 -
✅ 独立窗口期：每个榜单可设置不同的统计天数，满足不同业务需求
-
✅ 响应式网格：PC 端 1~8 列，移动端 1~3 列，自动适配
-
✅ 前三名高亮：排名 1-3 的商品排名徽章使用品牌色突出显示
-
✅ 智能隐藏：无数据的榜单在前台自动隐藏，避免空白区域
-
✅ 预览友好：装修预览时自动展示占位商品，所见即所得
-
✅ 任意主题兼容：前台视图由插件自带，商品卡片复用当前主题组件
-
✅ 装修编辑器完美支持：实时预览，配置项丰富直观
适用场景
-
首页热门商品推荐
-
爆款商品展示
-
周/月热销榜单
-
用户浏览趋势展示
-
加购/收藏排行榜
-
数据驱动的内容推荐
