Skip to content

内容发布系统

本插件内置了一套完整的 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


前端集成建议

  1. 列表页: 直接调用 /api/bag/articles 渲染卡片流。
  2. 详情页: 使用 /api/bag/articles/:slug 获取数据,正文内容可以通过 React Markdown 或相应的富文本解析库渲染。
  3. 阅读量: 无需在前端手动发送“增加阅读量”的 POST 请求,详情接口访问即生效。

Released under the MIT License.