Klarity is a ready to use PHP script that parses RSS1.0, RSS2.0 and ATOM news feeds and outputs HTML.

Different publishers of news feed make available different types of specialized content in their web sites. Specialized web sites combine the feeds from different publishers into customized news profiles. Users browse the news profiles in specialized web sites and read the news in the publisher web sites.

For such a combination to work, it should be easy for specialized web sites to combine and to represent news feeds. Klarity makes the news integration process easy and it is free.

To use Klarity in your PHP enabled web pages you need to create a object of the Klarity_Class and call showFile(...) with the URL of a news feed:

require('klarity.php');
try
{
	$klarity = new Klarity_Class();
	$klarity.showFile('http://digg.com/rss/index.xml');
}
catch (Exception $e)
{
	// ...
}

Because the news feeds usually contain UTF8 data, it is recommended you use UTF8 encoding in the output HTML file head:

<meta http-equiv="Content-Type"
	content="text/html;charset=utf-8" >

For more details see the reference.

By default, the Klarity output HTML is not styled at all, and it may look not so nice. You can fully customize the output look and feel using CSS. All HTML elements output by Klarity have predefined CSS classes.

<!--  Klarity outputs the following: -->

<div class ="klarity_feed" >
  <div class ="klarity_head" >
    <span class='klarity_head_image_span'>...</span>
    <span class='klarity_head_title_span'>...</span>
  </div>
  <div class ="klarity_content" >
    <div class ="klarity_item" >
      <div class="klarity_item_title" >...</div>
      <div class="klarity_item_description">...</div>
      <div class="klarity_item_date">...</div>
    </div>
    ...
  </div>
  <div class='klarity_powered'>...</div>
</div>

For more details see the reference and the included klarity.css file in the download bundle.

Klarity methods / properties / CSS classes reference:

The complete source code of Klarity and demo files are provided as part of the download.

No support if offered for this script. If you find errors please report them so that they can be fixed in the future releases.