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 Explanation Default
"..." source of RSS feed; this can be an url (starting with http) or a web.topic location for internal feeds None; is required
href="..." (Alternative to above) N/A
refresh="60" Refresh rate in minutes for caching feed; "0" for no caching Global REFRESH setting
limit="12" Maximum number of items shown Global LIMIT 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
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

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


  header="*[[$link][$title]]:* $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:

Thu, 02 Jul 2015 18:17:56 +0000
The original blog about business opportunities and business ideas for small business entrepreneurs
Thu, 02 Jul 2015 18:17:56 +0000 Erin Eagan

A fixture in Ocean City, Maryland since 1976, Fractured Prune Doughnuts is a ‘design-your-own doughnut’ franchise with 25 locations in the US and counting.


This specialty shop produces hot and crispy doughnuts and leaves the rest up to the customer, giving them a blank canvas on which to slather the glazes and toppings of their choice. For those unsure of where to start, not to worry. They have over 25 specialty doughnuts to help in the decision-making process.

A 'Virtual Franchise'

The franchise has undergone a transformation, however, since being purchased by now-CEO Dan Brinton in 2013. He spread the doughnut love by opening new franchises across the U.S.

But Brinton has a different way of going about things. This is a franchise without a corporate headquarters, and that's the way Brinton wants it. As a 'virtual franchisor' he believes in a hands-on approach. Instead of running the company behind four walls and a mahogany desk, he travels around the country visiting each and every one of his stores - locations that vary from South Carolina to Maryland to Colorado - and addresses the needs of each individual one.

Are you ‘Prune-Worthy?’

Do you have what it takes? Fractured Prune franchisees need: a passion for the product, an entrepreneurial spirit, good customer service skills, a positive attitude and must be a hard worker.


The total investment required to begin operation of a Fractured Prune varies based upon the site selection and construction scope. The franchise fee for each location is $30,000. Fractured Prune franchisees are required to have a net worth of $500,000 and cash and/or equivalent of $100,000.

For more information on the Fractured Prune franchise, click here.

Thu, 02 Jul 2015 16:23:49 +0000 Erin Eagan

Nick-Anthony Zamucen is leading the charge in the crime and trauma scene cleaning industry. His franchised company, Bio-One Inc., dominates in 36 different states and is growing at a rapid rate. It is the first and only successful crime and trauma scene cleanup franchise.

Nick-Anthony, founder and CEO of Bio-One Inc., has taken his industry knowledge to Hollywood and beyond, teaching and demonstrating proper techniques and creating realistic murder scene setups for several television and movie production shots. He is also a published author, business strategist and an award-winning serial entrepreneur that has had tremendous success in various business ventures.

We recently sat down with Nick-Anthony to discuss his core belief that ''Success breeds success'' and how he has drawn upon his own experiences to create a highly successful franchise with proven results - a perfect 100 percent track record of business owners. All aspiring entrepreneurs should pay close attention to what he has to say - good things come to those who do.

What's special about the franchise?

Bio-One Inc. is the world's first successfully franchised crime and trauma scene cleaning company. Others have tried and failed miserably. A good cleaner doesn't equal a good businessman. Bio-One Inc. coaches entrepreneurs to become successful business owners. We have never had a franchise fail or close once opened. We have a 100 percent track record, that speaks for itself. We focus on helping first and doing the business second. It's got to be more than just money, you need to have purpose.

What is the idea behind the Bio-One Inc. franchise?

Crime and trauma cleaning is such a fragmented industry that before we started the environment had very little to no standards. We wanted to change that, provide a better quality of business owner, a stronger entrepreneur and help people reach their dreams. We don't want just someone with a strong stomach who wants to make a buck at the expense of others.


How does it compare to its competition?

Bio-One Inc. franchises aren't taught to fear or focus too much attention on our competition. We can't control what they do nor how they do it, so it's a waste of valuable time. Most if not all of our competition is mom-and-pop shops that are gone within a year. Rather, Bio-One Inc. franchises are coached to drive their business, put people first and always help where you can. I have a motto, ''The more I help, the more I'm helped.'' I live by that on a daily basis and try to instill that belief and make it a conviction with our franchise owners.

Who benefits from Bio-One Inc.?

More people then you know. Turn on the news for a few minutes, you'll get the idea. We run a very clandestine operation. Our Bio-One Inc. franchises are in and out with the utmost respect and full digression, usually before the general public even knows there was a situation. That's how we coach our franchises and hope that we can assist in that manner.

Where do you see the franchise in five years?

I see Bio-One Inc. continuing to grow, advance our market share and dominate every state. We most likely will begin in the next two years expanding internationally. We've had many requests to do so, we just want to make sure before we do every franchise receives the support our domestic ones do. Support and training is something we take very seriously, and I believe because of those two items, we haven't had anyone fail in our system.

Can you describe a typical day in the life of a franchisee?

When a Bio-One Inc. franchise starts their day, they always have a marketing mindset. The only reason they wouldn't is if they're on a job helping someone in their greatest time of need. If they're not on a job, they're meeting with local municipalities, fire stations, care facilities etc. They are always coached to be on the ground every day working their business.

What's your background?

I've been an entrepreneur most of my life. I've owned restaurants, fitness centers, care homes, investment property etc. I know the mindset of an entrepreneur and what they think on a daily basis. It helps me relate to someone who has been just ''downsized'' from their current position, or deciding to take that leap of faith in themselves, to see what they're worth. I like to coach and council new entrepreneurs. I've walked in their shoes. I can show them the way, if they want to be shown.

