Creating and Using RSS Feeds

Create an RSS within Percussion For a Page Auto List

These steps outline how to integrate RSS into your website using the Page Auto List widget to provide access to your internal content.

Step 1) Edit the page on which you would like to provide the RSS.

Step 2) Click on the layout tab.

Step 3) In the region you would like to provide the feed, insert the Page Auto List widget.

Step 4) On the widget click the configure icon to open the widget properties.

Step 5) Configure the widget like you would normally configure a Page Auto List widget (See Page Auto List Configuration).

Step 6) Check the “Include rss icon” field and choose the position of the RSS icon. This will position the link to the RSS feed above or below the list in the widget.

Step 7) Save the page and click on the Content tab.

Step 8) Edit the widget content to choose what content source you would like to display.

Step 9) Open the Meta-data option and check the “Enable RSS feed” checkbox. Provide a Feed title, name, and description for the RSS Feed.

Step 10) Save the page. At this point you will not see the RSS link.

Step 11) Approve the page

Step 12) Run an Incremental or Full publish to publish the new RSS Feed, then view the Page on the Website to see the RSS feed link.

NOTE: The format of the url for the RSS feed will be either:

  • http://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/
  • https://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/

You can find the url to the RSS feed by clicking on the RSS icon which will bring you to an XML document. Take the browser url of the XML document and you can now paste that into a third party service.

Create an RSS within Percussion For a Blog

These steps outline how to integrate RSS into your website using the Blog List widget to provide access to your blogs.

Step 1) Edit the page on which you would like to provide the RSS.

Step 2) Click on the layout tab.

Step 3) In the region you would like to provide the feed, insert the Blog List widget.

Step 4) On the widget click the configure icon to open the widget properties.

Step 5) Configure the widget like you would normally configure a Blog List widget (See Blog List Configuration)

Step 6) Check the “Include rss icon” field and choose the position of the RSS icon. This will position the link to the RSS feed above or below the list in the widget.

Step 7) Save the page and click on the Content tab.

Step 8) Edit the widget content and check the “Enable RSS feed” checkbox.

Step 9) Provide a Feed title, name, and description for the RSS Feed.

Step 10) Save and Approve the page. At this point you will not see the RSS link.

Step 11) Publish the page with an Incremental or Full Publish and view it to see the RSS feed link.

NOTE: The format of the url for the RSS feed will be either:

  • http://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/
  • https://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/

You can find the url to the RSS feed by clicking on the RSS icon which will bring you to an XML document. Take the browser url of the XML document and you can now paste that into a third party service.

Integrate External RSS within Percussion

These steps outline how to integrate an external RSS to your site using the RSS widget.

Step 1) Edit the page on which you would like to provide the RSS.

Step 2) Click on the layout tab.

Step 3) In the region you would like to provide the feed, insert the RSS widget.

Step 4) On the widget click the configure icon to configure the format of the RSS feed.

Step 5) Click OK, and save the page. Then move to the Content tab.

Step 6) Edit the widget content and provide your external RSS link ending in .rss.

Step 7) Click Save and save the page. At this point you will not see the content pulled in from the external source.

Step 8) To view the content, publish the page and you should now see your external content.

NOTE: The format of the url for the RSS feed will be either:

  • http://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/
  • https://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/

You can find the url to the RSS feed by clicking on the RSS icon which will bring you to an XML document. Take the browser url of the XML document and you can now paste that into a third party service.

Changing the Style of Your External RSS Feed

The RSS widget is formattable through CSS if you choose to style the output of the RSS feed.

Step 1) Edit the page where your RSS widget is located.

Step 2) Click on the Page’s Style tab and click on the configure icon on the RSS widget.

Step 3) Provide the name of the CSS class you would like to use to style your RSS feed.

Step 4) Click OK, and save and publish the page.

FAQ

Q) Can I use aggregator sites such as Digg Reader, or Feed.press?

A) Yes! The RSS feed url is compatible with aggregator sites such as these.

Q) Where is my RSS URL?

A) You can find the url to the RSS feed by clicking on the RSS icon which will bring you to an XML document. Take the browser url of the XML document and you can now paste that into a third party service. Or you can go to the feed service directly to retrieve the feed by following  either of the two url formats:

  • http://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/
  • https://[delivery tier service host]:[port]/feeds/rss/{sitename}/{feedname}/

Troubleshooting

  • If you publish and click on the RSS icon leading you to something other than the xml RSS feed then you may want your admin to check the delivery server connection configuration. Make sure that the the <connection> element is configured to point at your delivery server.