本页适用于通过公开插件、主题、驱动和业务 API 扩展可得财务的开发者。正式部署不需要修改或重新构建核心程序。

开发前

  1. 阅读对应插件、主题或开通模块教程。
  2. 使用独立测试站和测试账号,准备数据库与文件备份。
  3. 声明扩展版本、适配的系统版本、需要的权限及依赖。
  4. 使用示例数据,不在代码、截图或提交记录中放入真实凭据。

接口与配置

  • 使用公开业务接口及钩子,不直接修改系统内部数据结构。
  • 检查 HTTP 状态与响应体业务状态,不能把返回 HTML 的接口当成成功。
  • 后台路径由宿主提供或按当前站点配置获取,不硬编码 /admin/。
  • 管理员与客户令牌分开使用,不把后台令牌发送给第三方页面。
  • 插件配置使用插件提供的配置能力,敏感字段使用密码输入并避免回显。

主题与资源

主题样式应限制在自身作用域内,避免影响后台、其他主题或第三方验证码组件。导航使用当前站点真实路径,支持手机菜单、直接访问和刷新。

不要在主题中保留旧版页面壳,也不要把登录、会员中心或商品页链接重新指向旧 Hash 入口。页面署名保留在正常文档流的页脚中。

数据与错误处理

业务数据使用参数化查询或受支持的服务接口处理。用户输入、富文本和上传文件均需校验;不能将脚本放到可公开上传并执行的位置。

错误信息应方便用户理解,详细诊断只在受权限保护的日志中记录。不要把请求头、密码、完整令牌或客户隐私写入公开错误信息。

交付前检查

  • 安装、启用、停用、升级及卸载行为符合扩展说明。
  • 自定义后台路径下,菜单、接口及资源正常。
  • 桌面与手机的首页、商品、登录注册及会员中心无样式冲突。
  • 登录过期、权限不足、外部服务超时等情况有明确提示。
  • 不同系统版本下失败能正确提示,不会破坏已有数据。
  • 提供扩展的操作说明、版本变化和恢复办法。

扩展可单独打包交付;业务系统升级请使用官方更新流程。

下载文档
原始 Markdown 文件