modules/og_audience/README.txt

README file for the OG Audience Drupal module for 5.x

Requires the Organic Groups module.

Description
***********

The OG Audience module allows Organic Groups (OG) users to change a node's
audience without having to edit the node.

This module works by providing a new "change audience" permission, and an
"Audience" tab and/or block on node pages that allows users to change the
audience of existing content. A user can add any node to one or more of the
groups he/she has subscribed to. A group manager can remove a node from his/her
group(s). A node's author can remove the node from one or more of the groups
he/she has subscribed to.


Installation and configuration
******************************

1. Copy the 'og_audience' directory and its content into your Drupal modules
   directory.

2. Grant the "change audience" permission to the desired roles.

3. Visit the settings page at admin/og/og-audience.

4. If desired, enable the block at admin/build/block.


Usage
*****

Select a node to view, then go to the "Audience" tab or use the block.

In the "Add" section, select groups to add the node to. The only groups
appearing in this list are those you are a subscriber of, and to which the node
is not already associated with.

In the "Remove" section, select groups to remove the node from. If you are the
node's author, this list contains groups you are a subscriber of, and that are
currently associated with the node. If you are a group manager, this list shows
groups you are responsible of, and that are currently associated with the node.

When the Organic groups access control module is enabled: If a node was not
already associated with any group, you will have the option to make it public or
private to the group(s) you are adding it to. If a node was already associated
to one or more groups, its visibility outside groups will remain unchanged.


Credits
*******

- Initially developed on behalf of Koumbit.org (http://koumbit.org).

- Sponsored in part by:
  - http://www.geekomatik.com
  - http://www.geekmenow.com
  - Initiatives of Change International (http://www.iofc.org)
1	README file for the OG Audience Drupal module for 5.x
2
3	Requires the Organic Groups module.
4
5	Description
6	***********
7
8	The OG Audience module allows Organic Groups (OG) users to change a node's
9	audience without having to edit the node.
10
11	This module works by providing a new "change audience" permission, and an
12	"Audience" tab and/or block on node pages that allows users to change the
13	audience of existing content. A user can add any node to one or more of the
14	groups he/she has subscribed to. A group manager can remove a node from his/her
15	group(s). A node's author can remove the node from one or more of the groups
16	he/she has subscribed to.
17
18
19	Installation and configuration
20	******************************
21
22	1. Copy the 'og_audience' directory and its content into your Drupal modules
23	directory.
24
25	2. Grant the "change audience" permission to the desired roles.
26
27	3. Visit the settings page at admin/og/og-audience.
28
29	4. If desired, enable the block at admin/build/block.
30
31
32	Usage
33	*****
34
35	Select a node to view, then go to the "Audience" tab or use the block.
36
37	In the "Add" section, select groups to add the node to. The only groups
38	appearing in this list are those you are a subscriber of, and to which the node
39	is not already associated with.
40
41	In the "Remove" section, select groups to remove the node from. If you are the
42	node's author, this list contains groups you are a subscriber of, and that are
43	currently associated with the node. If you are a group manager, this list shows
44	groups you are responsible of, and that are currently associated with the node.
45
46	When the Organic groups access control module is enabled: If a node was not
47	already associated with any group, you will have the option to make it public or
48	private to the group(s) you are adding it to. If a node was already associated
49	to one or more groups, its visibility outside groups will remain unchanged.
50
51
52	Credits
53	*******
54
55	- Initially developed on behalf of Koumbit.org (http://koumbit.org).
56
57	- Sponsored in part by:
58	- http://www.geekomatik.com
59	- http://www.geekmenow.com
60	- Initiatives of Change International (http://www.iofc.org)