NOTE: This version of CaRP is obsolete. This documentation is being left here for those who have not yet upgraded to the current version.

Download | Installation | Configuration | Functions | Examples | Donations

Installation

You may Hire me to install CaRP for your for $30, or do the following:

1. Download CaRP.
2. Update the value of cachepath near the top of carp.php to point to the directory where you will save your cached files. See important notes in the configuration section if you wish to store cache files in the same directory as the document loaded by the web browser, or the same directory as CaRP.
3. Set the access permissions on the specified directory to ensure that it is writable by this script, or create an empty file with whatever name you're going to use for the cache file and make sure that the file itsself is modifiable by the script. (Refer to the documentation for your server for information about how to do this. For UNIX/Linux/*BSD servers, use the "chmod" command. Your FTP client may also have the ability to set permissions).
4. Upload carp.php, carpinc.php (and rssparser.php if you are using it) to your webserver. You may wish to put these files into a directory outside of your website directory tree so that they will not be directly accessible with a web browser. (This is always good security practice with files that are not intended to be loaded directly by the web browser).
5. Add lines like the following to your webpage at the point where you want to display the newsfeed:
    
   <?php
   require_once "/path/to/carp.php";
   CarpShow("http://domain_name.com/path/to/rss/feed/file","name_of_cache_file");
   ?>
    
   NOTES:
   • Until you have finalized the display formatting of the RSS feed, you will either need to leave the name_of_cache_file field blank or delete the cache file each time you make a change. Otherwise, the cached copy will be displayed, and your configuration changes will not be used until the cache expires.
   • "name_of_cache_file" is the name of the file on your server in which to cache the reformatted text. This should be just a filename with no path. It will be saved in the directory you specified in step 2.
6. If you are using a proxy server, use the following syntax when specifying the address of the RSS feed, and read about the 'proxyauth' configuration option if your proxy server requires authorization:
    
   http://proxy.server.name.com/http://domain_name.com/path/to/rss/feed/file