本页适用于通过公开插件、主题、驱动和业务 API 扩展可得财务的开发者。正式部署不需要修改或重新构建核心程序。
开发前
接口与配置
- 使用公开业务接口及钩子,不直接修改系统内部数据结构。
- 检查 HTTP 状态与响应体业务状态,不能把返回 HTML 的接口当成成功。
- 后台路径由宿主提供或按当前站点配置获取,不硬编码
/admin/。 - 管理员与客户令牌分开使用,不把后台令牌发送给第三方页面。
- 插件配置使用插件提供的配置能力,敏感字段使用密码输入并避免回显。
主题与资源
主题样式应限制在自身作用域内,避免影响后台、其他主题或第三方验证码组件。导航使用当前站点真实路径,支持手机菜单、直接访问和刷新。
不要在主题中保留旧版页面壳,也不要把登录、会员中心或商品页链接重新指向旧 Hash 入口。页面署名保留在正常文档流的页脚中。
数据与错误处理
业务数据使用参数化查询或受支持的服务接口处理。用户输入、富文本和上传文件均需校验;不能将脚本放到可公开上传并执行的位置。
错误信息应方便用户理解,详细诊断只在受权限保护的日志中记录。不要把请求头、密码、完整令牌或客户隐私写入公开错误信息。
交付前检查
- 安装、启用、停用、升级及卸载行为符合扩展说明。
- 自定义后台路径下,菜单、接口及资源正常。
- 桌面与手机的首页、商品、登录注册及会员中心无样式冲突。
- 登录过期、权限不足、外部服务超时等情况有明确提示。
- 不同系统版本下失败能正确提示,不会破坏已有数据。
- 提供扩展的操作说明、版本变化和恢复办法。
扩展可单独打包交付;业务系统升级请使用官方更新流程。