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

All Posters Affiliates Plugin

Affiliate RSS Feed

See a live demonstration of this plugin on an multi-affiliates search page.
Become an All Posters affiliate
Become a Gecko Tribe affiliate
The All Posters plugin can be used by All Posters affiliates to search AllPosters.com and convert the affiliates XML to RSS, with their affiliates IDs in the links. It works with two helper scripts: fetch-all-posters.php (which performs the search, unwraps the XML from its SOAP wrapper, and caches a copy of it), and all-posters2rss.php (which pulls all the necessary parts together to drive the whole process).

Installation:
To use the All Posters plugin, xml-allposters.php must be located in the "plugins" folder inside the folder containing grouper.php. This is the default location when Grouper Evolution is installed. The helper scripts, fetch-all-posters.php and all-posters2rss.php, must be installed somewhere on your webserver where they are accessible by a web browser (thought they won't actually be loaded directly by a web browser).

Configuration:
The necessary configuration is performed by making changes to the "********* CONFIGURATION **********" sections of fetch-all-posters.php and all-posters2rss.php. The necessary configuration changes should be clear from the notes appearing in those files.

Additional optional configuration may be performed by altering the plugin's configuration variables. This should be done in the section of all-posters2rss.php marked "// Add any desired All Posters plugin configuration code here" like this:

$xmlgrouperallpostersconf['show-list-price']=1;

Available configuration options are: Use:
Once you have configured fetch-all-posters.php and all-posters2rss.php and uploaded them to your server, you may access the RSS feed generated by the All Posters plugin by entering the URL of all-posters2rss.php into CaRP or whatever application you will be using to consume the feed, with your search terms and product category ID* added to the end of the URL like this:

http://example.com/all-posters2rss.php?q=auto+racing&cat=101

Notice how the space between "auto" and "racing" was changed to a plus sign. This is necessary because URLs cannot contain spaces.

The only required argument to all-posters2rss.php is "q" (short for "query string", meaning the terms you're searching for). The following arguments are optional: * For a list of Category IDs, find the "Datafeed generator" link on AllPosters' LinkBuilder page, and use it to generate a "Category Information" feed. Unfortunately, there does not appear to be an "All categories" category. Here are a few of the more general category IDs as of this writing (the list is humongous and very detailed):