Spring Sale! Save 30% on all books w/ code: PLANET24
Web Dev + WordPress + Security

Import and Display RSS Feeds in WordPress

Importing and displaying external RSS feeds on your site is a great way to share your online activity with your visitors. If you are active on Flickr, Delicious, Twitter, or Tumblr, your visitors will enjoy staying current with your updates. Many social media sites provide exclusive feeds for user-generated content that may be imported and displayed on virtually any web page. In this article, you will learn three ways to import and display feed content on your WordPress-powered website — without installing yet another plugin.

Update: This article applies to older versions of WordPress (less than 2.8). For WordPress 2.8 and better, check out this post at Digging Into WordPress.

On the menu for this tutorial:

  • Import and display feeds with WordPress & Magpie (basic method)
  • Import and display feeds with WordPress & Magpie (advanced method)
  • Import and display feeds with SimplePie (WordPress not required)

Sound good? Let’s get to it..

Import and display feeds with WordPress & Magpie (basic method)

If you only need to display the titles of a feed, you can take advantage of the built-in WordPress function, wp_rss(), which provides WordPress with essential feed-fetching and feed-parsing functionality. All you need to do is place the following code into the desired display location within your theme template file (e.g., sidebar.php):

<?php include_once(ABSPATH.WPINC.'/rss.php');
wp_rss('http://domain.tld/your-feed/', 7); ?>

In the first line, we include the required wp_rss() function from the rss.php file (rss-functions.php in older versions of WordPress). In the second line, we specify two parameters: the first is our feed URL and the second is the number of titles to display. Simply edit these two parameters and enjoy the results.

Import and display feeds with WordPress & Magpie (advanced method)

Magpie provides an XML-based RSS built with PHP. WordPress uses Magpie to parse RSS and Atom feeds and display them on your website. Magpie parses feeds for two different WordPress functions:

  • wp_rss() – fetches and parses feeds for instant/automatic output
  • fetch_rss() – fetches and parses feeds for advanced/custom output

Each of these functions uses the Snoopy HTTP client for feed retrieval, Magpie for feed parsing, and RSSCache for automatic feed caching. Feel free to change those up however with other services, scripts, etc.

The wp_rss() function fetches and parses feed content and then outputs an unordered list containing each of the feed’s post titles (see previous section). The fetch_rss() also fetches and parses feed content and will output the results according to your specific script configuration. Instead of just spitting out titles, the fetch_rss() function enables us to display any available feed data in customized format. Let’s look at an example.

<?php
include_once(ABSPATH.WPINC.'/rss.php'); // path to include script
$feed = fetch_rss('http://domain.tld/your-feed/'); // specify feed url
$items = array_slice($feed->items, 0, 7); // specify first and last item
?>

<?php if (!empty($items)) : ?>
<?php foreach ($items as $item) : ?>

<h2><a href="<?php echo $item['link']; ?>"><?php echo $item['title']; ?></a></h2>
<p><?php echo $item['description']; ?></p>

<?php endforeach; ?>
<?php endif; ?>

Once placed in the desired location in your WordPress theme template file, the previous code will output the title and description (content) of the seven most recent feed items. Simply edit the three variables in the first three lines of the script and you are good to go. Then, once you see that everything is working as intended, feel free to modify the markup as you see fit. Before moving on, let’s walk through the method in sequential fashion:

  • Include the script – specify the path to rss.php (or rss-functions.php in older versions of WordPress)
  • Specify feed URL – specify the URL of the feed you would like to display
  • Limit number of items – edit the two numbers to reflect the numbers of the first and last feed items, respectively
  • Empty check – before running the loop, check that the feed isn’t empty
  • Begin the loop – begin the standard foreach loop
  • Display the items – for each feed item, display the post title, title link, and post content
  • Wrap it up – close the loop and end the empty check

Notes on using WordPress/Magpie

If you are calling feeds that may or may not include a description, you may want to avoid the output of empty paragraph elements ( <p> ) by wrapping the description with a conditional check like so:

<?php if (isset($item['description'])) : ?>
<p><?php echo $item['description']; ?></p>
<?php endif; ?>

