Installing CaRP

Online manual:
Index
Display formatting
Function reference
Example code

CaRP Tips (blog)
CaRP Tips (RSS)

Earn money while you sleep:
Join the Gecko Tribe Associates Program, and earn commissions on sales of CaRP and other Gecko Tribe products.

Upgrade to CaRP Koi and get these features:
• Display dates, authors, and images
• Omit duplicate stories
• Remap RSS elements to display non-standard newsfeeds
• Auto-detect the character encoding of newsfeeds

Upgrade to CaRP Evolution and get even more features:
• Add new features using plugins
• Store newsfeed items in a mySQL database
• Modify the contents of a newsfeed before display (expand acronyms, add bolding, italics, etc.)
• Vary visual formatting from item to item
• Perform advanced text-based filtering
• Display only items posted after a specified date
• Add "access keys" to links

CaRP: Caching RSS Parser
© 2002-5, Gecko Tribe, LLC

Installing CaRP

If you have already installed CaRP 3.5 or later (GPL, Koi or Evolution), you may simply overwrite the old files with the files from the "carp" directory in this archive. Note that carpsetupinc.php, PHPFTP.php and PHPTelnet.php are used only during installation, and need not be uploaded when upgrading.

For a fresh installation of CaRP, please do the following:

Decide where you want to put the CaRP scripts on your webserver, and create a new folder for them if necessary.
Recommendations:
- We recommend that the folder be named "carp". This will make it more likely that the setup assistant will be able to locate it automatically. If you are going to name it "carp", you may create it by simply uploading the "carp" folder from the installation archive and its contents (see next step).
- It is good security practice to install scripts like CaRP in a location that cannot be accessed directly by a web browser. For example, if your web folder is located at "/home/joe/public_html", a good location to install CaRP would be "/home/joe/carp" rather than "/home/joe/public_html/carp". However, if you see an error message about "safe mode", you may need to install CaRP inside your web directory.
Upload all of the contents of the "carp" folder from the installation archive to the location chosen in the previous step.
Upload carpsetup.php to your webserver (in a location where you'll be able to load it in your web browser).
Recommendation: For simplicity, we recommend uploading it to your web root folder. For example, if your web folder is located at "/home/joe/public_html", upload it to there.
Load carpsetup.php in your web browser. For example, if you uploaded it to "/home/joe/public_html/carpsetup.php" and your website address is http://www.webhost.com/~joe/, load http://www.webhost.com/~joe/carpsetup.php in your web browser.
Follow the directions that are shown in that page.
Once you have successfully completed setup, delete carpsetup.php and carpsetupinc.php from your server.
You may also delete PHPFTP.php and PHPTelnet.php--they are not used by CaRP. However, if you are a PHP programmer, you may find them useful. See the PHP FTP and PHP Telnet homepages for more information.