Welcome, Registration, and other StartingPoints; Foswiki history & Wiki style; All the docs...
Edit | Attach | New | Raw | Delete | History | Print | Tools
You are here: System » HeadlinesPlugin

Headlines Plugin


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/ ) is a good site listing many RSS feeds.

Syntax Rules


Parameter ExplanationSorted ascending Default
href="..." (Alternative to above) N/A
format Format of one item. Can include these variables:
- $title: news item title (item.title)
- $link: news item link (item.link)
- $description: news item description (item.description)
- $date: the publication date (item.pubDate, item.date)
- $category: the article category (item.category)
Global FORMAT setting
header Header. Can include these variables: - $channeltitle, $title: title of channel (channel.title)
- $channellink, $link: link of channel (channel.link)
- $channeldescription, $description: description (channel.description)
- $channeldate, $date: publication date of the channel (channel.pubDate)
- $rights: copyrights of the channel (channel.copyright)
- $imagetitle: title text for site (image.title)
- $imagelink: link for site (image.link)
- $imageurl: URL of image (image.url)
- $imagedescription: description of image (image.description)
Global HEADER setting
limit="12" Maximum number of items shown Global LIMIT setting
refresh="60" Refresh rate in minutes for caching feed; "0" for no caching Global REFRESH setting
"..." source of RSS feed; this can be an url (starting with http) or a web.topic location for internal feeds None; is required

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>.


Slashdot News


%HEADLINES{"http://slashdot.org/slashdot.rdf" header="---+!! [[$link][$title]]$n $description" format="$t* [[$link][$title]]"}%
to get the latest Slashdot news as a bullet list format:

Business Opportunities Weblog


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

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

Sat, 18 Apr 2015 17:54:44 +0000
The original blog about business opportunities and business ideas for small business entrepreneurs
Sat, 18 Apr 2015 17:54:44 +0000 Dane Carlson

Franchising is one of the safest ways of owning a business and becoming your own boss. It's brand recognition, a trusted product and corporate support. Regardless, always do your research and weigh the pros and cons before jumping into any business venture. We'll get you started with a few pros:

1. You're Following a Proven Business Model

According to the Small Business Association, roughly 50% of businesses don't make it past five years. Businesses fail for a whole slew of reasons. Some of the most common causes of failure include running out of capital, choosing the wrong business partners, a lack of planning and no market need or differentiation. If you aspire to manage your own business but aren't prepared to start with a blank sheet of paper and run the gauntlet of risks involved, you may want to consider franchising. In owning a franchise, you are not only buying a business - you are buying a system that already has a history of success.


2. You Know Exactly What You're Getting

The uncertainty of starting your own business can be an obstacle for aspiring entrepreneurs. Some entrepreneurs are driven by risk, but not everyone is ready to take a leap into the unknown. In franchising, you know exactly what you're getting before you buy. Franchisors are required by the Federal Trade Commission to provide franchisees with certain information, including information about the company's officers, company history, legal history, audited financial reports, the franchise agreement and an up-to-date list of contact information for current franchise owners. Additionally, most established franchises make it easy for you to calculate your potential return on investment. This is a big perk to franchising. With this information available prior to purchasing, you know what to expect.

3. You'll Be Selling an Established Brand

Establishing your company's brand and gaining recognition in the industry is a difficult challenge. You could offer the best product or service, but what does it matter if no one knows about you? When you buy a franchise, you have already cleared one of the biggest hurdles in business. While a strong brand may take years to establish, most franchises already have widespread brand recognition. Having a customer base that is already familiar with your brand is an enormous benefit to owning a franchise.

Fri, 17 Apr 2015 19:47:20 +0000 Dane Carlson

In 2009, when a group of sports competitors were out training in the mountains of Park City, Utah and trying to use an iPhone in minus-20 degrees with much difficulty and pain, the idea for the eGlove was born. Six years later, eGlove is an award-winning leader in touch screen technology gloves for outdoor sports and everyday warmth.

With a wide range of high-end sports gloves for running, cycling, riding, walking, ultras, snowboarding and skiing, eGlove is so passionate about the quality and perfection that every glove is brutally tested before launch to ensure it is warm, providing maximum comfort and delivering total accuracy when using any touchscreen device. With a current product return rate less than 0.5%, you know they are serious about their products.

eGlove is eager to develop partnerships and is open to anything that increases brand awareness and drives higher unit sales.

For more resell information on eGlove, click here.

Fri, 17 Apr 2015 16:25:19 +0000 Dane Carlson

The Internet has changed everything, as you might have noticed if you've not been living underneath a rock for the past decade or so. Because information of all shapes and sizes is so readily available to the average consumer, it's completely changed the nature of the background checking business. Whereas once checking backgrounds required a lot of legwork, now most people can successfully search someone's background from the comfort of their own home.

If you've always secretly wanted to become a spy, then perhaps background screening could be an exciting and rewarding business for you. But how do you get started? Luckily, we've found an excellent opportunity for a budding private sleuth entrepreneur to get started with.

What Does a Background Check Entail?

Although it's incredibly unlikely that you've never had a background check performed on you, it's still possible that you might not know what a background check actually entails. Typically, a background check will be requested for an individual in situations that involve loans, housing, firearms and other high-value or high-risk transactions.

