块集数据

块集（Block）用于将一组结构化数据集中管理，并在前台指定位置渲染。典型应用场景：

• 首页轮播图、广告位
• 友情链接、推荐位
• 自定义数据列表（如榜单、专题）

块集由「块集定义」与「块集数据」两部分组成：

• 块集定义：声明块集的名称、字段结构（存储于 aod_block）。
• 块集数据：某一块集下的实际数据条目（存储于 aod_block_data，通过 bid 关联块集）。

创建块集

在后台「块集数据 → 新增」中填写：

字段	说明
name	块集名称
config_name	配置标识（唯一），前台据此读取块集
info	块集描述
fields	字段结构定义（数组），决定数据条目的录入表单

字段结构

fields 数组中的每个元素定义一个录入字段，支持多种表单组件（输入框、单选、下拉、图片、标签等）。字段结构示例：

[
  { "label": "标题", "name": "title", "type": "input" },
  { "label": "图片", "name": "image", "type": "frame" },
  { "label": "链接", "name": "link", "type": "input" }
]

创建块集后，系统会根据 fields 自动生成数据录入表单。

数据管理

进入某一块集后，可对其数据条目进行增删改与排序：

字段	说明
bid	所属块集 ID
value	数据内容（对象，结构与 fields 对应）
sort	排序值，越小越靠前
status	状态，1 显示，0 隐藏

支持批量删除与拖拽排序，列表默认按 sort 升序、createtime 倒序展示。

前台渲染

前台模板根据块集 config_name 读取数据，并渲染对应位置。

• 块集查询会附带其下所有数据条目（通过关联查询）。
• 数据条目按状态与排序筛选后输出到模板变量。

NOTE

块集适合存放无需建模的轻量结构化数据。若数据需要复杂检索与关联，建议使用「自定义页面」或独立模型。

相关接口

接口	方法	说明
/admin/block/index	GET	块集列表
/admin/block/create	POST	新增块集
/admin/block/update	POST	编辑块集
/admin/block/delete	POST	删除块集
/admin/block/data_list	GET	块集数据列表
/admin/block/data_create	POST	新增块集数据
/admin/block/data_update	POST	编辑块集数据
/admin/block/data_delete	POST	删除块集数据