=== Plugin Name ===
Contributors: titusbicknell
Donate link: http://www.titusbicknell.com/wordpress/rss-in-page
Tags: pages, posts, rss
Requires at least: 2.5
Tested up to: 3.0
Stable tag: trunk

== Description ==

Short code [rssinpage rssfeed='feedURL'] generates a list of RSS feed items with date, title, link and description.

Optional attributes: 

* rssformat allows you to format the output using format parameters e.g. the default x: Y - z where x is the date, Y is the title with a link, y is the title, z is the description.
* rssitems='number' sets the number of items to return, default is 5
* rssorder='asc' returns items from oldest to newest, default is 'desc' which returns items from newest to oldest
* rsstarget='_blank' opens item link in new window, default is '_self'
* rssdateformat allows item date to be formatted using php date parameters, default is RFC 2822 formatted date
* rss description='no' suppresses default display of the description
* rsscss='yourclassname' allows you to give the list a specific style rather than inheriting the default content list style in your theme  
* rsstitlelength allows you to truncate the title to a certain character length

== Installation ==

1. Download <code>RSSinpage.zip</code>
1. Upload and activate **RSS in Page** through the <code>Plugins</code> menu in **WordPress**
1. insert short code [rssinpage rssfeed='feedURL'] into your page or post and replace feedURL with a valid RSS feed for the content you wish to include

or

1. Download <code>RSSinpage.zip</code>
1. Unzip <code>RSSinpage.zip</code> and upload to the <code>/wp-content/plugins/</code> directory
1. Activate **RSS in Page** through the <code>Plugins</code> menu in **WordPress**
1. insert short code [rssinpage rssfeed='feedURL'] into your page or post and replace feedURL with a valid RSS feed for the content you wish to include

== Change Log ==

2.2:

* rebuilt fetch_feed to shorten chache time to 60 seconds
* added link title roll over

2.1:

* added function so shortcode can handle feed URLs with or without http:// element
* added rsstitlelength to truncate long titles and add an elipsis

2.0: 

* added format parameters to allow custom output using x for date, y for title, Y for title with link and z for description - default rssformat='x: Y<br>z'

1.5:

* fixed encoding issue preventing feed URLs with iso-8859-1 entities from parsing

1.2:

* added optional attributes:
* rssdescription
* rsscss

1.1:

* added optional attributes:
* rsstarget='_blank' opens item link in new window, default is '_self'
* rssdateformat allows item date to be formatted using php date parameters, default is RFC 2822 formatted date

1.0:

* added optional attributes:
* rssitems='number' sets the number of items to return, default is 5;
* rssorder='asc' returns items from oldest to newest, default is 'desc' which returns items from newest to oldest.
* added condition to verify requested items does not exceed available items