README.md · sheepjs/shopro-uniapp（分销商城开源商城）

## 简介

![title](https://file.sheepjs.com/www/preview/dcloud/01.png)

[![star](https://gitee.com/sheepjs/shopro-uniapp/badge/star.svg)](https://gitee.com/sheepjs/shopro-uniapp.git) [![fork](https://gitee.com/sheepjs/shopro-uniapp/badge/fork.svg?theme=gvp)](https://gitee.com/sheepjs/shopro-uniapp.git) [![version](https://img.shields.io/badge/Shopro-V1.5-brightgreen)](https://gitee.com/sheepjs/shopro-uniapp.git) [![license](http://img.shields.io/badge/license-MIT-orange)](https://gitee.com/sheepjs/shopro-uniapp.git)

[官方网站](https://www.shopro.top/) | [H5 演示](http://shopro.sheepjs.com/) | [管理系统](https://shopro.sheepjs.com/admin/) | [问题反馈](https://gitee.com/sheepjs/shopro-uniapp/issues)

</div>

## 特性

![features](https://file.sheepjs.com/www/preview/dcloud/02.png)

- **支持主题色+自定义头部导航+自定义底部导航**
- **内含沉浸式头部、通用头部导航示例，支持后端自定义配置底部导航背景和样式**
- **店铺装修组件（轮播、标题栏、优惠券、商品组、宫格导航、列表导航+广告魔方+富文本、搜索栏等众多组件）**
- **内置微信公众号分享 jssdk+微信小程序分享卡片+微信 App 分享+海报分享统一封装**
- **内置微信公众号登录+微信小程序手机号登录+微信 App 开放平台登录+账号密码登录+iOS 登录统一封装**
- **内置余额支付+微信公众号 jssdk 支付+微信小程序支付+微信 App 支付+支付宝网页支付+支付宝 App 支付统一封装**
- **支持第三方 cdn 图片资源地址，并支持阿里云、腾讯云、七牛云图片缩放参数**
- **严格适配多终端场景并支持 App 审核上架**

## 技术栈

- **前端技术栈：uni-app、ES6、Vue3、Vite、Pinia;**

## 安装

```bash
# 1.克隆项目
$ git clone https://gitee.com/sheepjs/shopro-uniapp.git
```

```bash
# 2.拷贝env示例配置文件 重命名为.env
$ cd shopro-uniapp
$ cp env .env
```

```bash
# 3.安装依赖 (需安装nodejs环境, 使用npm国内镜像)
$ npm install --registry=https://registry.npmmirror.com
```

```bash
# 4.使用HbuilderX 运行...
```

## 体验

![系统架构](https://file.sheepjs.com/www/preview/dcloud/04.png)

客户端演示地址：[https://shopro.sheepjs.com](https://shopro.sheepjs.com)

演示账号: shopro

演示密码: a123456

管理端演示地址：[https://shopro.sheepjs.com/admin/](https://shopro.sheepjs.com/admin/)

演示账号: shopro

演示密码: 123456

_（注意：演示环境已屏蔽管理权限和相关操作）_

## 项目结构

```
├── pages                   // 页面
│      ├── index            // 入口页面
│      ├── user             // 用户相关
│      ├── public           // 公共页面
│      ├── activity         // 活动页面
│      ├── app              // 积分、签到页面
│      ├── chat             // 客服页面
│      ├── commission       // 分销页面
│      ├── coupon           // 优惠券页面
│      ├── goods            // 商品页面
│      ├── order            // 订单页面
│      ├── pay              // 支付页面
├── sheep                   // 底层依赖/工具库
│      ├── api              // 服务端接口
│      ├── components       // 自定义功能组件
│      ├── config           // 配置文件
│      ├── helper           // 助手函数
│      ├── hooks            // vue-hooks
│      ├── libs             // 自定义依赖
│      ├── platform         // 第三方平台登录、分享、支付
│      ├── request          // 请求类库
│      ├── router           // 自定义路由跳转
│      ├── scss             // 主样式库
│      ├── store            // pinia状态管理模块
│      ├── ui               // 自定义UI组件
│      ├── url              // cdn图片地址格式化
│      ├── validate         // 通用验证器
│      ├── index.js         // Shopro入口文件
├── uni_modules             // dcloud第三方插件

```

## 更新

### V1.9.0 更新简介 2025/6/6
1. 新增 底部导航纯图标样式和纯文字样式
2. 新增 新版本微信商家转账，支持微信小程序和微信公众号网页
3. 修复 店铺装修->菜单栏组件，因为精度不准确导致缺失菜单的问题
4. 修复 小程序端完善身份信息时，抽屉不弹出的问题

### V1.8.7 更新简介 2024/11/22
1. 新增 订单详情页面自助申请发票
2. 修复 富文本显示行距问题
3. 修复 小程序登录模态框不显示
4. 修复 上传图片组件，无法删除图片
5. 优化 微信公众号网页授权登录，自动获取登录入口的准确路径
6. 优化 确认提交订单时候异常状态
7. 优化 活动倒计时展示效果
8. 优化 分销中心用户信息
9. 优化 客服聊天

### V1.8.6 更新简介 2024/5/15
1. 更新 跟进vite5.x重大更新，因vite5中的globEager已弃用，替换为glob
2. 更新 app端video层级过高问题，弃用原生video组件，改为html渲染video
3. 修复 确认订单获取购物车数据方法
4. 优化 购物车中处理已失效商品项
5. 优化 订单结果页添加支付询问对话框

### V1.8.5 更新简介 2024/4/15
1. 修复 商品列表切换tab时，排序字段传参问题
2. 修复 商品瀑布流列表加载更多时，高度判断问题
3. 修复 首页下拉刷新时，模板数据深层监听问题
4. 修复 购物车列表全选按钮判断有误的问题
5. 修复 分销中心我的团队列表数据过少导致无法加载更多问题

### V1.8.4 更新简介 2024/1/2

1. 修复 支付金额为 0 元时的支付跳转判断
2. 优化 用户端分类页
3. 优化 提升用户端商品列表瀑布流排序性能

### V1.8.3 更新简介 2023/10/25

1. 对接微信小程序发货管理
2. 修复路由模式为 history 时，微信公众号使用微信登录时跳转白屏 bug

### V1.8.2 更新简介 2023/09/4

1. 添加 图片热区组件
2. 添加 商品评论商家回复功能
3. 优化 购物车性能
4. 优化 搜索组件
5. 优化 动态添加直播组件
6. 优化 轮播图组件
7. 优化 微信小程序订阅消息提醒时机
8. 优化 移动小程序端客服 bug
9. 优化 h5 支付拉起微信或者支付宝客户端时,支付单查询过早的问题
10. 优化 标题栏组件
11. 优化 二级分类组件
12. 优化 规格弹框，手动输入数量无法改变数量问题
13. 优化 绑定手机号
14. 重构 瀑布流商品
15. 重构 小程序快捷登录
16. 海报图片协议转换,自动识别 https 协议
17. 升级依赖版本

### V1.8.1 更新简介 2023/03/18

1. 优化搜索组件

2. 添加多端直播组件,动态加载直播插件

3. 添加多种配送方式（货到付款、手动发货）

4. 添加发货内容详情展示

5. 优化`radio`点击效果 bug

6. 商品轮播图添加视频播放

7. 修复部分页面样式显示问题

### V1.8.0 更新简介 2023/02/07

1. 引入`luch-request`,替换`libs`中的`request`

2. 兼容`HbulderX`版本更新小程序端`v-bind`无法使用多层对象的问题

3. 优化分页数据相关页面代码

4. 富文本渲染组件使用`mp-html`替换原`su-parse`

5. 修复阶梯拼团弹框点击规格自动关闭问题

6. 自定义页面头部添加返回按钮及快捷菜单

7. 优化筛选时间可以任意选择时间问题（改为只能筛选当天及以前）

8. 修复部分页面样式显示问题

### V1.7.1 更新简介 2022/12/09

1. 更新插件市场忽略文件问题

2. 更改客服聊天图片样式问题

### V1.5 更新简介 2022/12/07

- [x] 服务保障 icon 变形问题；
- [x] 确认订单 可用优惠券逻辑修改；
- [x] `su-image`组件中`customStyle`添加`width`属性；

---

**<p align="center">如果您觉得我们的开源项目很有帮助，请点击 :star: Star(https://gitee.com/sheepjs/shopro-uniapp.git) 支持 SheepJS 开源团队:heart:</p>**

---

sheepjs/shopro-uniapp（分销商城开源商城）

简介

发行版

贡献者

语言

近期动态

sheepjs/shopro-uniapp（分销商城 开源商城） .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

语言

近期动态

搜索帮助

sheepjs/shopro-uniapp（分销商城开源商城）