Headlines Plugin

This plugin displays RSS feeds from news sites. Use it to build news portals that show headline news.

Note: Syndic8.com ( http://www.syndic8.com/ ) is a good site listing many RSS feeds.

HeadlinesPlugin Global Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %HEADLINES_SHORTDESCRIPTION%

• One line description, shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Build news portals that show headline news based on RSS news feeds from news sites.

• Set DEBUG to 1 to get debug messages in data/debug.txt. Default: 0
  • Set DEBUG = 0

• Refresh rate in minutes for cached feeds. Disable caching: 0, default: 30
  • Set REFRESH = 30

• Maximum number of items shown. Default: 100
  • Set LIMIT = 100

• Default header: (variables are explained in the syntax rules)

      * Set HEADER = | *[[$channellink][$channeltitle]] [[$imagelink][<img src="$imageurl" alt="$imagetitle" border="0" />]]* |

• Default format of one item: (variables are explained in the syntax rules)

      * Set FORMAT = | [[$link][$title]] |

Syntax Rules

The %HEADLINES{...}% variable gets expanded to the content pulled from an RSS feed.

Examples

Write %HEADLINES{ href="http://slashdot.org/slashdot.rdf" }% to get the latest Slashdot news in table format:

HEADLINES Plugin Error
HeadlinesPlugin: Can't read http://slashdot.org/slashdot.rdf (301 Moved Permanently)

Write %HEADLINES{ href="http://www.moreover.com/cgi-local/page?o=rss&c=Aerospace%20and%20defense%20industry%20news" header="   * [[$channellink][$channeltitle]]:" format="      * [[$link][$title]] ($description)" }% to get Aerospace and defense industry news rendered as a bullet list:

• $channeltitle^?:

Known issues

• Topic load time depends on timeit takes to load the RSS feed. A future version might include some caching to improve performance.
• This plugin uses the undocumented TWiki::Net::getUrl() function. The plugin might break in a future TWiki release.
• URLs on virtual hosts cannot be read, for example, TWiki:Codev/TWikiSyndication does not work. This is a limitation of TWiki::Net::getUrl()

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

• Download the ZIP file from the Plugin web (see below)
• Unzip HeadlinesPlugin.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/HeadlinesPlugin.txt	Plugin topic
  data/TWiki/HeadlinesPlugin.txt,v	Plugin topic repository
  lib/TWiki/Plugins/HeadlinesPlugin.pm	Plugin Perl module

• Test if the plugin is correctly installed:
  • Check if above example shows a news feed instead of variable.

Plugin Info

Related Topics: TWikiPreferences, TWikiPlugins

-- PeterThoeny^? - 02 Aug 2002