Function Reference/get rss « WordPress Codex

This page redirects to an external site: https://developer.wordpress.org/reference/functions/get_rss/

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists. See also wp-includes/deprecated.php. Use any of these functions instead.

1 Description
2 Usage
3 Parameters
4 Example
5 Output
6 Related

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.

Deprecated note: Switch to using fetch_feed instead.

Usage

<code style="color: #000000"><span style="color: #0000BB"><?php
</span><span style="color: #007700">require_once(</span><span style="color: #0000BB">ABSPATH </span><span style="color: #007700">. </span><span style="color: #0000BB">WPINC </span><span style="color: #007700">. </span><span style="color: #DD0000">'/rss-functions.php'</span><span style="color: #007700">);
</span><span style="color: #0000BB">get_rss</span><span style="color: #007700">(</span><span style="color: #0000BB">$uri</span><span style="color: #007700">, </span><span style="color: #0000BB">$num </span><span style="color: #007700">= </span><span style="color: #0000BB">5</span><span style="color: #007700">);
</span><span style="color: #0000BB">?></span></code>

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) (optional) The number of items to display.

Default: 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:

<code style="color: #000000"><span style="color: #0000BB"><?php 
</span><span style="color: #007700">require_once(</span><span style="color: #0000BB">ABSPATH </span><span style="color: #007700">. </span><span style="color: #0000BB">WPINC </span><span style="color: #007700">. </span><span style="color: #DD0000">'/rss-functions.php'</span><span style="color: #007700">);
echo </span><span style="color: #DD0000">'<ol>'</span><span style="color: #007700">;
</span><span style="color: #0000BB">get_rss</span><span style="color: #007700">(</span><span style="color: #DD0000">'http://example.com/rss/feed/goes/here'</span><span style="color: #007700">);
echo </span><span style="color: #DD0000">'</ol>'</span><span style="color: #007700">;
</span><span style="color: #0000BB">?></span></code>

Output

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

<code style="color: #000000"><ol>
<li><a href='LINK FROM FEED' title='DESCRIPTION FROM FEED'>TITLE FROM FEED</a><br /></li>
(repeat for number of links specified)
</ol></code>

See also index of Function Reference and index of Template Tags.

Codex