应用配置
更新时间:2023-05-25 12:32
为了方便给用户一个统一便捷的应用配置入口,我们建议您用此方式设置您的应用后台,您只需书写此文件即可
/www/[app]/[ver]/conf/setting.yaml
节点定义
yaml 格式的节点定义及含义如下:
[页面ID]:
name: [页面名称]
items:
name:
name: 设置项名称
desc: 设置项说明
type: [类型]
default: 默认值
placeholder: 提示文字
selects: 选项
值: 文字
类型目前包含如下内容:
类型 | 含义 |
---|---|
text | 单行文本框 |
textarea | 多行文本框 |
radio | 单选 |
checkbox | 多选 |
select | 下拉单选 |
multipleSelect | 下拉多选 |
number | 数字文本框 |
datetime-local | 日期时间文本框 |
date | 日期文本框 |
time | 时间文本框 |
month | 月份文本框 |
color | 颜色文本框 |
image | 图片上传(单图) |
备注
image 类型设置项,上传图片后,存储的是图片的 key 值,可以使用 Lib\Cos::ImageUrl 接口获取图片类资源的 URL。
自定义配置入口
您可以自己做一个配置入口,通过下面的定义跳转到相应的 controller 和 action 中
[页面ID]:
name: [页面名称]
controller: controller
action: action
为了安全,我们提供了相应的后台入口校验接口,详情请查看“应用配置入口校验”接口
完整的范例
base:
name: 基本设置
items:
name:
name: 姓名
desc: 请输入姓名
type: text
default: ''
placeholder: 唐三
sex:
name: 性别
desc: 请输入性别
type: radio
selects:
0: 未知
1: 男
2: 女
default: 2
equip:
name: 初始装备
desc: 请选择初始装备
type: checkbox
selects:
1: 皮靴
2: 木剑
3: 背心
4: 皮裤
default: 2|3
city:
name: 出生地
desc: 请选择出生地
type: select
selects:
0: "- 请选择 -"
1: 花园村
2: 大圣村
3: 土豆岭
4: 海神岛
default: 4
task:
name: 初始任务
desc: 请选择初始任务
type: multipleSelect
selects:
1: 杀死10只土豆怪
2: 帮村民老王寻找鞋子
3: 抓到偷盗村民财务的小偷
4: 升级到 5 级
default: 2|3
logo:
name: Logo图片
desc: 请上传Logo图片
type: image
placeholder: 请上传Logo图片
adv:
name: 高级设置
items:
text:
name: 说明文本
desc: 说明内容
type: textarea
placeholder: 唐三
age:
name: 年龄
desc: 请输入年龄
type: number
default: ''
placeholder: 10
dateTime:
name: 日期时间
desc: 请输入日期和时间
type: datetime-local
default: ''
date:
name: 日期
desc: 请输入日期
type: date
default: ''
time:
name: 时间
desc: 请输入时间
type: time
default: ''
month:
name: 月份
desc: 请输入月份
type: month
default: ''
color:
name: 颜色
desc: 请输入颜色
type: color
default: ''
myadmin:
name: 自定义设置
controller: Admin
action: index
应用配置可用 Lib\Site::GetSetting() 接口获取设置的内容