RSS フィード マクロ

RSS feed macro embeds an RSS feed on a page. It can display the contents of external feeds, or internal feeds generated by Confluence. To display blog posts or list recently updated pages in a space, use the Feed Builder to create an internal feed, then render it using this macro.

• 用途
• Optional Parameters
• Working Example
• Enabling Feed Caching
• Accessing Internal HTTPS Feeds

用途

Use the Wiki Markup Editor to edit the page and insert the RSS macro with your feed link.

Replace the 'http://www.example.com/rss/' URL with your own feed link in this example:

{rss:url=http://www.example.com/rss/}

By default, the RSS Feed macro caches the feed results for 60 minutes before fetching the data again. If you wish to change the default caching, use the {cache} macro described below.

Authentication for Confluence feeds
You can add your Confluence username and password to the feed URL, so that the RSS Feed Macro can log in to Confluence.
Please note that if you do this, someone with access to your RSS newsreader configuration can read your password.

Private feeds from external sites
RSS feeds which require authentication can't be accessed using the RSS Macro.

Optional Parameters

The effects of these parameters are described below.

1. Limit the number of entries displayed

This parameter defaults to '15'.

{rss:url=http://host.com/rss.xml|max=5}

2. Show only the RSS feed titles.

This parameter defaults to 'False'.

{rss:url=http://host.com/rss.xml|showTitlesOnly=true}

3. Hide the feeds titlebar

This parameter defaults to 'True'.

{rss:url=http://host.com/rss.xml|titleBar=false}

Working Example

This was rendered using the wiki markup

{rss:url=http://www.abc.net.au/news/syndicate/breakingrss.xml|max=5|showTitlesOnly=true}

Enabling Feed Caching

You can use the {cache} macro to define how often the RSS Feed macro fetches the feed updates. You may want to set the cache to a longer period, so that your page loads faster. Or you may want to retrieve feed results more often, if you need to see the updates sooner.

You will need to install the Cache Macro. To enable caching:

1. Install the Confluence Repository Client into Confluence.
2. Once setup, use the Confluence Repository Client plugin page to install the "Scripting Plugin" and "Utilities Plugin".
3. For each RSS macro that you wish to cache, surround your RSS Feed call with a Cache macro call. To cache feeds for 30 minutes:

   {cache:refresh=30m}
   {rss:url=http://rss.news.yahoo.com/rss/stocks|max=5}
   {cache}
   

   The Cache plugin page provides more information on customising the cache behaviour.

Accessing Internal HTTPS Feeds

This only applies to Confluence instances which have enabled HTTPS for all content. If your site is fully HTTPS, the RSS macro cannot access internal feeds. To enable the RSS macro to access internal feeds without affecting your HTTPS setup, enable local-only HTTP access:

1. Confluence をシャットダウンします。
2. Use the SSL guide to re-enable HTTP access to Confluence. This means that Confluence will be accessible via both HTTP and HTTPS
3. Insert a firewall rule to redirect all HTTP requests not from the Confluence server to the equivalent HTTPS URL. This ensures that users will only be able to access Confluence via HTTPS, as intended. If you have still left HTTP access for attachments enabled (to avoid the IE download bug) you must selectively enable those URLS as well
4. Modify your Confluence RSS macro feed link to use the HTTP URL, and restart Confluence

関連トピック

Subscribing to RSS Feeds within Confluence
Adding a username and password to Confluence RSS feeds
Tracking Updates Overview
Working with Macros

Return to Confluence 2.7 User Guide