Arguments

ca_terasi() supports the following arguments:

• before and after
  String, text to display before and after the output.
• before_list and after_list
  String, text to display before and after each result.
• max_item
  Integer, maximum result to display. Use 0 to display all results.
• url
  String, URL for the RSS feed.
• blog
  String, URL for your blog site. Will use your WordPress setting if not spesified.
• format
  String, format template for your output. Define custom keyword(s) using map and map_channel argument.
• map
  String, custom keyword(s) mapping for RSS item’s element. Format is “keyword1 element1 keyword2 element2 …” (space separated string). Read Custom Mapping section for more detail information.
• map_channel
  String, custom keyword(s) mapping for RSS channel’s element. Currently support single channel feed only. Format is “keyword1 element1 keyword2 element2 …” (space separated string). Please be specific and use DIFFERENT keyword than your previous map argument. Read Custom Mapping section for more detail information.
• link_keyword
  String, element name which hold the link for the item. If set, CA-Terasi will hide feed result from your blog (since there’s no point to show it up again). Fill blank or use any imaginary-non-exist element’s name to not hide.

Example

[php]< ?php ca_terasi('http://planet.wordpress.org/rss20.xml', 'max_item=4&before=On Planet.WordPress&after=Visit Planet.WordPress today&format=Read %title‘); ?>[/php]

Display a maximum of 4 items feed from Planet WordPress. The output will begin with ‘On Planet.WordPress’ text and ended with ‘Visit Planet.WordPress’ text link.

[php]< ?php ca_terasi('http://rss.news.yahoo.com/rss/world', 'max_item=10&before=

On Yahoo!News&after=’); ?>[/php]

Display a maximum of 10 items feed from Yahoo! News (World).

The easiest way to use this plugin is just pass the RSS feed URL to the url parameter and leave the arguments alone. The minimum thing you have to change on the arguments is before argument (since it works as the title).

Custom Mapping

Below are example of custom mapping settings for some RSS feed:

— later —

To Do

Future plan:

• Multi-Channel support.
• Fix character encode.
• Support for another feed type (currently work with RSS feed only).

Version History

v0.2 - April 27th 2005

• Use arguments instead of parameter
• Formatted output
• Custom feed item attribute mapping
• Support for Channel attribute mapping

v0.1 - April 26th 2005

• Initial, not released to public

Pages: 1 2