Grouper: RSS manager, XML converter, website scraper
Web This Site

Grouper - Documentation


Getting Started: Free Download | Purchase | Install
Reference: Functions | Plugins | Themes
Etc.: Configure | Affiliates

Important Notice:
• The sites that Grouper fetches content from may place requirements for or restrictions on the use of their content. You are responsible to ensure that your use of that content does not violate their terms of service.

• If you are uncertain whether you are authorized to republish information from a particular site, you may wish to limit your use of Grouper to strictly personal use.

• I am not a lawyer, and this statement should not be considered legal advice.
Installation

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");
      ?>
"Google", "Yahoo!", "Amazon", "All Posters" and "Feedster" are trademarks of their respective owners. Grouper is not endorsed by these companies, and Gecko Tribe, LLC is not affiliated with them in any way unless as a participant in their affiliate marketing programs.