The purpose of these background checks is to establish a history for the person being examined, and depending upon the purpose of the examination, different things will be focused upon. When renting an apartment, for example, a landlord might want to look into a potential tenant's criminal background and credit history. When purchasing a firearm, a background check will look into everything from traffic violations and previous addresses to aliases and credit scores.


In all of these cases, someone needs to actually sit down and do the research - which is where the business opportunity comes in. While the Internet has made much of this information available at the click of a button, most of it is not centralized in one place. For that reason, a qualified person will have to perform the search, which, depending upon the thoroughness of the background check requested, will actually be more akin to comprehensive research than anything else.

A Good Place to Start

If getting into the background checking industry sounds like the right thing for you, then check out the Background Screeners of America. First and foremost, it should be noted that this business is a member of all the major trade organizations in the industry, including notable ones like the Society for Human Resource Management and the National Association of Professional Background Screeners. Because of these credentials, you can be assured that it has an established reputation within its industry.

The prospective entrepreneur will receive comprehensive training on how to accurately and thoroughly conduct background checks. In addition to this, the invested entrepreneur will receive training on how to generate clients and profits. They will also be granted access to Background Screeners of America's staff, who can assist with all of the work required to conduct a background check. With that kind of support, it's easy to see how a motivated entrepreneur can truly make this business work.


Finally, one thing to consider is that it will be a primarily home-based business. Most of the research required to conduct the background checks can be done through the Internet, which means that the prospective entrepreneur will have minimal overhead expenses to factor into the cost. When you combine this with the lack of fees that are assessed by Background Screeners of America on their franchisees, then you have the potential for generating some real profits.

In order to get started with this business opportunity, you'll need to be prepared to make a startup investment of $19,950. That may be a little steep for some, but it's worth it in order to get involved with a business that already has an established reputation within its industry.

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 SitePreferences. For example, to customize the USERAGENTNAME setting, create a HEADLINESPLUGIN_USERAGENTNAME setting in Main.SitePreferences.

  • One line description, shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Show headline news in Foswiki 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 Foswiki's internal getUrl() method. Default: yes

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

  • Name of user agent. Default: FoswikiHeadlinesPlugin/2.21.1
      * Set USERAGENTNAME = FoswikiHeadlinesPlugin/2.21.1

  • 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)
    • $Foswiki::cfg{PROXY}{HOST} - proxy host, such as "proxy.example.com";
    • $Foswiki::cfg{PROXY}{PORT} - proxy port, such as "8080";
    • $Foswiki::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 foswiki installation directory. Content:
    File: Description:
    data/System/HeadlinesPlugin.txt plugin topic
    pub/System/HeadlinesPlugin/style.css default css
    lib/Foswiki/HeadlinesPlugin.pm plugin perl module
    lib/Foswiki/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 Foswiki 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.
    Digest::MD5>=2.33Required. Download from CPAN:Digest::MD5
    LWP::UserAgent>=5.803Optional. Download from CPAN:LWP::UserAgent

Plugin Info

Plugin Author: TWiki:Main.PeterThoeny, Foswiki:Main.MichaelDaum (2005-2007)
Copyright: © 2002-2009, Peter Thoeny, TWIKI.NET; 2005-2007, Michael Daum http://wikiring.de
License: GPL (GNU General Public License)
Plugin Version: 2.21.1 (08 Mar 2009)
Change History:  
08 Mar 2009: Ported without changes to Foswiki namespace by Kenneth Lavrsen and put under "Feel Free To Modify" in Foswiki context.
12 Feb 2009: {PROXY}{HOST} supports domain with and without protocol -- Peter Thoeny
06 Feb 2009: added {PROXY}{SkipProxyForDomains} configure setting, added USERAGENTNAME plugin setting -- Peter Thoeny
11 Dec 2008: added {PROXY}{HOST} and {PROXY}{PORT} configure settings -- Peter Thoeny
13 Sep 2007: fixed parsing of content:encoded
23 Jul 2006: improved atom parser; if a posting has no title default to 'Untitled'
26 Apr 2006: added lazy compilation
10 Feb 2006: packaged using the TWiki:Plugins/BuildContrib; minor fixes
03 Feb 2006: off-by-one: limit="n" returned n+1 articles; make FORMAT and HEADER format strings more robust
23 Jan 2006: released v2.00
05 Dec 2005: internal feed urls must be absolute
02 Dec 2005: added web.topic shorthand for internal feeds
29 Nov 2005: fixed CDATA handling
21 Nov 2005: added ATOM support; extended RSS support; added dublin core support; added content support; optionally using LWP to fetch feeds to follow redirections; corrected CPAN dependencies ; recoding special chars from html integer to entity encoding to increase browser compatibility; added css support; use getWorkArea() if available
11 May 2005: TWiki:Main.WillNorris: added DevelopBranch compatability
31 Oct 2004: Fixed taint issue by TWiki:Main.AdrianWeiler; small performance improvement
29 Oct 2004: Fixed issue of external caching if mod_perl or SpeedyCGI is used
02 Aug 2002: Implemented caching of feeds, thanks to TWiki:Main/RobDuarte
11 Jun 2002: Initial version (V1.000)
Perl Version: 5.008
Plugin Home: http://foswiki.org/Extensions/HeadlinesPlugin
Feedback: http://foswiki.org/Extensions/HeadlinesPluginDev
Copyright © 2015 Atomikos BVBA. Transaction Management for Extreme Transaction Processing and SOA Environments serving ISV, Commercial, OEM and Open Source Markets
Site map RSS ATOM