||||\n-|-|-|\n:discourse2: | 摘要 | 允许您自动将内容从 RSS/ATOM 源导入到您的 Discourse 站点作为主题\n:open_book: | 安装指南 | 此插件已与 Discourse 核心捆绑在一起。无需单独安装插件。\n\n\n[quote]\n\n:discourse2: 由于这是由 Discourse 团队维护的 official 插件，#support、#bug、UX 和 Feature 请求可以在 Meta 上的相应类别中提出，并使用适当的插件标签进行标记。点击下面的链接即可开始一个。
\n\n\u003ckbd\u003e [
\u0026nbsp;支持](Discourse Meta "就 RSS 轮询的配置和使用寻求支持") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;Bug](Discourse Meta "Bug 报告意味着某些东西坏了，阻止了插件的正常/典型使用") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;用户体验 (UX)](Discourse Meta "关于 RSS 轮询的用户界面，以及功能呈现方式的讨论（包括语言和 UI 元素）") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;功能](Discourse Meta "关于如何改进或增强现有 Discourse Math 功能的讨论，以及提议的新功能如何运作")\u003c/kbd\u003e\n\n[/quote]\n\n\u003e 
本指南解释了如何配置和使用 RSS 轮询插件，将内容从 RSS/ATOM 源自动导入到您的 Discourse 站点作为主题。\n\u003e \n\u003e 
所需用户级别：管理员\n\n## 摘要\n\n本文档将介绍启用 RSS 轮询插件、配置源 URL、管理设置以及对常见问题进行故障排除。您将学习如何设置源以发布到特定类别、分配作者以及控制内容在您的网站上显示的方式。\n\n## 启用 RSS 轮询插件\n\n### 自托管站点\n\n导航到您的管理面板中的 Admin \u003e Plugins 面板，找到 RSS 轮询插件。使用切换开关启用它：\n\n
\n\n### 由 Discourse 托管\n\n如果您的站点由 Discourse 托管，请联系支持团队以请求激活 RSS 轮询插件。该插件在所有托管计划中都可用。\n\n## 配置 RSS 源\n\n启用插件后，通过直接访问 Admin \u003e Plugin \u003e RSS Polling 面板，或导航到 /admin/plugins 并从侧边栏菜单中选择“RSS Polling”，来访问 RSS 轮询配置页面。\n\n
保存按钮。\n\n可选：添加将应用于此源所有主题的标签和/或输入源类别过滤器以限制导入哪些源项目\n\n\n\n\n### 源类别过滤器\n\n源类别过滤器设置允许您根据项目的类别元数据限制发布哪些源项目。当您在此字段中输入类别术语时，只有与该特定类别匹配的源项目才会被导入到 Discourse 中。\n\n例如，如果您检查源 
https://blog.discourse.org/feed.xml，您会看到每个条目都有类别信息。您将输入类别 term 属性的值以过滤特定类别。\n\n\n\n## YouTube 源配置\n\n\n[details="常见示例"]\nYouTube 是与 RSS 轮询一起使用的最常见平台之一，但它也容易配置错误。以下是针对最常见的 YouTube 用例的推荐和支持的源 URL 格式。\n\n### 导入 YouTube 播放列表\n\n要从 YouTube 播放列表中导入视频，您必须使用 YouTube 的播放列表 RSS 源端点。\n\n正确格式为：\n\n
\nhttps://www.youtube.com/feeds/videos.xml?playlist_id=\u003cPLAYLIST-ID\u003e\n\n\n其中 \u003cPLAYLIST-ID\u003e 是在播放列表 URL 中找到的令牌。\n\n例如，给定此播放列表 URL：\n\n\nhttps://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR\n\n\n\n\n正确的 RSS 源 URL 将是：\n\n\nhttps://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR\n\n\n### 导入 YouTube 频道\n\n要从 YouTube 频道导入视频，请使用频道 RSS 源格式：\n\n\nhttps://www.youtube.com/feeds/videos.xml?channel_id=YOUR_CHANNEL_ID\n\n\n您可以在频道的高级设置下的 YouTube 中找到 channel_id。\n\n\u003e 
直接使用频道 URL、用户名 URL 或自定义频道 URL 将无效。RSS 轮询插件需要明确的 channel_id 源 URL。\n\n### 避免的常见错误\n\n* 使用标准的 YouTube 页面 URL 而不是 RSS 源 URL\n* 在未提取正确 ID 的情况下使用播放列表或频道 URL\n* 在同一源 URL 中混合使用播放列表和频道参数\n\n如果 YouTube 源配置错误，RSS 轮询插件可能会静默失败或停止导入新主题。\n[/details]\n\n\n## 配置轮询频率\n\nrss polling frequency 站点设置控制 Discourse 检查 RSS 源以获取新内容的频率。默认值为 30 分钟，允许的最小值是 10 分钟，最大值为 180 分钟（3 小时）。\n\n#### 自托管站点\n要调整轮询频率：\n\n1. 转到 /admin/site_settings\n2. 搜索“rss polling frequency”\n3. 以分钟为单位设置所需的间隔\n\n#### 托管站点\n联系支持团队，请求调整 rss_polling_frequency 站点设置。\n\n## 管理源设置\n\n### 更改源作者\n\nYou can change the author of all topics associated with a specific RSS feed by updating the "Author" field on the RSS Polling settings page. This will automatically update all existing topics from that feed with the new author. These changes appear as system post edit events in your admin logs.\n\n\n\n### 更改源类别或标签\n\n更改 RSS 源 URL 的类别或标签不会自动更新现有主题。您需要：\n\n1. 使用“管理批量操作”手动将现有主题移动到新类别或更新标签\n2. 更新 RSS 源设置，以便新主题使用正确的类别和标签\n\n### 源 URL 限制\n\n每个唯一的 RSS 源 URL 只会在 Discourse 中导入一次。当您首次配置 RSS 源时，Discourse 会导入整个源。删除并重新添加相同的源 URL 不会重新导入先前处理的项目。\n\n## 控制主题可见性\n\n### 防止主题被取消列出\n\n默认情况下，嵌入的主题在收到回复之前处于未列出状态。此行为对于 RSS 导入的主题没有意义。要防止 RSS 主题被取消列出：\n\n1. 转到 
/admin/site_settings\n2. 搜索“embed unlisted”\n3. 禁用此设置\n\n### 显示完整帖子内容\n\n如果启用了 embed truncate 站点设置（默认设置），源主题将只显示一个摘录。用户可以通过点击“显示完整帖子”按钮来查看完整内容。\n\n要始终显示完整内容：\n\n1. 转到 Admin \u003e Site Settings\n2. 搜索“embed truncate”\n3. 禁用此设置\n\n如果完整帖子内容未正确显示，请配置 embed whitelist selector 站点设置以指定应导入哪些 HTML 元素。\n\n## 常见问题和解决方案\n\n### 源未更新\n检查：\n- RSS 源 URL 有效且可访问\n- 轮询频率没有设置得太高\n- 自上次轮询以来 RSS 源中确实有新项目\n\n### 插件界面无响应\n一些用户报告 RSS 轮询配置界面无响应的问题。这通常是由浏览器广告拦截器干扰管理界面引起的。请尝试：\n- 禁用广告拦截器对您的 Discourse 站点的拦截\n- 使用不同的浏览器\n- 强制刷新页面\n\n### 主题创建日期错误\n默认情况下，RSS 主题在导入时使用当前日期。如果您想使用 RSS 源中的原始发布日期，请启用 rss polling use pubdate 设置。\n\n## 常见问题 (FAQ)\n\n我可以多久轮询一次 RSS 源？\n最小轮询频率为 10 分钟，最大为 180 分钟（3 小时）。\n\n我可以导入 RSS 源中的回复吗？\n不可以，RSS 轮询插件只将主要的源项目导入为独立的主题。它不导入评论或回复。\n\n删除并重新添加源会导致重复的主题吗？\n不会，每个 RSS 源项目只导入一次。重新添加源不会创建重复项。\n\n如何调试 RSS 轮询问题？\n目前，该插件的日志记录有限。请在 Admins \u003e Security \u003e Logs 面板中检查您的 Discourse 日志，查看与 RSS 轮询相关的任何错误消息。\n\n## 附加资源\n\n\n* https://meta.discourse.org/t/how-to-configure-the-embed-whitelist-selector-setting/134481\n* https://meta.discourse.org/t/administrative-bulk-operations/118349\n* https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963",“target_locale”:"zh_CN"}