内容发布系统
本插件内置了一套完整的 CMS 内容管理体系,包含文章、分类、标签管理,并针对常见的博客与门户需求进行了深度优化。
模型结构
1. 文章 (Article)
- 核心字段:
标题 (Title): 文章的主标题。别名 (Slug): 用于 SEO 友好的 URL 标识。摘要 (Summary): 文章的简短介绍(500字以内)。正文 (Content): 富文本编辑器支持。封面图 (Cover): 单张图片上传。置顶 (isTop): 开启后在列表接口中优先排序。阅读量 (Views): 自动统计详情页访问次数。
- 关联: 关联分类 (Category)、标签 (Tag)、作者 (User)。
2. 分类 (Category)
- 核心字段: 标题、别名、描述。
- 关联: 支持无限级父子分类嵌套。
3. 标签 (Tag)
- 核心字段: 标题、别名。
- 关联: 与文章建立多对多关联。
API 调用
1. 获取文章列表
自动按置顶权重、发布时间排序,并加载所有关联项。
接口地址: GET /api/bag/articles
支持参数 (Query):
- 标准 Strapi 分页与过滤参数。
- 默认已包含
populate。
2. 获取文章详情
通过 slug 获取文章,系统会自动将该文章的 views 阅读量字段 +1。
接口地址: GET /api/bag/articles/:slug
示例: GET /api/bag/articles/how-to-use-strapi
前端集成建议
- 列表页: 直接调用
/api/bag/articles渲染卡片流。 - 详情页: 使用
/api/bag/articles/:slug获取数据,正文内容可以通过 React Markdown 或相应的富文本解析库渲染。 - 阅读量: 无需在前端手动发送“增加阅读量”的 POST 请求,详情接口访问即生效。