Also, if the feed isn’t showing, try replacing the associated line with this:

$feed = @fetch_rss('http://domain.tld/your-feed/');

For an alternate way of checking for the presence of a working feed, replace the empty check with this:

<?php if (isset($rss->items) && 0 != count($rss->items)) : ?>

You can also clean up feed output by taking adavantage of WordPress’ built-in filtering functionality:

<?php echo wp_filter_kses($item['link']); ?>
<?php echo wp_specialchars($item['title']); ?>

Here are some of the variables that are available from your feeds (not sure if all of these work):

  • $item['link'] – post permalink
  • $item['title'] – title of the post
  • $item['pubdate'] – post publication date
  • $item['description'] – post excerpt or content
  • $item['creator'] – post author (does this work?)
  • $item['content'] – post content (does this work?)

Note that when using the $item['pubdate'] variable, the default output will look like this:

Mon, 11 Jul 2050 01:11:11 +0000

Fortunately we can clean this up a little bit by parsing it with PHP’s substr() function like so:

$pubdate = substr($item['pubdate'], 0, 16);

Which will output the following date format:

Mon, 11 Jul 2050

And, finally, an alternate loop format that defines the number of items to display without using the array_slice() function:

<?php for($i = 0; $i < 5; $i++) { $item = $rss->items[$i]; ?>
<!-- loop content -->
<?php } ?>

Importing and displaying feeds with SimplePie (WordPress not required)

For more robust feed fetching in the most simple way possible, SimplePie is the perfect choice. SimplePie is a blazing fast PHP class that is easy to learn and simple to use. With a few quick steps, you can use SimplePie to retrieve and parse any RSS or Atom feeds and display them on any PHP-enabled website (WordPress is not required).

SimplePie works great with its default settings, but it is also highly customizable. You can use SimplePie to display any type of data from any number of feeds, and it even works without WordPress. Sound good? Here’s how to setup SimplePie in three easy steps:

  • Download SimplePie and unzip
  • Place the “simplepie.inc” into a folder named “php” located in the web-accessible root directory of your website
  • Create a folder named “cache” (also in the web-accessible root directory) and make it writable by the server (i.e., CHMOD to 755, 775, or 777)

That’s all there is to it. Once SimplePie is properly setup on your server, you may check that it’s working by uploading the following code to the web page of your choice (edit as specified):

<?php // basic functionality check - edit script path and feed url
include_once $_SERVER['DOCUMENT_ROOT'].'/php/simplepie.inc'; // script path
$feed = new SimplePie('http://domain.tld/your-feed/'); // feed url

<h1><?php echo $feed->get_title(); ?></h1>
<p><?php echo $feed->get_description(); ?></p>

If the feed title and description don’t appear on the page, check the path to simplepie.inc in the first line and also verify that the feed URL is correct and that the feed is working properly.

Once everything is working and flowing like butter, the possibilities are endless. To get you started, let’s expand the previous “testing” code to include the title, link, content and date for the seven most recent feed items:

<?php 
include_once $_SERVER['DOCUMENT_ROOT'].'/php/simplepie.inc'; // path to include script

$feed = new SimplePie(); // bake a new pie
$feed->set_feed_url('http://domain.tld/your-feed/');  // specify feed url
$feed->set_cache_duration (999); // specify cache duration in seconds
$feed->handle_content_type(); // text/html utf-8 character encoding
$check = $feed->init(); // script initialization check
?>

<h1><a href="<?php echo $feed->get_permalink(); ?>"><?php echo $feed->get_title(); ?></a></h1>
<p><?php echo $feed->get_description(); ?></p>

<?php if ($check) : ?>
<?php foreach ($feed->get_items(0, 7) as $item) : ?>

<h2><a href="<?php echo $item->get_permalink(); ?>"><?php echo $item->get_title(); ?></a></h2>
<p><?php echo $item->get_description(); ?></p>
<p><small>Posted on <?php echo $item->get_date('j F Y @ g:i a'); ?></small></p>

<?php endforeach; ?>
<?php else : ?>

