=== 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: 1.521

Recommended Reading gets the shared items from your Google Reader account. Includes easy configuration, widget 
support, and caching.

== Description ==

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

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. Whether to open links in a new window.
   7. Display of your notes.

Use the sidebar widget, or, for advanced users, call the list by a function in your templates.

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. Upload the folder `recommended_reading` 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 item under "Appearance"; or output the 
list anywhere in your template by calling the function: `google_reader_shared()`

== 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.

== 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.521
Fixed mistake in PHP check

Coming soon:
Control over stand alone notes
Link relationship control (nofollow)
Override settings via parameters when called by function