What motivates you to keep going?

I live to help people. I try to do so in every facet of my life, whether it's my church, my community or our franchisees. The more I help, the more I'm helped. It's a great way to live.

If you were to start again, what would you do differently?

I would not have always looked for what I thought was the perfect Bio-One Inc. franchise. I've taken, what I felt at the times, was a gamble on some people. They really have shown me that with the right attitude, the proper coaching and counseling, and the belief in yourself, great things can happen. I thank them for that and applaud their success.

Please tell us your secret to success&hellip

Success breeds success. I believe success large or small leaves clues. When you see a clue, follow it, see where it takes you. Believe in yourself and those around you and success will come to the surface&hellip with ample amounts of hard work of course. Success isn't easy, but it's worth it.

What is the worst job you have ever had and what did you learn from it?

I washed cars at a car lot when I was 14. I learned that it rains most days you wash a car. It's incredible.

What is one thing that really excites you?

Seeing the anxiety and enthusiasm of a new entrepreneur. You can almost smell it on them. It's intoxicating. It gives me a rush to know we're on the verge of changing their life. It's a great feeling.

Any final words for aspiring entrepreneurs?

If you're going to make that leap and find out how much you're worth do it 100 percent. No tiptoeing, jump in and go for it. You have to have the mindset that, someone is out there, out working you and trying to take your money. Don't let them. Fight harder, be smarter and create the life you've always dreamt about. Fear isn't real, danger is, but fear is something you make up in your head because the demons of self-doubt get to you. Control them and be the person you were meant to be. We only have one shot at this, so let's make your life worth living. I believe in you.

Where can people find out more about Bio-One, Inc.?

Visit the website here.

Where can people find Bio-One, Inc. on social media?


Thu, 02 Jul 2015 13:58:29 +0000 Erin Eagan

Depending upon your work history, you may or may not have a great deal of experience evaluating resumes. Regardless, it's important to note that the people you hire to work in your franchise are representing you. Also, having the right people on board when you first open is incredibly critical to your long-term success.


Hiring for your franchise, as with any other business, begins with combing through resumes. Therefore, we thought we'd provide a refresher course on the things you should look out for when evaluating them. These signs will help you weed down the number of applicants and will hopefully put you in touch with the most qualified job seekers.

1. Bad Speeling and Not Good Grammar

Even though you don't need Marcel Proust to man the cash register at your franchise, poor spelling and grammar on a resume are signs that the applicant doesn't care. The English language may not be that applicant's forte, but he or she must certainly be aware of the importance of proofreading (or having someone else proofread) such an important document.

2. Irrelevant Work History

This is another warning sign that speaks to an applicant's level of care. While job seekers typically send out resumes by the tens these days, those resumes should be tailored to the position being applied for. If it's not, then it just shows that the applicant is throwing spaghetti at the wall to see if it will stick. Is that the kind of person you want on your team?

3. Being Overqualified

To a certain extent, this one may not matter for your purposes. In most cases, though, it should. While an applicant may have perfectly valid reasons for applying to a position for which he or she is overqualified, you probably don't want to gamble on that. Ultimately, that person may just be using your position as a placeholder until something else comes along, and that means you're going to have to make the investment in hiring for the position again sooner rather than later.

4. Gaps in Employment

Again, this may be another circumstance where there is a perfectly reasonable and understandable explanation, but do you want to waste your time getting that explanation? More often than not, lengthy gaps in employment are a sign that someone is either unmotivated or doesn't know what he or she wants out of life. When you're building your franchise's team, especially at the beginning, these people can be poison.

5. Job Hopping

Alongside gaps in employment, there's job-hopping. In this instance, the applicant may very well be perfectly motivated - he or she has maintained steady employment, after all - but you can be almost certain that the applicant has no idea what he or she wants. These kinds of applicants could be perfect for seasonal work, but never consider them as people that could be a part of your core team.


Use Your Best Judgment

If you're new to resumes and hiring, then make it a point to be as engaged in the process as possible. It's the only way you'll ever get a feel for it, and over time, you'll be able to read the tea leaves of any given applicant's resume. This will ultimately allow you to develop sound hiring judgment, which will serve you well over the course of your franchising career.

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

  • Timeout fetching a feed using the LWP::UserAgent. Default: 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.
    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, TWiki:Main.MichaelDaum
Copyright: © 2002-2009, Peter Thoeny, TWIKI.NET; 2005-2007, Michael Daum http://wikiring.de
License: GPL (GNU General Public License)
Plugin Version: v2.21 - 12 Feb 2009
Change History:  
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.8
TWiki:Plugins/Benchmark: GoodStyle 100%, FormattedSearch 99.5%, HeadlinesPlugin 94%
Plugin Home: TWiki:Plugins/HeadlinesPlugin
Feedback: TWiki:Plugins/HeadlinesPluginDev
Appraisal: TWiki:Plugins/HeadlinesPluginAppraisal

-- TWiki:Main.PeterThoeny - 12 Jan 2009
-- TWiki:Main.MichaelDaum - 13 Sep 2007

Topic revision: r1 - 2009-02-13 - 03:55:45 - TWikiContributor
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.HeadlinesPlugin