Appearance
配置数据
配置数据是系统的核心设置,存储于 system_config 集合,被前台、后台及插件统一读取。配置数据按「配置分类」组织,每条配置项定义如下:
| 字段 | 说明 |
|---|---|
menu_name | 配置变量名(英文唯一,用于代码中读取) |
type | 数据类型(见下文) |
input_type | 输入组件类型 |
config_tab_id | 所属配置分类 |
append / append_value | 父级联动:仅当父配置值命中时显示 |
parameter | 下拉 / 单选的可选参数(如 1=>男\n2=>女) |
upload_type | 上传类型(1 单图 / 2 多图 / 3 文件) |
value | 默认值 |
info | 配置名称(显示名) |
desc | 配置说明 |
sort | 排序值 |
status | 状态,1 启用,0 禁用 |
数据类型
配置项支持以下数据类型,对应不同的表单组件:
| 类型 | 输入组件 | 说明 |
|---|---|---|
textInput | 单行输入框 | 文本、数字、地址等 |
multiLineInput | 多行文本域 | 长文本、富文本代码 |
radioButton | 单选按钮 | 配合 parameter 使用 |
fileUpload | 文件上传 | 单图 / 多图 / 文件 |
checkbox | 多选框 | 多选配置 |
dropdown | 下拉选择 | 配合 parameter 使用 |
colorPicker | 颜色选择器 | 主题色等 |
slider | 滑块 | 数值区间 |
arrayTable | 数组表格 | 结构化多行数据(如权益列表) |
switch | 开关 | 布尔开关 |
useSelect | 选择器 | 关联选择 |
配置读取方式
前台与后台通过配置分类 eng_title 或配置变量名读取:
按分类读取(返回该分类下全部配置)
按变量名读取(返回单个配置值)保存配置后,系统会自动刷新配置缓存(Redis),前台立即生效,无需重启服务。
NOTE
配置变量名只允许字母、数字、下划线与 $ 开头,不能包含空格。命名后不建议修改,否则会影响代码读取。
相关接口
| 接口 | 方法 | 说明 |
|---|---|---|
/admin/config/index | GET | 配置数据列表 |
/admin/config/add | POST | 新增配置项 |
/admin/config/edit | GET | 配置项表单 |
/admin/config/update | POST | 编辑配置项 |
/admin/config/delete | POST | 删除配置项 |
/admin/config/drag_update | POST | 拖拽排序 |