Grouper - Documentation

There are two ways to get CaRP installed on your server:

1. Semi-automated installation:
   1. Download and unpack Grouper.
   2. Follow this instructions in README.HTML (which you'll find after unpacking the Grouper archive).
2. Manual installation (may be less secure than semi-automated installation):
   1. Download and unpack Grouper.
   2. Upload grouper.php, grouperinc.php, grouperconf.php and the rsscache folder to your webserver (put them all in the same folder).
   3. If you purchased Grouper Evolution, also upload the plugins folder to the same location.
   4. Set the access permissions on the "rsscache" folder to ensure that it is writable by Grouper. (Refer to your server's documentation to find out how to do this. For UNIX/Linux/*BSD servers, use the command "chmod 777 rsscache". Your FTP client may also have the ability to set permissions).
   5. Create a PHP page with the following contents:
       
      <?php
      require_once "/path/to/grouper.php";
      GrouperShow("search terms","name_of_cache_file");
      ?>
       
      This PHP file will now output news search results (from Google News by default) in RSS format suitable for viewing in an RSS aggregator or displaying in a web page with a program like CaRP.
      IMPORTANT NOTES:
      • Until you have finalized your search terms, either leave name_of_cache_file 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 newsfeed for faster display. This should be just a filename with no path. It will be saved in the rsscache folder.
       
   6. To use Grouper with CaRP to both generate and display the RSS feed, install CaRP and then add code like the following to your webpage:
       
      <?php
      require_once "/path/to/grouper.php";
      GrouperSearch("search terms", "name_of_grouper_cache_file", 0);
      require_once "/path/to/carp.php";
      CarpShow("grouper:name_of_grouper_cache_file", "name_of_carp_cache_file");
      ?>