=== 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.7 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 all feedcache-cache*.txt and feedcache-config*.txt files 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. You can have up to 4 different groupings of RSS feeds to cache. 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" files from the CRON Script Settings into the "CONFIG_FILES = '[]'" array variable (b) Copy the "cache" files from the CRON Script Settings into the "CACHE_FILES = '[]'" array 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 for the default (group 1) listing or you can specify a group (in this case, group 2) If you don't specify a group number in the function call, then Group 1 will be used. If you want to specify the specific group number to display use "feedcache_display_feeds(__GROUP_NUMBER__)" where __GROUP_NUMBER__ is the number you want to display. 8. Sit back and enjoy the plugin == Upgrading == **** IMPORTANT ************************************************************************ If you are upgrading from a version of FeedCache prior to v0.7, please deactivate and delete your existing feedcache plugin directory and follow the new installation steps. v0.7 of the FeedCache plugin includes major changes. *************************************************************************************** 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_FILES and CONFIG_FILES 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. = Will FeedCache work with Atom feeds? = No, not at the moment. Currently FeedCache only supports feeds in the RSS format. Future versions will have Atom support. = Can I receive error emails from the CRON process? = Yes, just set CRON_EMAILS = true in the feedcache-cron.rb script. Error emails are turned off by default. == Screenshots == 1. FeedCache Options page