专题管理
标准版及以上商业版功能
校对日期:2026-11-17。需要商业版标准版及以上。社区版、基础版没有专题功能,前台的专题地址返回 404。
专题把分散在各个栏目里的文章集中到一个页面上展示,比如“编辑精选”。专题自成一棵树,可以有下级专题; 一篇文章可以同时属于多个专题,一个专题也可以有多篇文章,文章仍然留在原来的栏目里。每个专题有自己的前台页面 /topic/{别名},全部专题的列表页是 /topic。
一、界面
进入 内容 → 专题管理。
- 左侧 是本站的专题树,上方可按名称搜索。点 根专题 列出一级专题;点一个专题,右侧列出它本身和它的直接下级。
- 子专题 页签:按标题、别名、ID 查询(有查询条件时连各级下级专题一起查);工具栏有 新增专题、删除、整理树形结构; 行上有 新增子专题、编辑、删除,双击行也能编辑。列表里的标题是链接,点开在新窗口打开该专题的前台页面。
- 文章 页签:所选专题关联的文章,见“给专题添加文章”一节。没有选中专题时只显示 “请从左侧选择专题以查看文章列表”。
二、新增和编辑专题
点 新增专题 或某一行的 新增子专题。左侧选中了某个专题时,新增专题 也建在它下面。新专题的专题模型、专题模板和 倒序排序默认沿用上级专题。编辑页左边是内容,右边 设置 卡片是专题的属性:
| 字段 | 说明 |
|---|---|
| 标题 | 必填,最长 150 字 |
| 别名 | 前台地址 /topic/{别名} 里的那一段。只能由英文字母、数字、下划线、中划线组成,最长 50 个字符,本站内不能重复。留空则自动生成,见下文 |
| SEO标题、SEO关键词、SEO描述 | 供模板使用。默认主题把 SEO关键词、SEO描述 写进页面的 keywords、description,并把 SEO描述 当作简介,显示在专题页标题下和专题列表的卡片上;页面标题用的是专题的标题 |
| 标题图 | 默认主题用作专题页顶部的横幅和专题列表的卡片图 |
| 自定义字段 | 专题模型里定义的字段,模板里用 topic. 读取 |
| 正文 | 默认不显示,需要时在专题模型的系统字段里打开,见模型管理的“系统字段”一节 |
| 上级专题 | 只在新增时可选。已有的专题要换上级,在左侧树里拖动 |
| 专题模型 | 必填,决定编辑页有哪些系统字段和自定义字段。可选本站和全局共享的专题模型(配置 → 模型管理 的 专题模型 页签) |
| 专题模板 | 前台专题页用哪个模板。主题默认 即 topic.html;其余选项是当前主题 templates/ 下以 topic 开头的模板,主题为专题声明了布局变体时显示变体名称 |
| 分页条数 | 前台专题页每页显示几篇文章,1–200,默认 20 |
| 倒序排序 | 默认打开,供模板读取(topic.orderDesc)。专题页的文章顺序由 文章 页签里的排列决定,ArticleTopicList 指令不看这个开关 |
别名的自动生成:标题输入框失去焦点而别名是空的,系统按标题填上一个建议值;没有建议值时,保存后由服务端生成。规则是取标题里的 英文字母和数字;标题里没有这些字符时,站点开启了 站点设置 → 固定链接 的 中文标题转拼音 就转成拼音,否则用专题 ID (一长串数字)。与本站已有的别名重复时自动加 -2、-3。生成后不随标题改动,清空别名再保存会重新生成。 纯中文标题的专题,建议手工填一个有意义的英文别名。
换主题后,新主题里没有已选的专题模板时,专题页按 topic 模板显示;所选的值不会被改掉,换回原主题即恢复。
三、给专题添加文章
在专题管理里
- 在左侧选中专题,切到 文章 页签。
- 点 新增,在 选择文章 对话框里按关键词(标题 或 标题+正文)、栏目、发布日期查找,点 添加。 这里只列出已发布的文章,已经在专题里的显示 已选。可以连续添加多篇,选完点 关闭。
- 拖动行首的图标排列先后,这就是前台专题页上的文章顺序。删除 只把文章移出专题,文章本身不受影响。
- 点 保存。保存之前的改动只在页面上;在左侧换选其它专题会直接重新载入,没保存的改动随之丢失。
列表里的 状态 是文章当前的状态。后来下线或放进回收站的文章仍留在专题里,只是前台不显示,重新发布后自动回来; 彻底删除的文章随之移出专题。
在文章编辑页
文章编辑页的 专题 字段列出本站的专题树,可以多选,选上级专题不会连带选中下级。内容 → 文章管理 的查询条件里也有 专题,查出直接关联到所选专题的文章。这个字段可以在文章模型的系统字段里隐藏或设为必填。
在文章编辑页保存时,系统只处理 专题 字段里增减的专题:文章在原有专题里排好的位置保持不变;新选上的专题,文章排到该专题的末尾, 与在专题管理里 新增 一样;取消选择的专题,文章随之移出。
四、排序、整理与删除
- 专题的顺序:在左侧树里拖动,可以调整先后,也可以拖到别的专题下面;在右侧列表里拖动 操作 列左边的图标, 调整同级专题的先后(有下级专题的行、点过列头排序时不能拖)。这个顺序也是前台专题列表的默认顺序。
- 整理树形结构:手工修改数据库或导入数据后,专题树的内部结构可能错乱,这时用它修复。
- 删除:删除一个专题,会连同它的各级下级专题一起删除,并解除它们与文章的关联,文章本身不删除。删除后不能恢复, 确认框也不会列出一并删除的下级专题,删之前先在左侧树里看一眼。
五、权限
在 用户 → 角色管理 的权限树里,“专题管理”下的各项与操作的对应关系:
| 权限 | 能做什么 |
|---|---|
| 列表 | 进入专题管理,查看专题和专题里的文章 |
| 新增 | 新增专题、新增子专题 |
| 编辑 | 修改专题,在左侧树里拖动,在 文章 页签添加、移出、排列文章 |
| 删除 | 删除专题(连同下级专题) |
| 整理树形结构 | 整理树形结构 |
“专题管理”只在标准版及以上的权限树里出现。有“文章管理”权限的账号就能使用文章编辑页的 专题 字段和文章列表的 专题 查询条件, 不需要另给专题管理的权限。
六、前台页面与主题
| 地址 | 模板 | 内容 |
|---|---|---|
/topic、/topic?page= | topics | 专题列表。默认每页 12 个,默认主题列出一级专题。页码用查询参数,/topic/{…} 只用于专题页(别名可以是纯数字) |
/topic/{别名}、/topic/ | 专题的 专题模板,未选为 topic | 专题页。文章列表每页条数取专题的 分页条数;别名不存在返回 404 |
- 专题页的文章列表包括各级下级专题里的文章(同一篇只出现一次),只列已发布、已归档的文章,并且只列访问者能浏览的栏目里的文章 (见栏目浏览权限的“规则”一节)。专题页本身不做浏览权限限制。
- 专题页不生成静态页,开启静态化后仍是动态地址,见页面静态化的“静态页的地址与存放位置”一节。
- 默认主题的专题页调用
${api}/计数:专题自身的浏览量(topic/ view/ {专题ID} topic.selfViews)加 1, 这个专题和各级上级专题的累计浏览量(topic.views)、站点访问量也各加 1,见访问统计与浏览量的 “文章、栏目和站点的浏览量”一节。
模板指令:
| 指令 | 用途 |
|---|---|
Topic | 取一个专题:id,或 slug(别名,可加 siteId) |
TopicList | 专题列表。不带参数时取一级专题;parentId 或 parent(上级专题的别名)取它的直接下级,再加 isIncludeChildren= 取它本身和各级下级;支持 limit、offset、orderBy,默认按专题管理里的顺序 |
TopicPage | 参数同 TopicList,另有 page、pageSize,返回分页对象 |
ArticleTopicList | 专题的文章分页,topicId 必填,另有 page、pageSize;顺序即 文章 页签里的排列 |
[@ArticleTopicList topicId=topic.id; pagedList]
[#list pagedList.content as bean]
<a href="${bean.url}">${bean.title}</a>
[/#list]
[/@ArticleTopicList]topic、topics 模板只在标准版及以上渲染,可以直接使用这些指令;首页、栏目页等各版本共用的模板和侧栏面板里调用时,须放在 [#if config. 之内(参考默认主题的 snippets/),否则社区版、基础版渲染时 会因指令不存在而报错。limit、page 等通用参数的默认值见模板标签与 API 的通用参数。
公开接口:GET /api/topic(本站全部专题,不分页)、GET /、GET /(可加 siteId)、 GET /(专题的文章分页,规则同 ArticleTopicList,pageSize 默认 20)、 GET /(浏览计数)。
主题演示数据里的专题放在 seed/,每个专题写 originId 和 title,可选 alias(别名,省略时取 originId)、image、text、ext(seoTitle、seoKeywords、seoDescription)、customs 和 articles(按顺序列出文章的 originId)。导出主题时,在主题详情的 导出种子包 里用 专题范围 选择带上哪些专题。写法见组件、区域与演示数据的“内容种子”一节。
七、常见问题
没有“专题管理”菜单。 专题需要标准版及以上;版本够的话,是角色没有“专题管理”下的“列表”权限。
保存时提示“专题别名已经存在”或“别名只能由英文字母、数字、下划线、中划线组成”。 换一个本站没用过的别名, 或者清空别名让系统生成。
专题模型的下拉框是空的,保存时提示“必填字段”。 本站还没有专题模型。到 配置 → 模型管理 的 专题模型 页签新增一个, 再回来新增专题。
上级专题是灰的,改不了。 已有专题的上级只能在左侧树里拖动来改。
选择文章时找不到某篇文章。 对话框只列出已发布的文章;草稿、待审核、已下线的文章先发布再添加。
前台专题页的文章比“文章”页签里的多,或者少。 多出来的是下级专题里的文章;少掉的是没有发布(或已下线、在回收站), 或者访问者无权浏览所在栏目的文章。
打开或关闭“倒序排序”,前台顺序没变。 专题页按 文章 页签里排列的顺序显示,见“新增和编辑专题”一节。
在专题模型里打开了正文,专题页上还是看不到。 默认主题的专题页不输出正文,需要在专题模板里自己输出 topic.text。
首页加了专题列表后,换到社区版或基础版就报错。 共享模板里的专题指令没有放进 [#if config. 判断, 见“前台页面与主题”一节。
导入演示数据时提示“站点尚无专题模型”。 先到 配置 → 模型管理 新建一个专题模型,再重新导入演示数据,专题会补上。