Headlines Plugin

Description

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

Note: Syndic8.com ( http://www.syndic8.com/ ) lists many RSS feeds.

Syntax Rules

%HEADLINES{"..."}%

The header and format parameters might also use variables rendering the dc, image and content namespace information. Note, that only bits of interest have been implemented so far and those namespaces might not be implemented fully yet.

Rendering the dc namespace

The following variables are extracting the dc namespace info, that could be used in header and format. Nnote, that some of the variables are already used above. This is done by purpose to use different feeds with the same formating parameters. If there's a conflict the non-dc tags have higher precedence, i.e. a <title> content </title> is prefered over <dc:title> content </dc:title> .

• $title: channel/article title (dc:title)
• $creator: channel creator (dc:creator)
• $subject: subject text; this will also add an image according to the subject hash list, see above (dc:subject)
• $description: ... (dc:description)
• $publisher: the channel/article publisher (dc:publisher)
• $contributor: ... (dc:contributor)
• $date: ... (dc:date)
• $type: ... (dc:type)
• $format: ... (dc:format)
• $identifier: ... (dc:identifier)
• $source: ... (dc:source)
• $language: ... (dc:language)
• $relation: ... (dc:relation)
• $coverage: ... (dc: coverage)
• $rights: ... (dc: rights)

Rendering the image namespace

An image:item is converted into an <img> tag using the following mappings:

• src: image url (rdf:about attribute of the image.item tag)
• alt: image title (title)
• width: image width (image:width)
• height: image height image:height)

Rendering the content namespace

The variable $content is refering to the <content:encoding> content </content:encoding>.

Examples

Slashdot News

Write

%HEADLINES{ "http://slashdot.org/slashdot.rdf" 
  header="*[[$link][$title]]:* $description" 
  format="$t* [[$link][$title]]"
  limit="4"
}%

Business Opportunities Weblog

Write

%HEADLINES{ "http://www.business-opportunities.biz/feed" limit="2" }%

to get the latest postings on the "Business Opportunities" weblog:

Business Opportunities Weblog

Wed, 23 May 2012 00:01:58 +0000

The original blog about business opportunities and business ideas for small business entrepreneurs

Niche Biz: A Cleaning Service for Moms, By Moms (Who Wear Their Babies)

Tue, 22 May 2012 21:35:02 +0000 Dane Carlson

This is the most niche cleaning business I've seen all week!

Melone had a brainstorm.

''I used to clean houses while I was in college, and my brain started ticking - why not start a cleaning business, by moms for moms,'' said Melone. ''A business where you could take your babies with you while helping out working moms by cleaning or organizing for them, all while creating jobs for other new moms.''

She found a line of organic cleaning products, Clean Irene, which were a perfect fit for the business - and now they are local distributors of the national product line.

On a recent Friday, they are working in Nashua, sprucing up Katie Olivier's kitchen. It's the first time Olivier has used a cleaning service.

Idea: First Aid UAV

Tue, 22 May 2012 20:54:49 +0000 Dane Carlson

Brad Templeton:

There’s a lot of excitement about the potential of autonomous drones, be they nimble quadcopters or longer-range fixed wing or hybrid aircraft. A group of students from Singularity University, for example, has a project called MatterNet working to provide transportation infrastructure for light cargo in regions of Africa where roads wash out for half the year.

Closer to home, these drones are not yet legal for commercial use, while government agencies are using them secretly.

Here’s one useful idea: A small set of medical drones scattered around the city. Upon emergency call, they can fly, via a combination of autonomous navigation and remote-human-operated flying at the end, to any destination in the city within a couple of minutes. Call 911 and as soon as you say it’s a medical emergency the drone is on the way. When it gets there, the human operator lands it or even sends it in a balcony on tall buildings with balconies. Somebody has to carry it to the patient if they are far from the outside.

When it gets to the patient it has a camera and conferencing ability to a remote doctor can examine the patient and talk to people around the patient to ask them questions or give them instructions. It also could contain one of those “foolproof defibrillator” modules able to deal with many kinds of heart attacks. They are already in many buildings but this way they could be anywhere. It’s more useful than a taco.

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %HEADLINESPLUGIN_SHORTDESCRIPTION%. Note: Don't modify the settings here; copy and customize the settings in Main.TWikiPreferences. For example, to customize the USERAGENTNAME setting, create a HEADLINESPLUGIN_USERAGENTNAME setting in Main.TWikiPreferences.

• One line description, shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Show headline news in TWiki pages based on RSS and ATOM news feeds from external sites

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

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

• Use LWP::UserAgent, or fallback to TWiki's internal getUrl() method. Default: yes
  • Set USELWPUSERAGENT = yes

• Timeout fetching a feed using the LWP::UserAgent. Default: 20
  • Set USERAGENTTIMEOUT = 20

• Name of user agent. Default: TWikiHeadlinesPlugin/2.21

      * Set USERAGENTNAME = TWikiHeadlinesPlugin/2.21

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

      * Set HEADER = <div class="headlinesChannel"><div class="headlinesLogo"><img src="$imageurl" alt="$imagetitle" border="0" />%BR%</div><div class="headlinesTitle">$n---+!! <a href="$link">$title</a></div><div class="headlinesDate">$date</div><div class="headlinesDescription">$description</div><div class="headlinesRight">$rights</div></div>

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

      * Set FORMAT = <div class="headlinesArticle"><div class="headlinesTitle"><a href="$link">$title</a></div>$n<span class="headlinesDate">$date</span> <span class="headlinesCreator"> $creator</span> <span class="headlinesSubject"> $subject </span>$n<div class="headlinesText"> $description</div></div>

• Values taken from configure: (only supported if CPAN:LWP is installed)
  • $TWiki::cfg{PROXY}{HOST} - proxy host, such as "proxy.example.com";
  • $TWiki::cfg{PROXY}{PORT} - proxy port, such as "8080";
  • $TWiki::cfg{PROXY}{SkipProxyForDomains} - domains excluded from proxy, such as "intra.example.com, bugs.example.com";

Style Sheets

The default HEADER and FORMAT settings use the following styles. See the style.css file defining the default CSS properties (indentation illustrates enclosure).

• headlinesRss: output of the HeadlinesPlugin (div)
  • headlinesChannel: channel header (div)
    • headlinesLogo: channel logo (div)
    • headlinesTitle: channel title (div)
    • headlinesDate: channel date (div)
    • headlinesDescription: channel description (div)
    • headlinesRight: channel copyright (div)
  • headlinesArticle: one news item (div)
    • headlinesTitle: article title (div)
    • headlinesDate: article date (span)
    • headlinesCreator: author of article (span)
    • headlinesSubject: subect category of the article (span)
    • headlinesText: article text (div)

Plugin Installation Instructions

• Download the ZIP file.
• Unzip it in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/HeadlinesPlugin.txt	plugin topic
  pub/TWiki/HeadlinesPlugin/style.css	default css
  lib/TWiki/HeadlinesPlugin.pm	plugin perl module
  lib/TWiki/HeadlinesPlugin/Core.pm	plugin core

  Check if above examples show a news feed instead of variable.
• Optionally, run HeadlinesPlugin_installer.pl to automatically check and install other TWiki modules that this module depends on. You can also do this step manually.
• Alternatively, manually make sure the dependencies listed in the table below are resolved.

  Name	Version	Description
  Digest::MD5	>=2.33	Required. Download from CPAN:Digest::MD5
  LWP::UserAgent	>=5.803	Optional. Download from CPAN:LWP::UserAgent

Plugin Info

Related Topics: TWikiPlugins, AdminDocumentationCategory, TWikiPreferences