
This module is an XML aggregator. It currently supports RSS 2.0, ATOM 1.0 & RDF 1.0 (RDF contributed by vito_swat!) but it is designed to aggregate from any XML format by adding feed_handlers... More on that below...

1. Requirements :
This module REQUIRES PHP 5.0 or later and CURL support to function properly. Furthermore, if you plan to aggregate from custom feeds that contain and image with every article then the IMAGE module is requiered as well.

2. Installation :
Simply enable the module and you're set to go. Upon enabling this module, you'll have access to 2 new node types, Feed and Feed Item. A vocabulary will also be created called "Aggregation Feed Types", this vocabulary contains terms corresponding to the feed types that can be aggregated from. Adding terms here is the starting point for developing new handlers for your custom XML feeds. Adding a feed_handler is the next step.

3. Configuration :
You can configure the module from (administer -> settings -> aggregation) in drupal 4.7 or (administer -> site configuration -> aggregation) in drupal 5.

4. Use :
For every feed type in the system (i.e. ATOM, RSS, RDF, MY_CUSTOM_FEED_TYPE, etc), a term needs to be created under the vocabulary "Aggregation Feed Types". This term, when assigned to a feed, will cause a file corresponding to the term name to be called (ex. RSS20.inc), the file should reside in the feed_handlers directory. See example.inc for detailed API and RSS20.inc, ATOM10.inc & RDF10.inc for examples on parsing feeds.

5. Notes :
IMPORTANT!!!
Please add an issue in the project's page as soon as you start working on a handler for a public XML feed type (ex. NEWSML, etc) that you would like to contribute to this project. This is necessary to avoid everyone re-working the same feed types over and over. The contributed feed_handler will be tested and incorporated into the next release later on.

If you would like to add a feed handler for a custom XML format that you think will be beneficial to contribute, then please provide a sample XML file and the handler file. Your format may become widely used because your handler is readily available :-)

6. contact Information
Please contribute your suggestions, bugs and issues at the project's page http://drupal.org/project/aggregation
For paid module customizations or drupal development or consultation contact me at mistknight@gmail.com