Headlines Plugin

Show headline news in TWiki pages based on RSS and ATOM news feeds from external sites


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


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
touch="..." Touch (edit/save) topics if the feed has updates. Specify a comma-space delimited list of TopicNames or Web.TopicNames, such as "%TOPIC%, NewsLetter". Useful to send out newsletter using MailerContrib, showing new feeds since last newsletter. To update feeds, visit topics with feeds in regular intervals (using cron with wget or the like). N/A
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


%HEADLINES{ "http://slashdot.org/slashdot.rdf" 
  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="2" }%

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

Fri, 02 Oct 2015 15:17:12 +0000
The original blog about business opportunities and business ideas for small business entrepreneurs
Fri, 02 Oct 2015 15:17:12 +0000 Erin Eagan

If you're a female entrepreneur looking for a new business opportunity, you've definitely come to the right place. Congratulations, you’ve taken your first step towards success!

Women are rightly taking their place among franchise ownership, owning 25% of today’s franchises. As that number continues to climb, more and more franchisors are specifically targeting franchises for women, just like you, to take the helm.


As you consider launching your own business, here are a few of the best franchises for women that we suggest looking into. Whether a seasoned professional, or a ‘mompreneur’ looking for a home-based business to earn a little income, there’s something for everyone.

Gigi's Cupcakes

Gigi’s Cupcakes is the largest and fastest growing franchise bakery system in the United States. Previous baking experience is not necessary for franchisees. Instead, Gigi's Cupcakes looks to work with franchisees who have retail experience and are excited to get involved in the cupcake business. Gigi's desserts are cooked with fresh ingredients each morning. Gigi's Cupcakes changes its menu each day so customers can discover new, exciting flavors on a regular basis.


Growing quickly among franchises for women, BeBalanced is an innovative natural hormone balancing weight loss program that has helped thousands of women. BeBalanced Centers are the only franchise to provide solutions that directly address the problem for women (age 35+) struggling to lose stubborn weight and deal with other hormonal issues, like insomnia, hot flashes, and anxiety. An owner of a BeBalanced Hormone Weight Loss Center, you can be proud to offer a program on the cutting edge of natural health, which deeply impacts the lives of women.

Kumon Math and Reading Centers

A Kumon franchise gives you a proven and scientifically structured program that provides math and reading instruction to young children. The goal is to help each student with the basics of math and reading comprehension and to equip them with a joy for learning. Such a franchise is perfect for a mother who has school-aged children, as she can take care of administrative tasks in the morning, and then monitor the tutoring site in the afternoons.


With an ever-growing demand for quality math instruction, Mathnasium Learning Centers has become one of the fastest-growing educational franchises for women in the world. Mathnasium offers highly effective and fun mathematics instruction for children and is the perfect franchise for women seeking a meaningful business opportunity. Their specially designed, proprietary Mathnasium Method, derived from more than 35 years of research and development, helps math make sense to kids. When math makes sense, their grades improve, excitement grows and the doors of educational opportunity open! There are now more than 450 locations worldwide, with two new centers opening each week.

Blossoms Fresh Fruit

Headquartered in Canada, Blossoms Fresh Fruit Arrangements provides a healthy and fresh alternative in gift giving, nourishing and delighting everyone they serve with healthy lifestyle choices. Blossom's fruit arrangements are great for every occasion, holidays, get well, birthdays, sympathy arrangements, Mother's Day and are a favorite on Valentines day.

Snap Fitness

A Snap Fitness franchise is designed to be a clean, no-frills type of fitness center with modern exercise equipment, but without the major expense of a more traditional full-service club. Customers are granted around the clock access to the facility, which is located in a convenient neighborhood building, making it extremely easy to get to. This is one of the best franchises for women who want to be home early enough each day to spend that quality time they crave with their family.

Bark Busters

For the dog lovers out there, this is a great franchise that was actually started in Australia back in 1989. The business is focused on home dog training, so it provides women with a flexible schedule that can integrate well within the context of their existing lifestyle.

Drama Kids International

This is a franchise that is made for any woman who has a passion for working with children and also has a strong desire to be an entrepreneur. Drama Kids is designed to be an after-school theater program that enables kids learn various creative type games and activities that teach real-life lessons while also promoting the arts. Women enjoy running this franchise because of the limited hours it requires away from the home, and the added possibility of bringing their children along with them to the 'office.'

Apricot Lane Boutique

Founded in 2007, Apricot Lane Boutique is one of the only specialty retail franchises for women offering branded fashion apparel, jewelry, handbags, accessories and gifts in unique styles and fast fashion arrivals customers look for. It's the kind of brand that appeals to consumers but also to those mothers and daughters looking to get involved from the business ownership side as well.

Painting with a Twist

Since 2007, Painting with a Twist has been providing art-filled fun for guests young and old. They're ranked the #1 franchise in the paint and sip category for a reason-from their stellar corporate support team to our innovative technologies and processes. In just five years, Painting with a Twist, along with its 236 franchise locations, has produced and owns the copyright to over 3,500 pieces of art.


MassageLuXe is a fast-growing massage company providing massage services to clients, primarily through national area developers multi- unit and single-unit franchises. Our spa revenue is driven by a membership revenue model that assures a significantly higher level of consistency than other spa revenues and profit on a year-round basis. The MassageLuXe concept was designed to achieve and deliver the highest standard in the massage membership business. MassageLuXe is focused on being the leading provider of massage services to clients in every marketplace where they open spas. Their mission is to deliver the highest quality massage while providing a comfortable, relaxing and luxurious environment to our clients.


