公开扩展包括插件、主题和服务开通模块。选择合适的扩展方式,可减少升级时覆盖自定义内容的风险。

选择扩展方式

目标 扩展方式 文档
增加业务功能或订阅事件 功能插件 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/ 是示例前缀;自定义后台路径后,应使用站点当前配置的前缀。
  • 插件菜单、请求、回调和静态资源不能硬编码某个实际部署的后台地址。

不要通过修改核心程序、直接写内部业务表或依赖未公开接口实现扩展。配置变化请使用支持的配置接口,以便刷新缓存和同步前台。

下一篇:扩展开发规范

下载文档
原始 Markdown 文件