wp_rss() WordPress Function

The wp_rss() function is used to retrieve and display RSS feeds from WordPress. RSS is a popular syndication format used by many websites and blogs. WordPress supports RSS feeds out of the box, and the wp_rss() function makes it easy to display them on your site. This function takes two parameters: the RSS feed URL and an optional array of arguments. The URL is the only required parameter, and it should be a valid RSS feed. The array of arguments is optional, but it can be used to customize the behavior of the function. The wp_rss() function will return an error if the URL is not a valid RSS feed. Otherwise, it will return an array of RSS items. Each RSS item will have a title, link, and description. You can use these items to display the RSS feed on your site.

wp_rss( string $url, int $num_items = -1 ) #

Display all RSS items in a HTML ordered list.


Parameters

$url

(string)(Required)URL of feed to display. Will not auto sense feed URL.

$num_items

(int)(Optional) Number of items to display, default is all.

Default value: -1


Top ↑

Source

File: wp-includes/rss.php

function wp_rss( $url, $num_items = -1 ) {
	if ( $rss = fetch_rss( $url ) ) {
		echo '<ul>';

		if ( $num_items !== -1 ) {
			$rss->items = array_slice( $rss->items, 0, $num_items );
		}

		foreach ( (array) $rss->items as $item ) {
			printf(
				'<li><a href="%1$s" title="%2$s">%3$s</a></li>',
				esc_url( $item['link'] ),
				esc_attr( strip_tags( $item['description'] ) ),
				esc_html( $item['title'] )
			);
		}

		echo '</ul>';
	} else {
		_e( 'An error has occurred, which probably means the feed is down. Try again later.' );
	}
}


Top ↑

Changelog

Changelog
VersionDescription
1.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.