公开扩展包括插件、主题和服务开通模块。选择合适的扩展方式,可减少升级时覆盖自定义内容的风险。
选择扩展方式
| 目标 | 扩展方式 | 文档 |
|---|---|---|
| 增加业务功能或订阅事件 | 功能插件 addon |
插件教程 · 钩子 |
| 对接支付、短信、邮件或实名 | 对应类型驱动插件 | 支付 · 实名 · 通知 |
| 修改前台外观和区块内容 | 主题及主题配置 | 主题管理 |
| 对接主机、面板或上游服务 | 开通模块 | 开通模块 |
| 外部业务读取商品或处理订单 | 公开业务 API | API · 商品接口 |
目录约定
| 内容 | 目录 |
|---|---|
| 功能插件 | public/plugins/addon/<name>/ |
| 支付插件 | public/plugins/gateway/<name>/ |
| 短信、邮件、实名插件 | `public/plugins/{sms |
| 官网主题 | public/themes/web/<name>/ |
| 会员中心主题 | public/themes/clientarea/<name>/ |
| 购物车主题 | public/themes/cart/<name>/ |
| 开通模块 | extend/modules/<Name>/ |
安装扫描不等于兼容所有第三方实现。魔方格式插件还需要满足其依赖、接口及当前版本支持的功能范围,应先在测试环境验证。
请求与权限
- 前台页面地址与业务 API 地址用途不同,不应把 API 改写成 HTML 页面。
- 管理接口必须使用管理员登录态和对应权限;客户接口使用客户登录态。
- 文档中的
/admin/是示例前缀;自定义后台路径后,应使用站点当前配置的前缀。 - 插件菜单、请求、回调和静态资源不能硬编码某个实际部署的后台地址。
不要通过修改核心程序、直接写内部业务表或依赖未公开接口实现扩展。配置变化请使用支持的配置接口,以便刷新缓存和同步前台。
下一篇:扩展开发规范