=== 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.1 The plugin improves your blogroll by displaying the freshness and the latest post-title of your bookmarks. == Description == The plugin improves your blogroll by displaying the freshness and the latest post-title of your bookmarks. See this [screenshot](http://wordpress.org/extend/plugins/feed-reading-blogroll/screenshots/ "example of a Feed Reading Blogroll") for example. The plugin retrieves the date of the most recent feed-item of the bookmarked site. 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 == = Do I have to save an extra feed-URL along with each of my bookmarks? = No, since version 1.1 of the plugin, this is no longer necessary. The plugin is able to discover the feed-URLs automatically. However, it's still possible and the plugin would use a separatly saved feed-URL. = 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. = Does the plugin support link-categories? = Yes, if you created link-categories, you will be able to group your bookmarks by these categories. On the plugin's option page, you will even be able to order the link-categories customly with drag-and-drop. = The plugin relies on JavaScript, has it been tested to work with the common web browsers? = It has been tested. It is known to work with the following web browsers: * Firefox 3.0 and newer * Apple Safari 3.2 and newer * Microsoft Internet Explorer 7 and newer * Microsoft Internet Explorer 8 beta * Opera 9.51 * Opera Mobile 9.51 * Opera Mini 4.2 * All versions of Google Chrome * SRWare Iron 1.0 and newer == 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. Notice that you can change the order of the categories by draggging and dropping them with your mouse. 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 the current version 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")