=== RSS Just Better === Contributors: stefsoton Donate link: http://www.stefaniamarchisio.com/donations/ Tags: RSS, Atom, feed, XML, syndication, news, widget, shortcode Requires at least: 2.8 Tested up to: 2.9.2 Stable tag: 0.2 A customizable list of feed items given: URL and number of displayable items. Compatible with RSS 0.91, 0.92, 2.0. Not compatible with Atom. == Description == It displays a list of feed items from a given feed URL. You can select the number of displayable items, whether you want publication date, time and/or excerpt (and how many chars of it). The user can choose to have a ordered (numbered) or unordered (bullet-point) list and to open a new windows or not, when clicking on the linked items. == Installation == 1. From Plugins->Installed of your wordpress administration, select "Add new", search for "RSS just better" into the search text-box then click on 'Install' (on the right) when prompted with this plugin OR 2. Download this plugin from [wordpress repository](http://wordpress.org/extend/plugins/RSS-just-better/) or from [Stefania's blog](http://www.stefaniamarchisio.com/wp-content/uploads/2010/03/RSS-just-better-0.2.zip), unzip it (a directory with 2 files will be extracted) and upload it to the '/wp-content/plugins/' directory of your wordpress 3. Activate the plugin through the Plugins->Installed menu in your WordPress administration 4. Configure it (see Usage in Other Notes) == Frequently Asked Questions == = Why the heck would I need/want it? = Well, it provides the latest items of any feed on the Internet: can you imagine what boost of traffic it can bring to your blog? Let's pretend you write about volleyball, knitting or lactose-intolerance. You just need to enter the relevant feed in the feed URL and wait for it to display the latest items on your subject. = Hey, I cannot find any configuration page in 'Settings' How does it work? = As a widget, you drag & drop the widget to any widget-ready area of your theme; open and complete the widget form, and click on 'Save' button. As a shortcode, you add/edit the post/page you want the news to be displayed into - IN HTML MODE! - and enter your shortcode as explained in Usage (in Other Notes). == Screenshots == 1. Widget Form explained. == Changelog == = 0.2 = * Fixed a bug which prevented the shortcode to show feeds from URLs containing & and = * Made it fully compatible with RSS version 0.92, 2.0, 2.0.1 where link and title might be omitted * Made the widget title linkable to the feed URL * Used the native PHP class simpleXML instead of the Wordpress feed parser (Magpie) = 0.1 = * First release. Originating from google-news-widget plugin == Upgrade Notice == = 0.2 = * Fixed a bug which prevented the shortcode to show feeds from URLs containing & and = * Made it fully compatible with RSS version 0.92, 2.0, 2.0.1 where link and title might be omitted * Made the widget title linkable to the feed URL = 0.1 = * First release. Originating from google-news-widget plugin == Usage == As a widget: * Drag & Drop your widget in the widget-ready area; * Enter a title to be given to this items list; * Enter the feed URL of the items you wish to display; * Choose whether you want the widget title linkable to the feed URL or not; * Choose whether you want a publication date/time, excerpt (and for how many char) or not; * Select whether you want a dotted list (default) or a numbered/ordered list; * Select whether you want the linked items to open up in a new page (default) or in the same page; * Choose whether you allow this plugin's author footer to be displayed or not (please, say yes); * Click on 'Save' (and Close, if you want). As a shortcode: * Your admin wp page->Posts/Pages->Add New or Edit, select HTML in the entry form; * enter [RSSjb feed="..."] where "..." is any website feed you wish to display; That's the sole mandatory attribute. Optional attributes are: * num: number of items to be displayed (default: 3); * pubdate: either true or false to display the publication date/not; * pubtime: either true or false to display the publication time/not; * excerpt: either true or false to display the excerpt/not; * charex: limit the number of the ecerpt chars to be displayed; * list: either "UL" or "OL" to get unordered or ordered lists; * target: either "_blank" or "_self" to get links opened in new/the same windows; * pubauthor: true/false whether you allow this plugin's author footer to be displayed or not (please, say yes); Example: [RSSjb feed="" num="8" list="OL" target="_self"] == The Future == * Better error messaging; * Less-nerdy attributes values. == Interaction == * Would you like to see a new feature in this plugin? Please write me here: mywizardwebs@gmail.com; * Would you like to see a broken/orphan plugin working again? Write me anyhow, I might (hey, MIGHT not will/shall) find the time to give it a look.