RSS Macro

The RSS macro displays the content of an RSS feed.

Usage

{{rss feed="<feed>" content="<true|false>" count="<count>" css="<true|false>" image="<true|false>" width="<px|%>" 
decoration="<true|false>" encoding="<string value>" /}}

Parameters

NameOptionalAllowed ValuesDefault ValueDescription
feedNoAn URLNoneThe URL of the RSS feed
contentYes
  • true
  • false
falseA flag stating whether to display the feed content next to the feed item link
countYesAn integerIf no value is specified, the macro will display all itemsThe number of feed items to display
cssYes
  • true
  • false
falseIf the flag is set to "true", the macro adds the dedicated CSS classes from "colibri.css" (rssfeed, rssitem, rsschanneltitle) that can be overridden via the skin page
imageYes
  • true
  • false
falseA flag stating whether to display the image of the feed
widthYesA string30%The width of the box containing the RSS output, in px or in %
decorationYes
  • true
  • false
trueA flag stating whether to display UI decorations around the feed and feed entries
encodingYesA stringIf specified, then this encoding will be used to read the RSS feed's XML. Otherwise the encoding is guessed from a variety of places like the XML header, BOM, XML Prolog, etc. This parameter should be used when the guessed encoding is not correct.Guessed
The RSS Macro now supports feeds delivered over HTTPS and it now uses its own user-agent string, XWiki/VERSION, where VERSION is the version of the XWiki in use.

Examples

Example 1

{{rss feed="http://xml.feedcat.net/xwikiblogen" content="true" count="5" width="50%" /}}

will display 

RssMacro.png

Example 2

{{rss feed="http://api.flickr.com/services/feeds/photos_public.gne?format=rss_200&tags=xwiki" content="true" count="3"
image="true" width="50%" /}}

will display

RssMacroWithImage.png

 

Related Pages

Search this space

 

Most popular tags

Failed to execute the [groovy] macro
  1. access rights
  2. activity stream
  3. annotation
  4. attachment
  5. comment
  6. Document Tree Macro
  7. export
  8. Extension Manager
  9. Flamingo skin
  10. global user
  11. Groovy event listener
  12. group
  13. nested page
  14. search
  15. skin
  16. syntax
  17. user
  18. user profile
  19. velocity macros
  20. wiki
  21. wysiwyg
  22. XWiki Applications
  23. xwikiattachment_archive table
  24. xwikiattachment table
  25. xwikiattrecyclebin table
  26. xwikiproperties table

[Display all tags from this space]