yoshop/安装说明.md

# 系统使用要求
### 小程序要求
```
申请微信小程序
通过微信认证
申请微信支付商户
```
### 服务器最低要求
```
1核CPU
2G内存
2M带宽
```
### 系统环境要求
```
PHP版本 >= 5.4  (推荐PHP7.1版本)
MySql版本 >= 5.5  (需支持innodb引擎)
Apache 或 Nginx
服务器支持https
```


# 第一步：服务端安装

**推荐环境**
- 一、进入宝塔面板 新增网站
- 二、删除默认生成的文件
- 三、上传后端项目文件
- 四、导入数据库
- 五、修改项目的数据库配置文件
- 六、设置web运行目录
- 七、部署ssl证书
- 八、后端安装完成

**友情提示**

服务器端推荐使用`宝塔Linux面板`作为集成环境

宝塔安装地址：http://www.bt.cn/download/linux.html

##### 一、进入宝塔面板新增网站

##### 二、删除默认生成的文件

##### 三、上传后端项目文件、使用压缩包上传

##### 四、导入数据库，第一次安装选择`install.sql`

##### 五、修改项目的数据库配置文件、位于/source/application/database.php

##### 六、设置web运行目录、位于/web

##### 七、部署ssl证书

##### 八、后端安装完成

```
商户后台登录地址
http://www.你的域名.com/index.php?s=/store
超管后台登录地址 (商业版系统)
http://www.你的域名.com/index.php?s=/admin
账户名：admin
密码：yinghuo

友情提示：
为安全起见，请及时修改默认的用户名密码。
```
# 第二步：小程序端安装

- 一、记录AppID和AppSecret
- 二、配置小程序域名白名单
- 三、下载微信小程序开发者工具
- 四、导入前端项目
- 五、修改配置文件
- 六、配置成功

##### 一、记录AppID和AppSecret

这两个参数十分重要，请务必保存好，也不要泄露给他人。

##### 二、配置小程序域名白名单

在此处填写您项目的服务端的域名，例如：www.shop.cn

##### 三、下载微信小程序开发者工具

下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html ,下载完成后安装并打开。

##### 四、导入前端项目

##### 五、修改配置文件

修改siteinfo为您项目的域名，注意域名格式不要错，域名后面要有斜杠`/`，例如：https://www.shop.cn/

##### 六、配置成功

# 第三步：商城基本配置

- 一、商户后台 - 小程序配置
- 二、小程序首页设计

##### 一、商户后台 - 小程序配置

```
`AppID` 和 `AppSecret` 必须填写，用于请求微信的官方api。
`微信支付商户号` 和 `微信支付密钥` 必须填写，用于使用微信支付。（微信支付商户平台-api秘钥设置）
`apiclient_cert.pem` 和 `apiclient_key.pem` 用于操作微信支付退款，如果您的商城不涉及退款的操作，可不填此项。
```

##### 二、小程序首页设计

可在该页面修改小程序端的页面元素、顶部导航栏和标题等信息，可自定义DIY排版。
# 微信小程序直播
> 受疫情影响，商家纷纷转型线上，直播也成为了链接“暂停营业”商家与“闭门在家”消费者的重要销售渠道！
萤火小程序商城直播功能今日正式上线，商家可通过微信小程序直播实现用户互动与商品销售的闭环，达成私域流量的激活与转化。
微信小程序直播插件免费使用，商业用户可升级到v1.1.40版本免费领取该插件。

### 一、如何开通小程序直播?
登录 “[微信小程序运营平台](https://mp.weixin.qq.com/ "微信小程序运营平台")”，点击左侧菜单栏 “直播”，符合微信准入要求可直接开通

点击此处查看[《微信小程序直播功能准入要求》](https://res.wx.qq.com/mmbizwxampnodelogicsvr_node/dist/images/access_02b58d.pdf "《微信小程序直播功能准入要求》")

### 二、如何在小程序商城中使用直播功能
 
##### 1.首先将萤火小程序商城系统升级到v1.1.40及以上版本

打开小程序端项目 **app.json** 文件，添加如下插件代码

**注意**：如果没有开通直播权限，添加该插件代码会报错。小程序端添加完成后，需提交代码发布上线

```json
  "plugins": {
    "live-player-plugin": {
      "version": "1.0.3",
      "provider": "wx2b03c6e691cd7370"
    }
  },
```
##### 2.在 “[微信小程序运营平台](https://mp.weixin.qq.com/ "微信小程序运营平台")” 中创建直播间

##### 3.打开萤火小程序商城商户后台

找到 [应用管理] - [小程序直播] - [直播间管理]，点击 “同步直播间”按钮，将直播间列表导入商城系统中。

##### 4.将小程序直播页面路径，添加到首页入口

直播页路径：`pages/live/index`


# 常见问题

- 在线客服管理
- 如何对接第三方客服系统
- 小程序端非合法域名提示
- 小程序端授权登录失败
- 商品海报生成失败

### 在线客服管理
客服功能使用指南：https://developers.weixin.qq.com/miniprogram/introduction/custom.html

网页版客服工具：https://mpkf.weixin.qq.com/

### 如何对接第三方客服系统
对接美洽客服：https://meiqia.com/updates/update_logs_wo-men-zhi-chi-xiao-cheng-xu-jie-ru-le

对接芝麻小客服：https://www.kancloud.cn/wikizhima/wikihotapp/540239

### 小程序端非合法域名提示
**错误提示**：request:fail url not in domain list
**解决方式**：添加小程序域名授权白名单，并重启微信开发者工具。

### 小程序端授权登录失败
**错误提示**：session_key 获取失败
**解决方式：**
```
商户后台 - 小程序设置 - 检查 AppID 和 AppSecret 是否填写正确。
检查微信开发者工具项目AppID是否与后台填写的一致（微信开发者工具 - 右上角 - 详情）。
```
### 商品海报生成失败
**错误提示**：小程序码获取失败 invalid page hint: [WkjbLa07043955]
**解决方式：**
生成小程序二维码需微信小程序先发布上线。
小程序域名白名单未配置（download域名）。
微信用户禁止了保存图片。