# ShopXO 官方文档索引

> 整理时间：2026-04-14
> 官方文档站：https://doc.shopxo.net/
> 官方 GitHub：https://github.com/gongfuxiang/shopxo
> shopxo-uniapp：https://gitee.com/zongzhige/shopxo-uniapp

---

## 一、官方文档总入口

| 文档 | URL | 说明 |
|---|---|---|
| 文档首页 | https://doc.shopxo.net/ | PESCMS DOC 框架，文档导航 |
| 开发文档索引 | https://doc.shopxo.net/article/4.html | 包含基础教程、插件开发、API接口 |
| 插件开发文档 | https://doc.shopxo.net/article/3.html | **插件开发核心文档** |
| 目录结构 | https://doc.shopxo.net/article/4/265292898306621440.html | **系统目录结构（v1-v2）** |
| 基础配置 | https://doc.shopxo.net/?a=index&aid=262830136821284864&id=4&m=Article | 动态数据表格配置语法 |
| 系统安装教程 | https://doc.shopxo.net/article/1/260667307922030592.html | 系统安装步骤 |
| 系统演示 | https://doc.shopxo.net/article/1/260674843488288768.html | 官方演示站 |
| 更新日志 | https://doc.shopxo.net/article/1/260687012997103616.html | 版本更新历史 |
| 功能清单 | https://doc.shopxo.net/article/1/260684202096197632.html | 系统全部功能列表 |

---

## 二、插件开发文档

### 2.1 核心文档

| 功能 | 官方文档 URL | 说明 |
|---|---|---|
| 插件开发文档首页 | https://doc.shopxo.net/article/3.html | 创建插件、命名规则、目录结构 |
| **钩子响应** | https://doc.shopxo.net/article/3.html | 视图钩子详细说明 |
| **回调事件** | https://doc.shopxo.net/article/3.html | Service 层事件钩子 |
| URL生成 | https://doc.shopxo.net/article/3.html | 插件内 URL 生成方法 |
| 调试及开发模式 | https://doc.shopxo.net/article/3.html | 开发调试方法 |

### 2.2 开启开发者模式

**官方文档**：https://doc.shopxo.net/article/3.html

开启后可在后台直接创建插件，页面出现钩子提示名称。

> 文件位置：`config/shopxo.php`，将 `is_develop` 项的值由 `false` 改为 `true`。

### 2.3 插件目录结构

**官方文档**：https://doc.shopxo.net/article/4/265292898306621440.html

```
app/plugins/{PluginName}/
├── config.json              ← 插件配置（基础信息、钩子注册）
├── BaseService.php          ← 必须：配置字段 + 安装/卸载逻辑
├── view/
│   ├── Goods.php           ← 商品详情页钩子实现
│   ├── User.php            ← 用户中心钩子实现
│   └── ...
├── Admin/
│   ├── Controller/         ← 后台控制器
│   └── View/               ← 后台视图
└── Api/
    └── Controller/         ← API 控制器
```

### 2.4 插件配置文件格式

**官方参考**：CSDN 第三方指南 https://blog.csdn.net/gitblog_00934/article/details/152009784

```json
{
    "base": {
        "name": "VR票务插件",
        "version": "1.0.0",
        "author": "sileya-ai",
        "desc": "VR演唱会票务插件"
    },
    "hook": {
        "plugins_view_goods_detail_base_sku_top": [
            "\\app\\plugins\\vr_ticket\\view\\Goods::PluginsViewGoodsDetailBaseSkuTop"
        ]
    }
}
```

---

## 三、uni-app 小程序开发

### 3.1 小程序打包教程

**官方文档**：https://doc.shopxo.net/article/1/293727233598554112.html

覆盖内容：
- HBuilderX 下载安装
- shopxo-uniapp 源码导入
- `App.vue` 接口地址配置（`request_url` / `static_url`）
- `manifest.json` 各端配置（AppID、权限等）
- **微信小程序发行步骤**
- 条件编译指令（`#ifdef MP-WEIXIN`）
- 主题配色修改

### 3.2 shopxo-uniapp 源码地址

| 平台 | 地址 |
|---|---|
| Gitee | https://gitee.com/zongzhige/shopxo-uniapp |
| GitHub | https://github.com/gongfuxiang/shopxo-uniapp |
| uni-app 插件市场 | https://ext.dcloud.net.cn/plugin?id=6380 |

