每个插件里面都会自动生成一个插件信息文件(info.php),你可以直接修改配置文件或者使用开发助手进行可视化配置。
## 方式一:可视化配置(推荐)
![](https://box.kancloud.cn/0ac15495e9a83a77c0b3381490fcd870_2094x966.png)
![](https://box.kancloud.cn/a3098f591ea47b35174ddf348f130a39_1962x1400.png)
![](https://box.kancloud.cn/01e73a38d2c0329e2b41b4eee3088c8a_2806x1030.png)
>[info] 如何调用插件配置呢?
格式:{:config('plugins_插件名.配置名')}
实例:{:config('plugins_login.app_id')}
## 方式二:手动配置
插件信息配置文件(info.php)返回的是一个数组,数据结构如下:
| 参数名 | 含义 | 数据类型 | 必填项 |
| --- | --- | --- | --- |
| name | 插件名 | string | 是 |
| title | 插件标题 | string | 是 |
| identifier | 插件唯一标识 | string | 是 |
| icon | 插件图标 | string | 是 |
| intro | 插件简介 | string | 否 |
| author | 插件作者 | string | 否 |
| author_url | 作者URL | string | 否 |
| version | 插件版本号 | string | 是 |
| db_prefix | 插件表前缀 | string | 是 |
| config | 插件配置 | array | 否 |
插件参数详解如下:
## [name] 插件名
可使用字母(小写)、数字、下划线组成,建议尽量不要使用数字和下划线。
例:login
## [title] 插件标题
该标题会在后台左侧的导航插件列表下面显示。
例:第三方登录插件
## [identifier] 插件唯一标识
区分不同开发者不同插件的唯一标识,格式:插件名.开发者标识(只能为字母、数字、下划线).plugins,如果您的插件有上云的话,插件标识由云端自动生成。后续会详细说明。
例:login.hisiphp.plugins
## [icon] 模块图标
插件图标,主要用于后台插件管理展示,图标尺寸要求200px * 200px,格式为PNG
## [intro] 模块简介
对插件进行简单的描述,以便使用者能快速的了解该插件的功能信息。
## [author] 模块作者
指插件开发者的名称(姓名或昵称均可)
## [author_url] 作者URL
开发者的网站地址,必须是完整的网站链接地址。
例:http://www.hisiphp.com
## [version] 模块版本号
>[info] 格式 1.0.0
插件版本号一定要按照要求填写,插件升级的时候,将以此版本号做为对比。
版本号格式采用三段式:主版本号.次版本号.修订版本号。例:1.0.0
主版本号【位数变化:1-99】:当插件出现大更新或者很大的改动,比如整体架构发生变化。此版本号会变化。
次版本号【位数变化:0-999】:当插件功能有新增或删除,此版本号会变化,如果仅仅是补充原有功能时,此版本号不变化。
修订版本号【位数变化:0-999】:一般是 Bug 修复或是一些小的变动,功能上没有大的变化,修复一个严重的bug即发布一个修订版。
## [db_prefix] 表前缀
例如:数据表名”hisiphp_login_oauth“,我们将他拆解为3段来理解:”hisiphp_“为表前缀,”login“为插件名,”oauth“为具体的数据表名。拆解后的”hisiphp_“就是我们要得到表前缀。
填写了表前缀后,系统在安装当前插件时,会自动将此表前缀替换成当前系统所设置的表前缀。
>[danger] 特别提醒:表前缀必须要跟插件目录下面的sql/install.sql文件里面的表前缀一样。
## [config] 插件配置
针对当前模块需要一些自定义配置的话,则需要填写此参数。
>[info]格式:['sort' => '排序','title' => '标题','name' => '名称','type' => '类型','options' => '选项','value' => '默认值', 'tips' => '提示']
各参数设置实例可参考:管理后台->系统->系统功能->配置管理->添加
| 参数 | 含义 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| sort | 排序 | int | 是 | 无 |
| title | 标题 | string | 是 | 2-12个字符 |
| name | 字段名称 | string | 是 | 可由字母、数字、下划线组成 |
| type | 表单类型 | string | 是 | 下文单独介绍 |
| options | 表单选项 | string | 否 | 下文单独介绍 |
| value | 默认值 | string/int | 否 | 下文单独介绍 |
| tips | 提示 | string | 否 | 关于此配置的提示信息或使用说明,支持HTML标签 |
>[info]参数名:type,此参数可选值如下:
input,textarea,array,switch,radio,checkbox
select,hidden,image,file,date,datetime,time
>[info]参数名:options,此参数仅适用于表单类型[type]为单选按钮(radio)、多选按钮(checkbox)、下拉框(select)、开关(switch),具体使用方式如下:
~~~
[radio]单选按钮参考格式:
0:男票
1:女票
~~~
~~~
[checkbox]多选按钮参考格式:
1:唱歌
2:跳舞
3:旅游
4:文学
~~~
~~~
[select]下拉框参考格式:
1:北京
2:上海
3:广州
4:深圳
~~~
~~~
[switch]开关参考格式:
0:关闭
1:开启
~~~
>[info]参数名:value,表单默认值。
配置类型为单选按钮(radio)、多选按钮(checkbox)、下拉框(select)、开关(switch)时请按如下格式填写,其他类型直接填写字符串即可。
键值:键名
插件配置示例代码如下:
~~~
'config' => [
[
'sort' => '100',
'title' => 'AppID',
'name' => 'app_id',
'type' => 'input',
'options' => '',
'value' => '',
'tips' => '开放平台APP ID',
], [
'sort' => '101',
'title' => 'AppSecret',
'name' => 'app_secret',
'type' => 'input',
'options' => '',
'value' => '',
'tips' => '开放平台APP Secret',
],
],
~~~
配置后的效果如下:
![](https://box.kancloud.cn/232683e1090fcd0d7a6af06443bcbf8c_1638x638.png)
>[info] 如何调用插件配置呢?
格式:{:config('plugins_插件名.配置名')}
实例:{:config('plugins_login.app_id')}
- 序言
- 环境配置
- 下载及安装
- 目录结构
- 系统配置
- 多语言
- 命令行(pro版)
- 自动生成模块或插件(build)
- 生成模块
- 生成插件
- 自动生成增删改查(crud)
- 第一步:创建数据表
- 第二步:使用crud指令生成
- 自动生成类库文件(make)
- 生成控制器文件(make:controller)
- 生成模型文件(make:model)
- 生成逻辑文件(make:logic)
- 生成服务文件(make:service)
- 生成验证器文件(make:validate)
- 构建器(pro版)
- 表单构建器(form)
- 表单属性设置
- 添加表单项
- 文本框(text)
- 隐藏域(hidden)
- 密码框(password)
- 文本域(textarea)
- 单文件(file)
- 多文件(files)
- 单图(image)
- 多图(images)
- 开关(switch)
- 单选(radio)
- 多选(checkbox)
- 下拉框(select)
- 标签(tag)
- 日期时间(datetime)
- 颜色选择器(color)
- 富文本编辑器(editor)
- 滑块(slider)
- 评分(rate)
- 穿梭框(transfer)
- 进度条(progress)
- 树形(tree)
- 联动(linkage)
- 自定义html(html)
- 分隔线(line)
- 文字(txt)
- 下拉框增强版(select+)
- 数据表格(table)
- 添加表单分组(group)
- 栅格布局(grid)
- 触发器(trigger)
- 通用上传方法
- 表格构建器(table)
- 表格基础配置
- 添加表头工具栏
- 添加表格筛选
- 页面提示(pageTips)
- 引入 JS 文件
- 引入 CSS 文件
- 渲染额外 JS 代码
- 渲染额外 CSS 代码
- 模块开发
- 1.生成模块
- 2.创建菜单
- 3.创建控制器
- 后台通用方法
- 插件开发
- 1.新建插件
- 2.插件配置
- 3.插件控制器
- 4.插件模板
- 5.插件钩子
- 模板替换变量
- 公共函数库
- 后台通用JS方法
- 常见问题
- 官方模块
- CMS内容管理模块
- 目录结构
- 模板标签
- API接口
- 栏目页/内容页
- 小程序发布
- 官方插件
- 第三方登录
- excel插件
- 万能采集
- 采集规则
- 采集内容