Confluence RSS源宏

将RSS源宏添加到页面以显示外部或内部RSS源的内容。例如，要显示博文或在空间中列出最近更新的页面，您可以在Feed Builder中创建一个内部 Feed，然后使用此宏进行渲染。

这是一个遗留宏，出于安全原因，Confluence管理员通常会禁用它。

安全考虑

您的 Confluence 管理员可能禁用了RSS Feed宏。此外，您的Confluence管理员可以定义受信任的URL列表。如果包含的URL不在许可名单中，您将在Confluence页面上看到错误提示。

注意：在网页中包含未知的HTML是危险的。

RSS源中的HTML可以包含可执行脚本组件。这意味着恶意攻击者有可能获取您网站的用户身份来执行他们的脚本。例如，此类代码可用于窃取用户的身份验证cookie并向攻击者提供他们的Confluence登录密码。

在页面中添加宏

在页面中添加RSS Feed宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从External content类别中选择RSS Feed。
3. 输入RSS feed的URL。
4. 点击Insert。

然后，您可以发布您的页面以查看宏的效果。

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数：

1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
   
2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

Feed是最新的？

默认情况下，RSS源宏会将Feed结果缓存60分钟，然后再次获取数据。

如果您希望更改默认缓存，请使用Cache宏来定义RSS Feed宏获取更新的频率。您需要在Confluence上安装Cache插件。

包含不允许的URL的页面会发生什么情况？

您的Confluence管理员可以设置受信任的URL列表。如果是这种情况，您可能会在包含RSS Feed宏的页面上看到错误提示。

验证

来自外部网站的私有Feeds

无法使用RSS源宏访问需要身份验证的RSS源。

访问内部HTTPS Feeds

这仅适用于已为所有内容启用HTTPS的Confluence实例。如果您的站点完全采用HTTPS，则RSS源宏无法访问内部源。要启用RSS Feed宏以访问内部源而不影响您的HTTPS 设置，请启用仅限本地的HTTP访问：

1. 关闭Confluence。
2. 请参阅SSL guide以启用对Confluence的HTTP访问。你需要确保你有一个 HTTP连接器和一个SSL连接器。这意味着Confluence将可以通过HTTP和HTTPS访问。但是，您不应在web.xml中有重定向端口或规则来重定向所有流量。
3. 不要使用web.xml重定向流量，而是添加防火墙规则，将所有不是来自Confluence服务器的HTTP请求重定向到等效的HTTPS URL。这确保用户只能按预期通过HTTPS访问Confluence。如果您仍然启用对附件的 HTTP访问（以避免IE下载错误），您也需要考虑启用这些URL地址。

4. 修改您的Confluence RSS Feed宏的Feed链接以使用HTTP URL，然后重新启动Confluence。

启用或禁用宏

要启用或禁用RSS Feed宏：

1. 前往

   Error rendering macro 'excerpt-include'

   User 'null' does not have permission to view the page.

    > 插件（Add-ons）.
2. 从下拉菜单中选择System并搜索Confluence HTML Macros系统插件。
3. 展开列表并启用或禁用rss(rss-xhtml)模块。

其它添加方式

用键盘输入添加宏

通过wiki标记添加宏

当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: rss

Macro body: None.

{rss:max=10|showTitlesOnly=true|url=http://myblog.com/feed|titleBar=false}