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.
Wizard’s SQL for WordPress: Over 300+ recipes! Check the Demo »

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

  1. Thanks Jeff Starr :)

  2. thanks for the above RSS feed suggestions.

    I have a quick question. Is there a way to screen incoming RSS feeds before publishing on a blog?

    I would like to look at what is coming in before releasing it, similar to posts by contributors to one of our blogs that can be screened before being published.

    Thanks

  3. Ron
    look at a plugin called Feed WordPress http://projects.radgeek.com/feedwordpress

    It allows you to pull a feed into a category which would then allow you to apply normal wordpress publishing rules to it.

  4. thanks I will check it out.

  5. Hey,

    Great tutorial even for me a ‘non-techie’ … i managed to make it work :)
    One issue i have and im hoping you can help.

    When my rss is displayed the the ‘title’ links correctly, however if the ‘description’ also contains a link, the link does not work? it links to my own blog?

    Example:
    i import a link like …

    <a href="http://www. a site .com/subdomain/hello.html" rel="nofollow">hello</a>

    how ever when this link displays in my blog the link looks something like

    <a href="http://www. my blog.com/subdomain/hello.html" rel="nofollow">hello</a>

    Can you show me an example how to fix this?

    Thanks again!

  6. Excellent article. I was searching for these kind of solution to display RSS from the RSS feed. Thanks for sharing it here.

  7. Thanks much for this information, was wondering if you could help me out with something. I’ve implemented the first method and it’s pulling the data from an RSS feed just how I want, except I want the descriptions word count to be a bit shorter… do you know how I would change the word count?

    I’ve tried a few things but can’t seem to decrease the word count.

    Any help is much appreciated.

  8. Well, I’m sure there’s another place within WordPress that I can change the value, but I found a solution that does what I need.

    I was actually using the second method listed on the page.

    But now I’m just passing through $item['description'] through this function: http://vision-media.ca/resources/php/php-word-limit

    However, I am curious to know if there’s a way to do this within wordpress so if anyone has any ideas I’d love to hear ’em.

  9. Jeff Starr 2009/12/20 9:16 am

    Hi michael, I think I covered this in the article, just use this:

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

    You should be able to set 180 to whatever number of words you require.

  10. Oh, I thought that was just for truncating by character and not by word. Will give it a go. Thanks!

  11. Jeff Starr 2009/12/20 5:34 pm

    Ah, yes you are correct — substr() works at the character level; however, on the function’s PHP page, it looks like there are some techniques for counting words as well:

    http://php.net/manual/en/function.substr.php

  12. very interensting and very usefull!

    i have one question…i’m fletching the feed by yahoo pipes, and works fine, but how can I get the link to the site from which each feed? I tryed with some simplepie function but it doesn’t work…

    there is my code:

    <?php
         include_once(ABSPATH . WPINC . '/feed.php');
         $rss = fetch_feed('http://pipes.yahoo.com/pipes/pipe.run?_id=64b9e984517872578eeb5ed99ed6b69c&_render=rss');
         if(!empty($rss)):
         $maxitems = $rss->get_item_quantity(5);
         $rss_items = $rss->get_items(0, $maxitems);
         endif;
         ?>
         <ul class="feed">
              <?php if ($maxitems == 0) echo '<li>No news.</li>';
              else
              foreach ( $rss_items as $item ) : ?>
              <li>
              <?php echo substr($item->get_description(), 0, 180); ?>
              <a href="<?php echo $item->get_permalink(); ?>" rel="bookmark" target="_blank"><?php echo $item->get_title(); ?></a>
              </li>
              <?php endforeach; ?>
         </ul>

    i’m going mad for obtain something like:
    title of the external post – via name of the site

    have u any suggestion?
    thanks a lot and sorry for my bad english!!!:)

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 »
WP Themes In Depth: Build and sell awesome WordPress themes.
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.