WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/get rss

Description

Retrieves an RSS feed and parses it, then displays it as a list of links. The get_rss() function only outputs the list items, not the surrounding list tags itself.

Uses the MagpieRSS and RSSCache functions for parsing and automatic caching and the Snoopy HTTP client for the actual retrieval.

Note

A bug in 2.06 prevents this function from working correctly. This bug will likely be fixed in 2.07 or 2.08.

Usage

<?php
require_once(ABSPATH WPINC '/rss-functions.php');
get_rss($uri$num 5);
?> 

Example

The get_rss() function only outputs the list items, not the surrounding list tags itself. So, to get and display an ordered list of 5 links from an existing RSS feed:

<?php 
require_once(ABSPATH WPINC '/rss-functions.php');
echo 
'<ol>';
get_rss('http://example.com/rss/feed/goes/here');
echo 
'</ol>';
?>

Parameters

$uri
(URI) (required) The URI of the RSS feed you want to retrieve. The resulting parsed feed is returned, with the more interesting and useful bits in the items array.
Default: None
$num
(integer) (required) The number of items to display.
Default: None

Output

The output from the above example will look like the following:

<ol>
<li>
<a href='LINK FROM FEED' title='DESCRIPTION FROM FEED'>TITLE FROM FEED</a><br />
</li>
(repeat for number of links specified)
</ol>