以demo插件名称为例,以下包含常见的插件目录与文件,根据您的插件需要自行新建、删除目录
addons文件夹 ├─demo 插件名称标识 │ ├─controller 插件控制器 │ ├─model 插件模型 │ ├─view 插件视图 │ ├─middleware 插件中间件 │ ├─validate 插件验证器 │ ├─lang 插件语言包,仅用于插件内的访问 │ ├─taglib 标签库 │ ├─install 安装目录,与app、template、static、public目录保持一致,具体看后面的章节 │ ├─Demo.php 与插件名称保持一致,其中首字母大写(该文件必须存在) │ ├─config.php 配置文件 │ ├─common.php 插件函数库(插件内使用)│ ├─route.php 插件路由 │ ├─service.ini 插件服务注册 │ ├─install.sql 插件安装时自动导入数据库 │ ├─upgrade.sql 插件升级时自动执行改SQL文件 │ ├─demodata.sql 安装时用户勾选导入演示数据时自动导入 │ ├─info.ini 插件信息(该文件必须存在)
其中info.ini
文件与Demo.php
文件必须存在,其中Demo.php
文件名称取决于你的插件名称,主要用于安装、卸载、禁用、启用、处理事件逻辑。
插件名称标识
命名规则:小写字母,支持字母数字结合,建议使用字母
例如你的插件名称叫name
,那么目录结构如下
addons文件夹 ├─name │ ├─Name.php 首字母大写 │ ├─info.ini 插件信息
注意:为防止插件名称与其他插件名称重名,可在HkCms后台应用中心安装“自动生成应用插件”插件来创建插件,如果你是手动创建可前往:插件名称检测