=== JP's Get RSS Feed ===
Contributors: jp2112
Donate link: http://www.codeforexcelandoutlook.com/blog/about-the-author/spread-the-word/
Tags: RSS, feed
Requires at least: 2.8
Tested up to: 2.9
Stable tag: 1.0

Get last X number of posts from a selected RSS feed.

== Description ==

This plugin uses WordPress' ability to return feeds, to get the last X number of items from a given RSS feed. Display the last few items from any
RSS feed of your choice. For example, your Twitter feed, or another blog or forum that outputs a RSS feed. Any RSS feed can be grabbed. Call it in
your footer to list your last few tweets, and your sidebar to showcase content from another one of your blogs.

Uses fetch_feed, which was introduced in WordPress 2.8. Works and tested in WordPress 2.9.

Feed items are wrapped in a div tag, with class "jpgetrssfeed" so you can style the output in your CSS file. The items 
list is surrounded by `<ul></ul>` tags, with each feed item listed in a `<li></li>` tag.

== Installation ==

1. Upload 'jp_get_rss_feed_items.zip' through the WordPress interface (http://www.yourblogurl.com/wp-admin/plugin-install.php?tab=upload), or
unzip the archive and place the PHP file 'jp_get_rss_feed_items.php' in your wp-content/plugins folder.

2. Activate the plugin through the 'Plugins' menu in WordPress
3. Place '<?php jp_get_rss_feed_items("RSS feed URL", number_of_items); ?>' in your theme where you want the list to appear, where

	a. **"RSS feed URL"** is the full URL of the feed, and

	b. **number_of_items** is the number of items you want to return. Default is last 5 items (leave blank for last five items)


== Frequently Asked Questions ==

= How do I use the plugin? =

`<?php jp_get_rss_feed_items("My feed URL", 10); ?>`

will return the last ten items from "My feed URL".

`<?php jp_get_rss_feed_items("My feed URL"); ?>`

will return the last five items.

= How can I list from multiple feeds? =

Use an array and a foreach loop:

`<?php
// create array
$feedslist = array(
"My feed URL number one",
"My feed URL number two",
"My feed URL number three"
);
// loop through array and call plugin
foreach ($feedslist as $item) {
 jp_get_rss_feed_items($item)
}
?>`

This will list the items group from each feed in its own unordered list.

= How can I list items from a random feed? =

Use an array:

`<?php
// create array
$feedslist = array(
"My feed URL number one",
"My feed URL number two",
"My feed URL number three"
);
// get random index from array member
$item = array_rand($feedslist, 1);
// pass randomly selected item to plugin
 jp_get_rss_feed_items($feedslist[$item])
}
?>`

This selects one member randomly and passes it to the plugin.

== Screenshots ==

No screenshots available.

== Changelog ==

= 1.0 =
* Version 1.0 completed December 28th, 2009.

== Upgrade Notice ==

None.