=== FeedCache ===
Contributors: cpjolicoeur
Donate link: http://www.craigjolicoeur.com/feedcache
Tags: RSS, feed, cache
Requires at least: 1.5
Tested up to: 2.2
Stable tag: 0.5.2

Caches RSS Feeds for display on your WP sidebar. 

== Description ==

This prevents multiple HTTP requests with each page load since the feeds can be read from the cache file.

== Installation ==

1. Upload the feedcache directory to your wordpress wp-content/plugins directory.

2. Change the file permissions on both feedcache-cache.txt and feedcache-config.txt to rw-rw-rw- (666)

3. Activate the FeedCache plugin through your wordpress plugin menu

4. Setup FeedCache options under the Options -> FeedCache Options menu
  (a) Add your list of RSS feeds 1 per line and set the other options.  
      If you wish to manually override the name of the feed, place a pipe character "|" after the RSS URL and then type the name you want to use (e.g http://www.craigjolicoeur.com|Craig P Jolicoeur)
      If you wish to manually override the number of feed items to display, place a pipe character "|" after the feed title and enter the number to display
      If you wish to manually override the feed text formatting, place a pipe character "|" after the feed display number and put either of a true/false boolean value
  (b) Take note of the "CRON Script Settings" section at the bottom - you will need this info

5. Edit the feedcache-cron.rb file
  (a) Copy the "config" file from the CRON Script Settings into the "CONFIG_FILE = ''" variable
  (b) Copy the "cache" file from the CRON Script Settings into the "CACHE_FILE = ''" variable
  (c) Set the number of characters from each RSS feed you want to display

6. Add the feedcache-cron.rb ruby script to your servers CRON job (if you need help with CRON please refer
   to the following URL: http://www.unixgeeks.org/security/newbie/unix/cron-1.html)
  (e.g. 30 * * * * /usr/bin/ruby /path/to/your/wordpress/install/wp-content/plugins/feedcache/feedcache-cron.rb)

7. Add the following code to your wordpress theme where you want the RSS feed listing to be displayed

	<?php if (function_exists('feedcache_display_feeds')) { echo feedcache_display_feeds(); } ?>

8. Sit back and enjoy the plugin



== Upgrading ==

1. Deactivate the previous version of FeedCache through your wordpress plugins menu

2. Upload the new feedcache-cron.rb and feedcache.php files to your existing feedcache directory.  You do not need to overwrite your existing feedcache-config.txt or feedcache-cache.txt files.

3. Enter the correct CACHE_FILE and CONFIG_FILE variables in the feedcache-cron.rb script

4. Go to Options -> FeedCache Options and update your FeedCache settings


== Frequently Asked Questions ==

= Why would I need this plugin? =

If you are using your WP installation to display other website's RSS feeds, this will save HTTP requests and improve page load times for your users.



== Screenshots ==

1. FeedCache Options page