$Id: README.txt,v 1.2.2.3 2010/01/29 15:11:59 pixelmonk Exp $

Subscribes to channels published by publish.module. Nodes flow through the channel from the publishing site to the subscribing site.

Nodes can be pushed or pulled through the channel. When you set up a new subscription you choose whether you will be pulling the nodes or whether the publishing site will be pushing them out to you.

The Drupal 6 version is being developed by Alexandru Badiu (i@voidberg.org) and was sponsored by Adulmec.ro (http://adulmec.ro).
The Drupal 4.7 version was developed by John VanDyk (jvandyk@iastate.edu).

Installation
------------
- Enable the Subscribe module on the module administration page.

Usage
-----
To subscribe to a channel go to Admin -> Content -> Subscribe -> Subscribe to a channel. You will need to know the address of a publisher to be able to subscribe to its channels.

In order to receive nodes from a publisher a node type with the same name as the nodes being sent has to exist on the subscriber site. The content types have to have the same fields or at least some of them.

Nodes which have been locally edited will be ignored in future updates from the publisher. The status of each node (excluded / included) can be changed from http://example.com/node/xxx/pubsub. The status is also exposed to views.

Third party integration
-----------------------
The Subscribe module offers the following hooks to allow other modules to integrate with it:
- hook_subscribe_presave(&$node) - This is called before a node received is being saved. At this moment the node does not have a node id.
- hook_subscribe_postsave(&$node) - This is called after a node received has been saved.