=== Feed Reading Blogroll === Contributors: erunafailaro Donate link: http://www.icrc.org/Web/eng/siteeng0.nsf/htmlall/helpicrc Tags: blogroll, sort, freshness, bookmarks, links, sidebar, widget, update, icon, feed, rss2, atom, ajax, Google API, template tag, bloglist, JavaScript Requires at least: 2.7 Tested up to: 2.7.1 Stable tag: 1.0.4 The plugin displays for all your blogroll-bookmarks with a separatly saved feed-url, when the most recent update has occured at the bookmarked site. == Description == The plugin checks and displays the freshness of all your blogroll-bookmarks. You only need to save an extra feed-url for each bookmark to get this to work. See this [screenshot](http://wordpress.org/extend/plugins/feed-reading-blogroll/screenshots/ "example of a Feed Reading Blogroll") for example. The plugin reads the date of the most recent feed-item of the bookmark. The feeds must be indexed by Google as the plugin uses [Google's free AJAX Feed API](http://code.google.com/apis/ajaxfeeds/ "Google AJAX Feed API"). You need a free [Google API Key](http://code.google.com/apis/ajaxfeeds/signup.html "Google API Key") to get it to work. Based on Google's information, the age of the most recent feed-item is calculated and then displayed under each bookmark in your sidebar. **Your blogroll can be sorted by the freshness of the bookmarks.** Furthermore, the title of the freshest post and an icon for each bookmark can be displayed. == Installation == Download the archive and extract all files. Upload the archive and the files to the plugin-directory of your blog. This should be * `/wp-content/plugins/feed-reading-blogroll/*` After that, all files should be located at that directory. Now, go to the plugins-section of your dashboard, look for the entry called **Feed Reading Blogroll** and press **activate**. Furthermore, the plugin will create a JavaScript file in your WordPress content-directory (normally, this is `/wp-content/`). Therefore, this directory must be writable (`chmod 777`) at the moment, the Javascript-file is created for the first time. After that, the content-directory does not need to be writable as far as this plugin is concerned. I would recommend the following procedure: * Set `/wp-content/` to `chmod 777`, e.g. by using your ftp-client. * Go to the plugin's option-page. This will let the plugin create the JavaScript-file. * Go back to your ftp-client and go to `/wp-content/`. You should find a file called `feedreading_blogroll.js` in it. Perfect! The plugin will now be able to overwrite this file, even if `/wp-content/` is no longer writable, so ... * ... set the directory `/wp-content/` back to chmod 755, while letting the rights of `feedreading_blogroll.js` remain chmod 777. Finally, save your own [Google API Key](http://code.google.com/apis/ajaxfeeds/signup.html "Google API Key") at the plugin's option-panel. == History == See [change log](http://www.weinschenker.name/forum/topic/changelog#post-105 "change log") == Frequently Asked Questions == = Can the bookmarks be ordered by "last updated" ? = Yes, by using JavaScript. The visitor's browser will perform the sorting. = Does the plugin access the remote blogs and their feeds directly? = No, the plugin adds JavaScript to your blog that accesses Google and the copy of the feed Google has stored on its servers. Google will be accessed from your visitor's browser. = Will the pageload of my blog be affected in a negative way? = This should not happen. At first your blog will load normally, then a Javascript in your visitor's browser will load the update-infomation from Google. This does not affect the traffic between your blog and the visitor. = Are the links visible to search engine crawlers? = Yes, they are. == Screenshots == 1. This is an example of what the Blogroll might look like, when you have installed this plugin. Notice that the entries are sorted by the latest update of the bookmark. 2. This is a screenshot of the settings-page. It shows the Options-tab. 3. This is a screenshot of the remaining settings you can perform. == Language Support == This plugin supports different languages. Check the [language section](http://www.weinschenker.name/plugin-feed-reading-blogroll/#language "language section") on my homepage for details. If you want to contribute with your own translation, feel free to contact me. I'd be delighted to add it to the plugin. With version 1.0.4 these languages are available: * English * Italian * Spanish * Turkish * German == Plugin Homepage == The complete documentation is located at my [website](http://www.weinschenker.name/plugin-feed-reading-blogroll/ "website"). == Support Forum == You will get help at my [forum](http://www.weinschenker.name/forum/forum/feed-reading-blogroll "Support forum")