### 3.3 HBuilderX 下载

官方地址：https://www.dcloud.io/hbuilderx.html
建议下载 **APP开发版**（已集成 uni-app 插件，开箱即用）

---

## 四、ThinkPHP 框架文档

ShopXO 基于 ThinkPHP 6/8 框架开发。

| 资源 | URL |
|---|---|
| ThinkPHP 6 文档 | https://www.kancloud.cn/manual/thinkphp6_0/ |
| ThinkPHP 8 文档 | https://www.kancloud.cn/manual/thinkphp8_0/ |
| 模板引擎 | https://www.kancloud.cn/manual/think-template/ |

---

## 五、API 接口文档

**官方文档**：https://doc.shopxo.net/?a=index&aid=300808037910708224&id=2&m=Article

ShopXO 提供完整的 RESTful API，覆盖：
- 公共接口（地区、文件上传）
- 用户接口（登录、注册、积分、消息）
- 商品接口（列表、详情、规格）
- 订单接口（下单、支付、退款）
- 优惠券接口

---

## 六、功能模块官方参考

### 6.1 门店系统（核销相关）

ShopXO 门店功能（含核销/派单/收银）：**功能清单** https://doc.shopxo.net/article/1/260684202096197632.html

> 描述：派单+转单+**核销**+代客下单+商品+批次+次卡+员工和薪水自动抽成+充值+收银+桌码+O2O店铺运营模式

### 6.2 会员钱包/积分

**功能清单**：https://doc.shopxo.net/article/1/260684202096197632.html

### 6.3 优惠券

**功能清单**：https://doc.shopxo.net/article/1/260684202096197632.html

---

## 七、我们的功能 → 官方文档映射表

| 我们要开发的功能 | 对应官方文档 | URL |
|---|---|---|
| 插件骨架创建 | 插件开发文档 / 目录结构 | https://doc.shopxo.net/article/3.html |
| 钩子注册（商品页/用户中心） | 插件开发文档 - 钩子响应 | https://doc.shopxo.net/article/3.html |
| 插件 Service 层（订单事件） | 插件开发文档 - 回调事件 | https://doc.shopxo.net/article/3.html |
| 插件内 URL 生成 | 插件开发文档 - URL生成 | https://doc.shopxo.net/article/3.html |
| 插件调试 | 插件开发文档 - 调试模式 | https://doc.shopxo.net/article/3.html |
| 微信小程序编译/发行 | uniapp版打包教程 | https://doc.shopxo.net/article/1/293727233598554112.html |
| uni-app 条件编译 | uniapp版打包教程 | https://doc.shopxo.net/article/1/293727233598554112.html |
| 微信小程序 AppID 配置 | uniapp版打包教程 | https://doc.shopxo.net/article/1/293727233598554112.html |
| 虚拟商品/订单模式 | 功能清单 | https://doc.shopxo.net/article/1/260684202096197632.html |
| QR 码生成 | 基础类 `\base\Qrcode` | 源码：shopxo-src/extend/base/Qrcode.php |
| ThinkPHP 模板语法 | 模板引擎方法及变量 | https://doc.shopxo.net/article/4.html |
| 系统安装/配置 | 系统安装教程 | https://doc.shopxo.net/article/1/260667307922030592.html |
| 插件升级兼容性 | 更新日志 | https://doc.shopxo.net/article/1/260687012997103616.html |

---

## 八、第三方参考（高质量）

| 资源 | URL | 说明 |
|---|---|---|
| ShopXO 插件开发完整指南 | https://blog.csdn.net/gitblog_00934/article/details/152009784 | 从零构建插件的完整技术路线 |
| ShopXO 二次开发汇总 | https://blog.csdn.net/qq_35393869/article/details/114523844 | 官方文档汇总，含 ThinkPHP/AmazeUI 参考 |
| ShopXO 开发实战 | https://zhuanlan.zhihu.com/p/363561060 | 二次开发笔记 |

---

## 九、官方社区

| 平台 | 地址 |
|---|---|
| 官方 QQ 群 | 833531593 / 641730223（答案：shopxo.net） |
| uniapp 官方群 | 679303149 |
| GitHub | https://github.com/gongfuxiang/shopxo |
| Gitee | https://gitee.com/zongzhige/shopxo |
| 应用商店 | https://store.shopxo.net/ |
