=== Plugin Name ===

Contributors: Marcel Goor
Plugin Name: goFetchRSS
Tags: RSS, feed, shortcode, goFetchRSS, fetch_feed, RSS fetch feed, RSS shortcode, RSS fetch feed shortcode, feed shortcode, pageable feed, paging, RSS pageable, pagination, pageable
Requires at least: 2.8
Tested up to: 3.3
Stable tag: 1.0

Use shortcode to display your RSS feeds on pages and posts. Output is configurable and supports pagination with permalink support.


== Description ==

With this plugin you can display your RSS feeds on your pages and posts within Wordpress. The output is configurable and supports pagination with permalink support. 

The plugin was based on plugins by:
- Joost de Valk (http://wordpress.org/extend/plugins/rss-shortcode/).
- Soundwaves Productions (http://wordpress.org/extend/plugins/fetch-feed-shortcode-pageable/faq/).

A life demo can be found on http://www.eenhint.nl/reizen

== Features ==

* Display external feeds in your pages and posts by using shortcode.
* Displays images from your feed.
* Set the URL of the feed by using the `feed` parameter.
* Show all or limit the amount of items read from the feed.
* Select elements (title, author, date and description) from your feeds.
* Link the title towards the post.
* Set the target of links.
* Shorten the content (shows read more link).
* Style output by using CSS.
* Full page navigation with permalink support.
* Limit the amount of items per page.
* Use of first/last buttons in navigation.
* Define your own texts in navigation buttons.
* SEO friendly, configure follow/nofollow links


== Installation ==
1. Upload the `goFetchRSS` directory to the `/wp-content/plugins/` directory
1. Activate the plugin through the `Plugins` menu in WordPress
1. Add shortcodes in your posts or pages


== Other notes ==

After the plugin has been enabled within your wordpress setup you can use shortcode to add feeds into your pages and posts.

[goFetchRSS feed="your_rss_file.xml"]


The following options are configurable
feed 			// url to RSS feed						[default: '']								[input: url]
feed_limit 		// limit items read from feed 			[default: '' = show all] 					[input: number]
feed_class		// special class for the feed			[default: 'goFetchRSS']						[input: text]
feed_elements 	// RSS elements to be shown 			[default: title,author,date,description]	[input: title|author|date|description]
link_title		// link the title 						[default: true]								[input: true|false]
link_target		// target of links 						[default: _self]							[input: _self|_blank|]
link_follow		// follow links							[default: false]							[input: true|false]
limit 			// limit items per page 				[default: '']								[input: number]
shorten			// shorten the text (in chars) 			[default: '' = show all]					[input: number]
show_fl			// Show first/last button 				[default: true]								[input: true|false]
first_text		// text shown for 'first' button 		[default: '« First']					[input: text]
last_text		// text shown for 'last' button 		[default: 'Last »']					[input: text]
previous_text	// text shown for 'previous' button 	[default: '«']						[input: text]
next_text		// text shown for 'next' button 		[default: '»']						[input: text]

example:
[goFetchRSS feed="your_rss_file.xml" feed_limit="20" link_title="false" link_target="_blank" limit="5" shorten="450"]


== Frequently Asked Questions ==

** Can I use my permalinks while using this plugin?
- Yes

** Will the images from the feed be displayed?
- Yes, the images from the feed will be displayed automatically.

** Can I hide the images?
- Yes, if you don't want to show images from the feed you can disable these by using css.

in css:
.item_image {
	display: none;	
}

** Can I style my feeds seperately?
- Yes, just define "class" in the shortcode and style it with CSS

Example:
[goFetchRSS feed="your_rss_file.xml" feed_class="yourOwnClass"]

This changes the default class to "yourOwnClass". 
You can style it in css by using
.yourOwnClass {
	// your styling	
}


** Can I set number of items per page?
Yes, just define "limit" in the shortcode

Example:
[goFetchRSS feed="your_rss_file.xml" limit="5"]

This limits the amount of items per page to 5.



** Can I limit the total feed items?
Yes, just define "feed_limit" in the shortcode

Example:
[goFetchRSS feed="your_rss_file.xml" feed_limit="20"]

This will only show maximum 20 items from the feed.


** Can I configure the elements I wish to display ?
Yes, just define "feed_elements" in the shortcode. You can set four different elements from the feed; title,date,author,description

Example:
[goFetchRSS feed="your_rss_file.xml" feed_elements="title,description"]

This will only display the title and the description from the feed.


** I don't see an author or date
This is probably because these elements aren't specified in the rss feed


** Can I style the output with CSS?
Yes, just add some styling to your default style.css


** I don't see the first/last page buttons
The first/last page buttons only show up when there are sufficient pages to break up the navigation. Otherwise you can just select the last page in the navigation.


== Changelog ==

= 1.0 =
* First release