Flarum 的 RSS/Atom 订阅扩展
为 Flarum 带来 RSS 和 Atom 订阅功能。
基于 amaurycarrade/flarum-ext-syndication，该扩展自 2019 年起已停止维护。本分支以及让扩展重获新生所需的修改由 010101 赞助。
安装
composer require ianm/syndication:"*"
订阅源
| 路由 | 内容 |
| --- | --- |
| /atom | 最新有活动的讨论（首页作为订阅源） |
| /atom/discussions | 论坛中新建的讨论 |
| /atom/d/{id} | 单个讨论中的最新帖子（如 /atom/d/21-discussion-slug）|
| /atom/u/{username}/posts | 单个用户的最新帖子 |
| /atom/t/{slug} | 标签下的最新有活动讨论（需 flarum/tags）|
| /atom/t/{slug}/discussions | 标签下新建的讨论（需 flarum/tags）|
将以上任何 URL 中的 atom 替换为 rss 即可获得 RSS 版本。
讨论列表订阅源支持 ?sort=latest|top|newest|oldest 排序和 ?q=<搜索> 筛选。两者可组合使用：?sort=<排序>&q=<搜索>。
订阅源链接已添加到页面头部，支持自动发现。
设置
| 选项 | 默认值 | 说明 |
| --- | --- | --- |
| 全文订阅 | 关闭 | 关闭时，帖子内容截断为 400 字符。开启时包含完整内容。 |
| 格式化订阅（HTML） | 关闭 | 关闭时，HTML 被剥离，实体被解码，内容为纯文本。开启时，原始 HTML 通过 CDATA 块传递（Atom <content type="html">）。|
| 每页条目数 | 100 | 每次订阅响应中的最大条目数。 |
| 在论坛显示订阅链接 | 关闭 | 在所有讨论、标签和讨论页面显示 RSS 图标。 |
| 论坛订阅格式 | Atom | 论坛图标链接到的格式 — Atom 或 RSS。 |
兼容性说明
blomstra/search — 标签订阅在安装了 Blomstra 搜索扩展后仍可工作。标签筛选通过 filter[tag]（由核心的 TagFilterGambit 作为 FilterInterface 处理）传递，而非 gambit 编码在 filter[q] 中，后者之前导致 Blomstra 的 Elasticsearch 覆盖返回空结果。详见 #20。
链接