<h2>Feeds currently not available</h2>
<p>Please try again later</p>

<?php endif; ?>

That is the code I start with when implementing SimplePie on client projects. It serves as an easy-to-customize template that incorporates plenty of functionality and outputs feed content in common format. Let’s walk sequentially through the code for better understanding of functionality and proper use.

Setting the variables

  1. Path to the SimplePie script – edit according to your specific setup
  2. new SimplePie – setup a new instance of SimplePie feed variable
  3. Feed URL – specify the URL of the feed you would like to display
  4. Cache duration – specify how long the feed should be cached (seconds)
  5. Character encoding – ensures that content is in text/html, UTF-8 format
  6. Script check – sets a variable upon successful script initialization

Format the output

  1. Feed title and link – wrapped in <h1> tags and placed before the loop because only one title exists for each feed
  2. Feed description – wrapped up in paragraph tags and placed before the loop because only one description exists for each feed
  3. Initialization check – if the $check variable is set, then continue processing the script
  4. Begin the loop – standard foreach loop with parameterized argument for setting the number of feed items to display
  5. Feed items – for each feed item, display the post title, title link, post content, and post date.
  6. End the loop – terminate the recursive processing of feed items
  7. Else condition – if the $check variable is not set, then display the following code
  8. Else message – text/markup to display if the initialization check fails and the feed is not displayed
  9. End the if condition – conclude the script by terminating the if condition

Notes on SimplePie
It is possible to merge feeds into a single stream by replacing the associated lines with the following:

<?php 
$feed = new SimplePie();
$feed->set_feed_url(array(
	'http://domain.tld/your-feed-01/', 
	'http://domain.tld/your-feed-02/', 
	'http://domain.tld/your-feed-03/'
	));
?>

Also, you can truncate the number of words that appear in the content of each feed item by using PHP’s substr() function:

<?php echo substr($item->get_description(), 0, 180); ?>

In the foreach() loop, you may specify the number of the first and last feed to process by editing the “0” and “7” in the following line:

<?php foreach ($feed->get_items(0, 7) as $item) : ?>

For WordPress users who would rather not mess with all of the “under-the-hood” code stuff, there is an awesome SimplePie plugin that automates just about everything. It should be noted, however, that the SimplePie plugin consists of two different plugins and requires a significant amount of time and effort in order to implement. It’s a great set of plugins, but I would argue that the manual implementation method is easier.

Finally, keep in mind that your feeds are cached according to either the default setting or your specified cache duration. The default caching duration is one hour, which is suitable for most implementations. Don’t forget that, for caching to work, SimplePie must have write access to the cache directory (see above).

With SimplePie, the options are endless. This tutorial is enough to get you started, but you should check the SimplePie Wiki for more comprehensive documentation.

Feed ’em!

With these versatile, easy-to-use techniques for importing and displaying external feeds, virtually anything is possible. If you are using WordPress, you can take advantage of the built-in Magpie functionality and display feeds quickly and easily. For non-WordPress users or for those seeking more control over the feed importation and display process, you will find all of the flexibility you need with SimplePie. These methods will help you provide more content to your readers and do so without getting locked into using yet another needless plugin. So go forth and feed that insatiable audience of yours! :)

About the Author
Jeff Starr = Web Developer. Book Author. Secretly Important.
Banhammer: Protect your WordPress site against threats.

