=== RSS Just Better === Contributors: stefsoton Donate link: http://www.stefaniamarchisio.com/donations/ Tags: RSS, Atom, feed, XML, news, widget, shortcode Requires at least: 2.8 Tested up to: 2.9.2 Stable tag: 0.1 A customizable list of RSS items given: URL and the number of displayable items. It works as both widget and shortcode. == Description == It displays a list RSS items of a chosen feed of choice given: URL, the number of displayable items and whether you want publication date, time, excerpt (and how many chars of it) and reference to the author displayed or not. 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.1.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.1 = * First release. Originating from google-news-widget plugin == Upgrade Notice == = 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 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: number of the ecerpt chars to be displayed/not; * 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.