页面与内容块
管理官网页面和内容块,通过 CMS 灵活配置网站内容
页面与内容块
页面与内容块是欣悦互通内容管理系统(CMS)的核心,让您无需修改代码即可管理官网的页面结构和内容。页面用于组织完整的内容单元,内容块则是可复用的内容片段,两者配合实现官网内容的灵活配置。
本功能面向需要维护官网内容的运营人员。
页面管理
页面是官网内容的基本单元,每个页面对应一个 URL 路径(slug)。您可以创建新页面、编辑已有页面内容,并按需发布或下线。
创建页面
- 进入「内容管理 > 页面」页面
- 点击「新建页面」,填写以下信息:
- 页面标题
- Slug(URL 路径,如
about-us) - 页面模板
- SEO 元信息(标题、描述、关键词)
- 编辑页面内容
- 保存草稿或直接发布
编辑页面
在页面列表中点击「编辑」,可修改页面内容。支持富文本编辑和内容块嵌入。
按 Slug 获取页面
官网前端通过 Slug 获取页面内容并渲染。每个 Slug 全局唯一,修改 Slug 会导致旧 URL 失效。
!WARNING 修改已发布页面的 Slug 会导致该页面 URL 变更,外部链接和搜索引擎已收录的地址将失效。如必须修改,请设置 301 重定向。
渲染页面
页面内容支持动态渲染,系统会将页面内容结合模板输出为最终 HTML:
POST /api/cms/pages/{id}/render
渲染结果可直接用于官网前端展示。
删除页面
删除页面会同时清除其内容块关联。已删除的页面无法恢复,请谨慎操作。
!NOTE 建议先下线再删除,给搜索引擎和用户一个缓冲期,避免 404 影响体验。
内容块管理
内容块是可复用的内容片段,如页头、页脚、侧边栏推荐、公告横幅等。通过内容块,您可以在多个页面复用同一段内容,修改一处即全局生效。
创建内容块
- 进入「内容管理 > 内容块」页面
- 点击「新建内容块」,填写:
- 内容块名称(如 "全站页脚")
- 内容块标识(如
global-footer) - 内容类型(文本 / HTML / 富文本)
- 内容内容
- 保存后可在任意页面通过标识引用
内容块 vs 页面
| 维度 | 页面 | 内容块 |
|---|---|---|
| 作用 | 完整内容单元 | 可复用内容片段 |
| 独立 URL | 是(通过 Slug) | 否 |
| 复用性 | 一般不复用 | 多页面复用 |
| 典型场景 | 文章页、关于我们 | 页头、页脚、公告 |
使用场景
- 全站页脚:创建一个内容块,所有页面引用同一内容块
- 促销横幅:创建内容块,临时活动期间在首页引用
- 通用侧边栏:创建推荐内容块,在多个页面复用
!TIP 将频繁变动的内容(如联系方式、促销信息)封装为内容块,修改时只需更新一处,所有引用页面同步生效。
页面渲染机制
官网基于 Nuxt 4 SSR 渲染,页面内容通过 API 获取后渲染为 HTML。渲染流程:
- 用户访问官网页面(如
/about-us) - 前端通过 Slug 调用 API 获取页面内容
- 系统将页面内容中的内容块标识替换为对应内容块
- 结合模板渲染为最终 HTML 返回
API 参考
| 方法 | 路径 | 说明 |
|---|---|---|
| GET / POST | /api/cms/pages | 页面列表 / 创建 |
| GET / PUT / DELETE | /api/cms/pages/{id} | 页面详情 / 更新 / 删除 |
| GET | /api/cms/pages/by-slug/{slug} | 按 Slug 获取页面 |
| POST | /api/cms/pages/{id}/render | 渲染页面 |
| GET / POST | /api/cms/blocks | 内容块列表 / 创建 |
| PUT / DELETE | /api/cms/blocks/{id} | 内容块更新 / 删除 |
相关链接
此页有帮助吗?