Skip to main content

Generating XML Feeds (RSS, Atom) Using PHP

RSS/ATOM feeds are very common these days and almost all Content Management Systems (CMS) can generate it. But in the case when you want to generate it yourself or just want to learn how you can, read on!

Both RSS and ATOM feeds are written in eXtensible Markup Language (XML) standard markup. Not just standard markups, you also need to be sure of what and how you put data in those markup elements (tags). For all this refer to the feed specifications of RSS and ATOM. XML itself is very strict and the standard specifications makes it even harder to generate valid feeds. And moreover, why re-invent the wheel when we can have it – ready-made.

The solution I'm referring to here is, to use a third-party Library – Universal FeedWriter. FeedWriter is a PHP class written by Anis uddin Ahmad that can dramatically  ease-off feeds (both RSS and Atom) generation. You can download this library from here.

Every feed should have at least the following data:

  1. Feed title
  2. URL(of the website whose feed is it)
  3. Description
  4. Item
    1. Title
    2. Date
    3. URL (of the item, sometimes called permalink)
    4. Description (body of the item)

The RSS feed for this will look something like:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:wfw="http://wellformedweb.org/CommentAPI/">

<channel>
<title>RSS Title</title>
<link>URL of Website</link>
<description><![CDATA[Description]]></description>
<language>en-us</language>
<pubDate>Sat, 07 Mar 2009 06:55:15 +0530</pubDate>

<item>
<title>Item Title</title>
<link>Item URL (Permalink)</link>
<pubDate>Sat, 07 Mar 2009 06:55:15 +0530</pubDate>
<description><![CDATA[Item Description]]></description>
</item>
</channel>
</rss>

Using FeddWriter abstracts working with and generating XML tags manually, you just tell FeedWriter what kind of Feed (RSS/Atom and version) you want; give it the data you want your feed to have and you’re done! The following code snippet shows you how exactly:

<?php
// Include the class
include("FeedWriter.php");

// Creating an instance of FeedWriter class.
// The parameter tell what type of
// feed you want.
$MyFeed = new FeedWriter(RSS2);

// Setting feed elements
$MyFeed->setTitle('My RSS Feed');
$MyFeed->setLink('http://www.example.com');
$MyFeed->setDescription('Test feed generated by Universal FeedWriter.');
$MyFeed->setChannelElement('pubDate'date(DATE_RSStime()));

// Create a FeedItem.
$Item $MyFeed->createNewItem();

// Add elements to the feed item.
$Item->setTitle('Item Title');
$Item->setLink('http://www.example.com/item1.html');
$Item->setDate(mktime(10,20,0,3,6,2008));
$Item->setDescription('Item Description. Can contain <b>HTML</b>.');

// Now add the item to the feed.
$MyFeed->addItem($Item);

// Now genarate the feed.
$MyFeed->genarateFeed();
?>

So you see how easy it is to generate a feed with the data we had.

Feeds generally don’t just have one item so let’s see something more real. The following code will generate a feed having ten items:

<?php
include("FeedWriter.php");

$MyFeed = new FeedWriter(RSS2);

$MyFeed->setTitle('My RSS Feed');
$MyFeed->setLink('http://www.example.com');
$MyFeed->setDescription('Test feed having Ten Items.');

$time mktime(10100352009);
$MyFeed->setChannelElement('pubDate'date(DATE_RSS$time));

for(
$i=0$i<10$i++)
{
    
$Item $MyFeed->createNewItem();

    
$Item->setTitle('Item' . ($i 1) . ' Title');
    
$Item->setLink('http://www.example.com/item' . ($i 1) . '.html');
    
// Have different dates for each item
    // Each will have one day gap for the
    // publishing time
    
$Item->setDate($time - ($i * (24 * (60 60))));
    
$Item->setDescription('Item ' . ($i+1) . ' Description.');

    
$MyFeed->addItem($Item);
}

$MyFeed->genarateFeed();
?>

One thing to note here is why we are using the feed’s generation time to be same as  that of the latest item rather than the current time when it is generated well, it’s because the feed gets updated only as and when new items are added (remains same at other time) and at the very same time. Therefore just because the feed is being generated dynamically at each request doesn’t mean it is “generate” at that time.

Popular posts from this blog

Fix For Toshiba Satellite "RTC Battery is Low" Error (with Pictures)

RTC Battery is Low Error on a Toshiba Satellite laptop "RTC Battery is Low..." An error message flashing while you try to boot your laptop is enough to panic many people. But worry not! "RTC Battery" stands for Real-Time Clock battery which almost all laptops and PCs have on their motherboard to power the clock and sometimes to also keep the CMOS settings from getting erased while the system is switched off.  It is not uncommon for these batteries to last for years before requiring a replacement as the clock consumes very less power. And contrary to what some people tell you - they are not rechargeable or getting charged while your computer or laptop is running. In this article, we'll learn everything about RTC batteries and how to fix the error on your Toshiba Satellite laptop. What is an RTC Battery? RTC or CMOS batteries are small coin-shaped lithium batteries with a 3-volts output. Most laptops use

The Best Way(s) to Comment out PHP/HTML Code

PHP supports various styles of comments. Please check the following example: <?php // Single line comment code (); # Single line Comment code2 (); /* Multi Line comment code(); The code inside doesn't run */ // /* This doesn NOT start a multi-line comment block /* Multi line comment block The following line still ends the multi-line comment block //*/ The " # " comment style, though, is rarely used. Do note, in the example, that anything (even a multi-block comment /* ) after a " // " or " # " is a comment, and /* */ around any single-line comment overrides it. This information will come in handy when we learn about some neat tricks next. Comment out PHP Code Blocks Check the following code <?php //* Toggle line if ( 1 ) {      // } else {      // } //*/ //* Toggle line if ( 2 ) {      // } else {      // } //*/ Now see how easy it is to toggle a part of PHP code by just removing or adding a single " / " from th

Introduction to Operator Overloading in C++

a1 = a2 + a3; The above operation is valid, as you know if a1, a2 and a3 are instances of in-built Data Types . But what if those are, say objects of a Class ; is the operation valid? Yes, it is, if you overload the ‘+’ Operator in the class, to which a1, a2 and a3 belong. Operator overloading is used to give special meaning to the commonly used operators (such as +, -, * etc.) with respect to a class. By overloading operators, we can control or define how an operator should operate on data with respect to a class. Operators are overloaded in C++ by creating operator functions either as a member or a s a Friend Function of a class. Since creating member operator functions are easier, we’ll be using that method in this article. As I said operator functions are declared using the following general form: ret-type operator#(arg-list); and then defining it as a normal member function. Here, ret-type is commonly the name of the class itself as the ope