=== Recommended Reading: Google Reader Shared ===
Contributors: Jacob M Goldman (C. Murray Consulting)
Donate link: http://www.cmurrayconsulting.com/software/google-reader-shared-wordpress/
Tags: google, reader, shared, recommended, blogs
Requires at least: 2.7
Tested up to: 2.7.1
Stable tag: 2.0

Recommended Reading gets the shared items from your Google Reader account. Includes easy configuration, widget 
support, ability to embed in a page or post (shortcode), and caching.

== Description ==

Recommended Reading: Google Reader Shared gets the shared items from your Google Reader account.

Version 2 is a major update that adds even greater control over the output, and the ability to embed the output
in a page or post with simple shortcode!

Want to easily share posts you recommend from other blogs? Want to share selected posts from your business 
partners' news feeds or friends' blogs? The "Recommended Reading" plug in is the easy way to do it! All 
you need is a free Google Reader account.

It includes an easy to use configuration panel inside the WordPress settings menu. From this panel you 
can control:

   1. Your Google Reader ID... or look it up dynamically with your Google username and password!
   2. Number of posts to show.
   3. Format of post dates (or hide dates).
   4. Option to show the source blog with link.
   5. How many characters from the post's content or summary to show (including all, or none).
   6. Handling of links (new window, nofollow properties)
   7. Display of your notes.
   8. Advanced content output and styling when embedding on a page or post.

Use the sidebar widget, embed in a page or post with simple shortcode, or, for advanced users, call the list 
by a function in your template.

Precise CSS classes throughout the output (with common WordPress conventions) allows granular control over 
the look within templates.

Powerful caching stores and compares the the feed's provided update information, giving you fast performance
with a feed that's always up to date.

Requires PHP 5 or newer.


== Installation ==

1. Install easily with the WordPress plugin control panel or manually download the plugin and upload the folder 
`recommended-reading-google-reader-shared` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the plugin by going to the "Rec. Reading" menu item under "Settings"
4. Widget users can add it to the sidebar by going to the "Widgets" menu under "Appearance" and adding the "Rec
Reading" widget
5. If you want to display the output on a page or post, just type `[recreading]` into the page or post content.
6. Template authors can output the list anywhere in by calling the function: `google_reader_shared()`; pass the
value "true" - `google_reader_shared(true)` - to replicate shortcode output.

== Frequently Asked Questions ==

= How do I set up a Google Reader account? =

Everything you need to know: http://reader.google.com

= How do I share posts? =

Click the "Share" button at the bottom of any post inside Google Reader.

= Do I need to be at my computer to update my recommended reading? =

Nope! Since the plug in gets posts from the Google Reader shared feed, you can update your website's / blog's feed
from any Google Reader interface that supports shared items. Google has a free mobile version of Google Reader...
recommend items from your mobile phone! http://www.google.com/reader/m 

== Screenshots ==

1. Sceenshot of output, using widget.
2. Screenshot of configuration panel.
3. Screenshot of shortcode output.

== Arbitrary section ==

v1.01
* Added "Quick Set" option to display settings
* Vastly improved handling of ID validation
* Fixed source post links

v1.02
* Fixed description of "Trim Post Content"
* Option for opening links in a new window
* Improved output error checking for config saved with invalid feed ID
* JavaScript and PHP code optimizations throughout

v1.5
* Added caching based on feed update tag
* Added control over display of shared item notes
* Added control over widget title
* More standard widget output
* Added more help to plugin options
* Added options to support plugin author

v1.51
* Fixed path issue causing validation and lookup issues

v1.52
* Improved path handling for validation and lookup
* Added check for PHP 5

v1.522
* Fixed mistake in PHP check

v1.530
* Improved error handling and requirements check
* Minor XML parsing changes attempting to address rare object error

v1.540
* Smarter requirements checking
* Modified code causing fatal error upon attempting activation in PHP4

v1.541
* Fixed additional fatal error upon attempting activation in PHP4

v2.0
* Easily embed in a page or post with shortcode; includes special settings!
* Option to hide stand alone notes
* Add rel="nofollow" to links
* Control the preface text for item source and publish date
* Improved built in help
* Misc code improvements and clean up


Coming soon:
* Override settings via parameters when called by function
* Support for individual shared folders
* PHP4 backwards compatability (if enough demand)