Specifications for Version 1.0

Module description

The module extends the subscription module to allow users to subscribe by group. This is very similar to what the subscribe_taxonomy module does for taxonomy terms. If a user subscribes to a group he will receive notifications each time a node is published to that group. The user can also select to receive notifications when such a node is updated or commented.

Subscribing to email notifications of nodes in a group is a completely separate concept from becoming a member of the group. Users do not have to be a member of a group to subscribe to notifications for that group. However the user interface takes account of the fact that users will be particularly likely to want to subscribe to nodes of a group if they are a member of that group. Therefore subscription options will be presented to the user when joining or leaving a group and also when viewing the list of the groups that they are members of.

The organic groups module currently handles its own email notifications. This og functionality is switched off entirely when the subscriptions_og module is installed, to avoid users receiving several notification emails for the same post. All essential current functionality of the og notifications is preserved after the move to the subscriptions module.

There is a potential cause of confusion because the organic groups module used the terms "subscribe" and "subscriber" where it meant "join" and "member". This has been changed by a patch for the organic groups module that changes that terminology, so that "subscribe" is from then on always used only in the sense of subscribing for email notifications.

On the following pages there is a list of changes that the subscriptions_og module will make to the user interface. By specifying the user and admin interfaces we are simultaneously specifying the functionality of the module.

Please post your comments in the drupal.org issue queue at http://drupal.org/node/212248.