区块管理
校对日期:2026-11-17。适用于社区版及全部商业版;在可视化构建器里给页面组件选择区块需要商业版高级版。
区块是页面上由人来挑选内容、排定顺序的位置,例如首页焦点图、推荐位、广告位。一个区块是一组区块项, 每个区块项有标题、图片、链接等内容,可以指向一篇文章,也可以与文章无关(一张活动海报加一个外部链接)。 模板和页面组件按区块的别名取出其中的区块项来显示。区块和区块项在同一个界面管理。
导入了演示数据的站点自带区块“首页焦点”(别名 focus),默认主题首页的焦点轮播显示的就是它。
一、界面
进入 内容 → 区块管理。
- 左侧 是区块,分 全局共享、本站私有 两组。每行右边的数字是本站在这个区块里的区块项数,停用的区块带 已停用 标记。 上方的搜索框按名称、别名、区块分类过滤;旁边的“+”是 新增区块;鼠标悬停在行上出现 编辑区块;拖动行首的图标调整同组内的顺序(搜索时不能拖动)。
- 右侧上方 是所选区块的信息:名称、别名(旁边的图标用于复制)、共享范围、区块分类、区块项模型、公开标题,以及 编辑区块、删除区块。
- 右侧下方 是本站在这个区块里的区块项,可以按标题、ID 查询。新增、删除 操作区块项;新窗口打开、启用 两列的开关可以直接拨动; 双击行打开编辑。副标题、手机图片等列默认隐藏,在 列设置 里打开。
二、新增与编辑区块
点左侧的“+”,填写:
| 字段 | 说明 |
|---|---|
| 名称 | 后台显示的名称 |
| 别名 | 模板、接口和页面组件按别名取区块。只能用汉字、英文字母、数字、下划线、中划线;本站私有的区块之间、全局共享的区块之间各自不能重复 |
| 共享范围 | 本站私有:只属于本站;全局共享:所有站点都能用,见“全局共享的区块”一节 |
| 区块分类 | 选填,可选已有的分类,也可以新填。模板可以按分类一次取出一组区块 |
| 区块项模型 | 选填,决定区块项编辑页有哪些字段,见“区块项模型”一节 |
| 公开标题、更多链接 | 选填,供模板显示区块的标题栏和“更多”链接。更多链接必须以 http 或 / 开头 |
| 是否启用 | 关闭后不能再往这个区块里新增区块项,它也不出现在文章的“推荐到”菜单里。已有的区块项在前台照常显示 |
| 是否可推荐 | 开启后,区块出现在文章管理行尾“…”的 推荐到 里,以及文章查询条件 区块 的下拉里 |
修改别名后,模板和接口里按旧别名取的地方要同步修改。
三、添加区块项
有两种办法:
- 在区块管理里新增:选中区块,点 新增,直接填写标题、图片和链接。
- 从文章推荐:在 内容 → 文章管理 点文章行尾“…”里的 推荐到:区块名称,打开同一个区块项表单,标题已按文章填好; 文章有标题图或图片集时,图片 旁的 从正文提取图片 可以从中挑一张。保存后文章标题后面出现区块名称的标签(标签变灰表示这个区块项已停用), 点标签上的“×”从区块移除,移除前会确认。同一篇文章在一个区块里只能有一个区块项,已经推荐过的区块在菜单里是灰的。
区块项的字段:
| 字段 | 说明 |
|---|---|
| 标题 | 必填 |
| URL链接 | 点击后去哪里,必须以 http 或 / 开头。由文章推荐来的区块项没有这一项,链接始终是文章的地址 |
| 图片 | 默认建议尺寸 1200×600,上传后可以裁剪 |
| 新窗口打开 | 模板输出链接时加上 target="_blank" |
| 发布开始时间、发布结束时间 | 定时上下线:前台只显示处在这段时间内的区块项,留空表示不限。后台列表始终列出全部 |
| 是否启用 | 关闭后前台不显示,可以用来临时撤下 |
| 副标题、描述、手机图片、视频 | 默认不显示,需要时在区块项模型里打开 |
编辑由文章推荐来的区块项时,表单上方显示 原文章ID、原文章标题。区块项的标题、图片是自己保存的一份,之后修改文章不会改动它们。 区块项属于哪个区块在新增时就定了,不能改到别的区块。
排序:拖动行首的图标调整顺序,前台按这个顺序显示;新增的区块项排在最后。点列标题按某列排序后不能拖动,点 重置 恢复。
前台只显示 是否启用 开启、处在发布时间内的区块项;由文章推荐来的,访问者还须能浏览文章所在的栏目(见栏目浏览权限)。
四、区块项模型
区块项默认只有上表的字段。轮播图要一行按钮文字、广告位要一个背景色时,用区块项模型给区块加字段:
- 进入 配置 → 模型管理,切到 区块项模型 页签,新增一个模型。
- 点行上的 系统字段,打开需要的副标题、描述、手机图片、视频,或者改字段的显示名称、是否必填、图片尺寸。标题不能关闭。
- 点 自定义字段,添加区块需要的其它字段。
- 回到区块管理,编辑区块,在 区块项模型 里选这个模型。
之后这个区块的区块项表单按模型显示字段,模板里用 item. 读取自定义字段。全局共享的区块只能选全局共享的模型。 正被区块使用的模型不能删除。模型的详细用法见模型管理。
五、全局共享的区块
全局共享的区块所有站点都能看到和使用,适合多站点(标准版)里结构相同、内容各异的位置,比如每个站点首页都有的焦点图。
- 区块项仍然分属各站点:每个站点在同一个全局区块下维护自己的区块项。左侧的数字、右侧的列表和前台取到的,都只是本站的区块项。
- 新增、修改、删除、排序全局共享的区块,需要角色开启“全局数据”(见多站点的“全局数据”一节)。 没有这项权限时,全局区块带 只读:修改全局区块需要全局数据权限 标记,区块本身只能查看;它下面本站的区块项照常增删改。
- 把全局共享改回本站私有时,如果其它站点在这个区块里还有区块项,会提示“数据已被其它站点使用,不允许设置为本站私有”。
六、删除
- 删除区块 会连同它的区块项一起删除,确认框里写明数量。全局共享的区块在其它站点还有区块项时不能删除,按钮置灰, 悬停提示“其它站点仍有该区块的区块项,不可删除”:先到那些站点清空这个区块。
- 页面组件里选了这个区块的面板,区块删除后按未设置处理。
- 彻底删除文章时,推荐它的区块项一并删除;删除栏目时,栏目里文章的区块项一并删除。文章只是下线或放进回收站时,区块项保留。
七、权限
在 用户 → 角色管理 的权限树里:
| 权限 | 能做什么 |
|---|---|
| 区块管理 → 列表 | 进入区块管理,查看区块和区块项 |
| 区块管理 → 新增 / 编辑 / 删除 | 新增、修改、删除区块项;拖动排序和列表里的开关属于“编辑” |
| 区块管理 → 新增区块 / 编辑区块 / 删除区块 | 新增、修改、删除区块;拖动区块排序属于“编辑区块” |
| 文章管理 → 推荐到 | 在文章管理里把文章推荐到区块,点标签上的“×”移除 |
全局共享的区块另需“全局数据”,见“全局共享的区块”一节。
八、在模板和页面里使用
模板里用 BlockItemList 指令按别名取区块项:
[#escape x as (x)!?html]
[@BlockItemList block='focus' limit='5'; items]
[#list items as item]
<a href="${item.url}"[#if item.targetBlank] target="_blank"[/#if]>
[#if item.image?has_content]<img src="${item.image}" alt="${item.title}">[/#if]
<span>${item.title}</span>
</a>
[/#list]
[/@BlockItemList]
[/#escape]block是区块的别名,也可以用blockId按 ID 取。默认只取本站的、启用的、处在发布时间内的区块项,顺序与区块管理里一致。item.url在关联了文章时是文章的地址,否则是 URL链接。其它常用属性:subtitle、description、mobileImage、video、article、customs。BlockList指令按category(区块分类)取一组区块,包括本站私有和全局共享的;区块上的title、moreUrl就是公开标题和更多链接。- 对应的公开接口:
GET /(只返回启用的区块项)、api/ block-item?block=别名 GET /。api/ block?category=分类 limit、offset等参数见模板标签与 API 的通用参数,指令的一般写法见模板编写。 - 页面组件可以声明
blockRef类型的设置项,在可视化构建器(高级版)里给面板选一个区块,面板就显示它的区块项,例如默认主题的“焦点轮播”。 什么内容适合放进区块,见页面组件与内容编排的“内容放在哪里”一节。 - 主题的演示数据可以带区块,面板设置里用
{{block:别名}}引用,见组件、区域与演示数据的“内容种子”一节。
九、常见问题
新增按钮是灰的。 区块已停用(左侧带“已停用”),或者当前账号没有区块项的“新增”权限。
文章的“推荐到”菜单里没有某个区块。 区块没有开启 是否可推荐,或者已经停用。菜单项是灰的:这篇文章已经在这个区块里,或者没有推荐权限。
停用了区块,前台还在显示。 区块的 是否启用 只管后台能否继续添加区块项(包括从文章推荐)。要从前台撤下,关闭区块项的 启用,或者设置 发布结束时间。
区块里的文章点进去是 404。 文章下线或放进回收站后,推荐它的区块项不会自动撤下,访客打开未公开的文章得到 404。 关闭这个区块项,或者在文章管理里点区块标签上的“×”移除。
改了文章标题,区块里还是旧标题。 区块项的标题、图片是推荐时复制过来的,到区块管理里编辑区块项。链接始终跟随文章。
修改了区块项,前台没有变化。 先检查区块项是否启用、是否处在发布时间内,关联的文章所在栏目访问者能否浏览。 开启了页面静态化时,修改区块不会触发生成,到了发布开始、结束时间也不会,需要到 系统 → 生成管理 手动生成 (见页面静态化的“自动生成与手动生成”一节)。
删除区块的按钮是灰的。 当前账号没有“删除区块”权限;或者这是全局共享的区块,而账号没有“全局数据”权限,或其它站点还有它的区块项。
保存区块提示“别名已存在”。 同一共享范围里已经有这个别名,换一个。
保存区块提示“全局区块只能绑定全局共享的区块项模型”。 改选全局共享的区块项模型,或者把区块改回本站私有。