How to Import and Display RSS Feeds in WordPress • Perishable Press Page 1 of 25 Perishable Press Import and Display RSS Feeds in WordPress Published Sunday, April 26, 2009 @ 2:35 pm • 53 Responses 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. On the menu for this tutorial: • Importing and displaying feeds with WordPress & Magpie (simple method) • Importing and displaying feeds with WordPress & Magpie (advanced method) • Importing and displaying feeds with SimplePie (WordPress not required) Sound good? Let’s get to it.. Importing and displaying feeds with WordPress & Magpie (simple 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. Importing and displaying 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/customized output 9/4/2009 How to Import and Display RSS Feeds in WordPress • Perishable Press Page 2 of 25 Each of these functions uses the Snoopy HTTP client for feed retreival, Magpie for feed parsing, and RSSCache for automatic feed caching. 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 your 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)) : ?> 9/4/2009 How to Import and Display RSS Feeds in WordPress • Perishable Press Page 3 of 25 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 sure that it’s 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 9/4/2009 How to Import and Display RSS Feeds in WordPress • Perishable Press Page 4 of 25 <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 scrip $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(); ?> <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(); ?> <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.