105 responses to “Import and Display RSS Feeds in WordPress”

  1. SimplePie is in trunk for WordPress 2.8

    It would be good to update this to include what will be available then!

  2. Jeff Starr 2009/04/27 7:09 am

    Yes, I thought about waiting until 2.8, but figured I could just update the article when it is released. I am looking forward to SimplePie and WordPress working together — hopefully it will mean even more flexibility for designers and developers. Cheers!

  3. Nice post! I think it is better for the date you use the function of WordPress for formating the date with the options of the blog:
    $pubdate = date_i18n(get_option('date_format'), $pubdate);
    Best regards
    Frank

  4. Jeff Starr 2009/04/28 9:20 am

    Excellent tip, Frank — thanks! :) The workaround mentioned in the post was a bit insufficient. This looks like it will work much better. Thanks for sharing!

  5. @Jeff: thanks for your answer; a small modification for my tipp:
    $pubDate = date_i18n( get_option('date_format'), strtotime( $item['pubdate'] ) );
    This works fine and the return is a date in the format of the blog-options.

  6. Jeff Starr 2009/04/29 9:21 am

    @Frank: Perfect! Thank you for the follow-up :)

  7. Wow, a really handy tutorial, Jeff! If it weren’t you writing this tutorial, I wouldn’t have found a way how to parse my Digg feed so that I can display it on my blog. I know that WordPress has a function to import a RSS feed, but I have no idea how to process the information contained in it. Your guide saved me from all the need of Googling and piecing together snippets of code from all kinds of webpages, especially for the parsing of the time (pubdate). I have no clue how to change the way it is displayed until you wrote about it.

    I’m considering to install a WP plugin called Lifestream to better manage all my social website activities (mainly Twitter, Digg and Flickr), and it seems to be a nice nifty plugin to try out. Of course, if it all fails, I can always use your failsafe method :)

  8. Thomas Scholz 2009/05/04 10:12 am

    Passing an URL to the SimplePie constructor triggers the automatic modus. Any later configuration attempts will fail. See: http://simplepie.org/wiki/reference/simplepie/start for details.

  9. @teddY: Always good to hear from you! Yes there are tons of great ways to use the feed-importing methods described in this article. There are many configurational options and different ways to use this type of functionality — not just with social media feeds, but with any other type of feed imaginable. I have several blogs to which I regularly publish content, and so having an easy way to import the various feeds makes it easy to display all of my content in one place.

    The Lifestream plugin for WordPress looks pretty cool. I recently discovered Sweetcron (404 link removed 2012/06/26), which is a robust and standalone (& self-hosted) lifestream application. It’s pretty cool — I setup a test site and have been playing around with it, but there is tons of configurational options and stuff you can do with it. I have seen some pretty sweet implementations around the Web. Maybe something to check out! :)

  10. @Thomas Scholz: The article has been updated with the correct information. Thanks!

  11. Jeff,

    Thanks for this! Works perfectly and easily!
    I have, hopefully, a quick question for you though.

    Using WordPress/Magpie advance as listed above:

    What about if i want to pass a variable for the URL….

    Maybe an RSS feed URL listed in the User.

    I have this to echo the user name(s) field value(s) (using a plugin to create a custom field in which i place the url) :

    $values = get_cimyFieldValue(false, 'TWITTERFEEDURL');

           foreach ($values as $value) {
                  $user_id = $value['user_id'];
                  echo $value['user_login'];
                  echo cimy_uef_sanitize_content($value['VALUE']);
           }

    But if instead I wanted to pass the text value of that field into
    $feed = fetch_rss('http://domain.tld/your-feed/');

    How would I do that?
    My attempts have proven my knowledge lacking ;)

  12. Jeff Starr 2009/05/12 3:59 pm

    @davis: Ugh! I wish I could help but unfortunately that exceeds my limits of knowledge on the topic as well. Very soon, WordPress 2.8 will be released and will be using SimplePie instead of Magpie. Perhaps this will provide enable you to get the help you need via the actively moderated SimplePie help forum..?

Comments are closed for this post. Something to add? Let me know.
Welcome
Perishable Press is operated by Jeff Starr, a professional web developer and book author with two decades of experience. Here you will find posts about web development, WordPress, security, and more »
BBQ Pro: The fastest firewall to protect your WordPress.
Thoughts
I live right next door to the absolute loudest car in town. And the owner loves to drive it.
8G Firewall now out of beta testing, ready for use on production sites.
It's all about that ad revenue baby.
Note to self: encrypting 500 GB of data on my iMac takes around 8 hours.
Getting back into things after a bit of a break. Currently 7° F outside. Chillz.
2024 is going to make 2020 look like a vacation. Prepare accordingly.
First snow of the year :)
Newsletter
Get news, updates, deals & tips via email.
Email kept private. Easy unsubscribe anytime.