文档说明
看店通支持插件化扩展,开发者可基于插件机制开发自定义功能模块,在不修改核心代码的前提下扩展商城能力。插件化架构的优势在于:隔离性强、易于维护、支持热插拔、便于版本升级。本文档为插件开发概览。
一、插件架构
看店通采用事件驱动的插件架构,核心系统在关键流程节点触发钩子事件,插件通过监听这些事件实现功能扩展。这种设计保证了核心代码的稳定性,同时为开发者提供了充足的扩展空间。
- 插件目录:plugins/ 目录下每个子目录为一个插件,目录名即插件标识
- 插件配置:manifest.json 定义插件名称、版本、作者、依赖、钩子等元信息
- 生命周期:安装、启用、禁用、卸载,每个阶段有对应回调
- 钩子机制:订单创建、支付成功、用户注册等数十个钩子点
二、常用钩子示例
订单相关:order.create.before、order.create.after、order.pay.after、order.refund.after;用户相关:user.register.after、user.login.after;商品相关:goods.create.after、goods.update.after。钩子可修改传入参数或执行额外逻辑,需注意不要阻塞主流程。
三、开发流程
- 创建插件目录结构,按规范命名
- 编写 manifest.json 配置,声明插件信息与钩子
- 实现插件主类,继承基类并实现钩子方法
- 本地测试与调试,可在后台插件管理中启用
- 打包发布,生成可安装的插件包
四、插件目录结构
标准插件目录包含:Plugin.php(主类)、manifest.json(配置)、config.json(可选配置项)、views/(后台视图)、assets/(静态资源)。插件可独立使用数据库表,建议表名加插件前缀避免冲突。
五、开发注意事项
插件开发需遵循命名规范,避免与核心类冲突。数据库操作建议使用框架提供的ORM,确保事务一致性。涉及支付、金额等敏感逻辑时,务必做好异常处理和日志记录。插件发布前建议进行充分测试,包括与核心功能的兼容性。
六、插件市场
看店通提供插件市场,开发者可将插件上架供其他商户使用,获得收益分成。上架插件需通过审核,确保功能正常、无安全风险。热门插件类型包括:ERP对接、CRM集成、营销工具、数据分析等。