单页管理系统
本模块用于管理网站中那些结构相对固定的页面,如“关于我们”、“加入我们”、“服务协议”、“隐私声明”等。
模型结构 (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
前端集成建议
- 路由匹配: 在前端框架中,可以设置一个通用路由
/[slug],然后调用接口获取内容。 - SEO 优化: 接口返回的
seoTitle、seoDescription等字段应直接注入到 HTML 的<head>标签中。 - 内容渲染: 正文内容为富文本格式,建议使用对应的 HTML 解析器或 Markdown 解析组件进行渲染。
