Skip to content

单页管理系统

本模块用于管理网站中那些结构相对固定的页面,如“关于我们”、“加入我们”、“服务协议”、“隐私声明”等。

模型结构 (Page)

  • 页面标题 (Title): 页面在后台显示的名称。
  • 别名 (Slug): 用于 SEO 友好的 URL 标识,如 about-us
  • 正文内容 (Content): 支持富文本编辑。
  • 封面图 (Cover): 选填,可用于页面头部的背景图。
  • SEO 配置:
    • SEO 标题: 覆盖默认页面标题。
    • SEO 关键词: 页面 meta keywords。
    • SEO 描述: 页面 meta description。
  • 累计阅读量 (Views): 自动统计页面访问次数。

API 调用

1. 获取所有已发布的单页

返回所有已发布的单页列表(通常用于生成站点地图或页脚链接)。

接口地址: GET /api/bag/pages

2. 获取特定单页详情

通过 slug 获取页面详情,系统会自动将该页面的 views 字段 +1

接口地址: GET /api/bag/pages/:slug

示例: GET /api/bag/pages/about-us


前端集成建议

  1. 路由匹配: 在前端框架中,可以设置一个通用路由 /[slug],然后调用接口获取内容。
  2. SEO 优化: 接口返回的 seoTitleseoDescription 等字段应直接注入到 HTML 的 <head> 标签中。
  3. 内容渲染: 正文内容为富文本格式,建议使用对应的 HTML 解析器或 Markdown 解析组件进行渲染。

Released under the MIT License.