Led by Lisa Druxman, a recognized expert in the field of fitness and health for moms, FIT4MOM is the largest fitness program for moms as well as one of the fastest-growing franchises for women in the nation. FIT4MOM is the fitness franchise that offers Fit4Baby, Stroller Strides and Body Back. With three different franchise models, they make it easy for you to start a business that works for your lifestyle.

Lil' Angels Photography

Formed in 1998, Lil' Angels LLC takes portraits of thousands of children from infancy through school age each year. Their franchise owners provide services in venues like schools, child care centers and pre-schools, and on occasions such as sporting events, cheerleading events, dance festivals, fairs and more - anywhere that families come together to celebrate or just have fun. As a Lil’ Angels franchise owner, you will receive complete training, including field training, brand new professional photography equipment, a brand new laptop loaded with several pro software packages and unending support from our corporate team and our network of franchise owners.

EcoMaids Green Cleaning Services

For women who desire to operate a franchise that incorporates environmentally friendly business concepts into their operating structure, this is a great opportunity that should be explored. This is a cleaning oriented business that takes a fresh approach to the industry. EcoMaids uses only safe and all-natural cleaning solutions that are biodegradable. The franchise can easily be run from home, and as it grows the owner can focus more on marketing and scheduling of staff, freeing up time with the family.

Sharkey's Cuts for Kids

Take control of your future with a proven business and turn your dreams into reality with Sharkey’s Cuts for Kids. They are the fastest-growing chain of children’s hair salons in the United States, Europe and Canada, and they are seeking enthusiastic entrepreneurs to join the family. You don’t need to be a licensed cosmetologist or have previous hair-care experience to become a Sharkey’s Cuts for Kids franchisee. The most important requirements are a great attitude and work ethic; a passion for interaction; a willingness to listen, learn and lead; and a desire to make your Sharkey’s Cuts for Kids salon the very best it can be, each and every day.


Fri, 02 Oct 2015 14:06:09 +0000 Erin Eagan

MobileStamp is a type of loyalty business that can be run from home and is becoming extremely popular today. The business itself is completely turn-key, meaning that the parent organization will turn over everything that you need to begin and successfully run your own loyalty-based company.


Being affiliated with MobileStamp means that you will keep 100% of all the sales, in exchange for giving the company a small monthly fee to be a reseller. They also promote that they offer a cutting-edge product that nobody else comes close to matching on the market today. Finally, the opportunity is open to anyone, as there is no experience necessary. You can learn everything as you go, and there is not much financial risk involved. Let's look at a few more of the particulars for MobileStamp.

You Develop Your Own Brand - You will develop and create a business website with your name, so you will not be using MobileStamp's name on anything. This provides new owners with a way to establish their brand right away.

You Will Have A Sales Website - The organization will set up a website for you. It will include all of the videos, an overview of the loyalty program itself, pricing of the products and much more. This saves you a great deal of time, as developing your website is either extremely labor intensive, or extremely expensive. Neither of those is the case with MobileStamp.

Customer Videos Provided - Creating your own professional video is time-consuming, not to mention many people are camera shy. MobileStamp takes care of this for you. They provide you with a professional video that will wow your customers. Again, the MobileStamp brand will not be on the video, so you are able to promote your image with ease.

Sales Training Provided - Even if you have no experience in the industry, MobileStamp will provide with the tools that you need to successfully sell the product. They also offer regular webinars that will keep you updated on the latest trends in the industry.

Marketing Material - To help you in promoting your business, MobileStamp provides flyers, videos, PowerPoint presentations and much more to successfully engage potential prospects and turn them into customers.

Phone and Email Support Provided - MobileStamp will not leave you on your own. They are there to help you as needed via either telephone or email support. This ensures that you can get the answers that you need when you need them.

Set Up Your Own Pricing Plans - You are not bound by any price that MobileStamp recommends. You are in control of the all of the plans, and you set the pricing. All MobileStamp receives is a small fee on a monthly basis to license the platform.


This is certainly a business that can run from home and requires minimum startup cost. If you are comfortable promoting a business from scratch and engaging prospects, this could be one to consider.


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-2010, Peter Thoeny, Twiki, Inc.; 2005-2007, Michael Daum http://wikiring.de
License: GPL (GNU General Public License)
Plugin Version: v2.6 - 2010-05-16
Change History:  
2010-05-16: TWikibug:Item6433 - more doc improvements
2010-04-25: TWikibug:Item6433 - doc fix: Changing TWIKIWEB to SYSTEMWEB
2010-02-27: TWikibug:Item6313 - fixed bug in ATOM feed with <link ...></link> instead of <link ... /> -- Peter Thoeny
2009-09-30: fixed bug in lastBuildDate of feeds affecting touch parameter functionality -- Peter Thoeny
2009-08-29: added touch parameter -- Peter Thoeny
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: http://TWiki.org/cgi-bin/view/Plugins/HeadlinesPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/HeadlinesPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/HeadlinesPluginAppraisal

Related Topics: TWikiPlugins, AdminDocumentationCategory, TWikiPreferences

Topic revision: r1 - 2010-05-17 - TWikiContributor
This site is powered by the TWiki collaboration platformCopyright © 1999-2015 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.