Site administrators

Release 2.1 of OG User Roles now modified to work with modr8 module.

If a user has an OG role which gives him the "moderate content" permission, this user can NOT access the modr8 Moderation List or overall Moderation Log. These are "admin" functions and OG User Roles does not give group role users access to sitewide "admin" functions.

However, the user CAN moderate individual nodes (a "Moderate" tab will appear on nodes that the user can moderate) and see the moderation log for individual nodes.

To change the moderation status of an individual node, use this url:

node/< nid >/ogmodr8

Because the OG user (with "moderate content" permission from the OG role) can see and moderate individual nodes in that group, we can use "Views" to obtain a list of nodes in moderation. I exported a view here: http://drupal.org/node/164092#comment-283138 to list all nodes in moderation for a particular group. The URL to the view is: http://www.mysite.com/og/modr8/(GroupID) Your users can use this view to list all nodes in moderation within a group, click on the node link which will bring it up with a "Moderate" tab, and then click on the tab to change the moderation status of the node.

NOTES

• This module changes the "node/add" URL for creating new nodes in group context to "ognodeadd" which can cause problems with some other modules. We have fixed most of the problems that have arisen, and so far, we have tracked the known existing incompatibilities down to the following modules: editablefields http://drupal.org/node/175236 and Formfilter http://drupal.org/node/167184. However, you should be aware that you might be using a module which has this incompatibility with OG User Roles.
• Also, known problem with ognodeadd re-direction with CCK-created group content types where the machine-readable name contains dashes and the human-readable name contains spaces. http://drupal.org/node/178610
• Create content links on the main navigation menu: http://drupal.org/node/174959. In Menu settings, you should uncheck the "Expanded" option for the "Create content" menu item. If you leave the "Create links" menu option on "Expanded", then OG User Roles will display content types that the user can create here when the user is in a group where he has the appropriate role(s). However, if the user clicks on the "Create content" sub-menu link (rather than the Group menu "create" link), he will get an "Access Denied" message.
  

INSTALLATION

1. If you are currently running the "OG Roles" module, please uninstall it. It is incompatible with the "OG User Roles" module.
2. Enable the module from administer->site building->modules. This should create new table "og_users_roles".
3. Go to administer->organic groups->organic groups user roles. In the Group roles fieldset, place a check next to each of the roles you wish to become group "Assignable roles". That is, place a check next to each role that you wish to be assigned to users within specific groups. A user assigned one of these roles within a group will only have the permissions granted by the role while he is within that group's context.

   No roles will be group assignable until you complete this step.

   Group user roles are assigned using the "Configure member roles" tab that OGUR will now place in each group's "Member's" page (see: http://drupal.org/node/343347).

4. Go to administer->user management->access control and give the "configure member roles" permission to the roles you wish to be able to assign group roles to users. Also, assign "administer og_user_roles" permission to user(s) who will be allowed to access the OG User Roles administration (settings) page.
5. If your basic "OG Roles aren't working", please note the following:
   

USAGE

When you assign a group user to a role, the user will have the permissions granted by that role as long as he is within the group context.

To assign a group user to a group role:

As a group manager or administrator, go to the Group Home Page. In the group navigation menu you should see an link titled:

"# subscribers"
"# members"
(/og/users/**group id **)

Click on this link. This gets you to the group "Members" page. You should next see a menu tab which says:

"Configure member roles"
(/og/users/**group id **/roles)

Click on this tab. You should next see the list of subscribers for this
group. Next to each subscriber should be a list of the assignable
roles you selected in "SETTINGS" step above.

Check on each role that each user in the group should have, then don't
forget to click on the "Save Changes" button at the bottom of the page.

Each user will now have the privileges of the role(s) you have granted while that user is within the context of this group.

Using Content Access and ACL with OG User Roles: http://groups.drupal.org/node/5392

OGUR Settings Page

Only users with role ('administer og_user_roles') may configure this module.

Go to Administer >> Organic Groups >> Organic groups user roles:

(Note: Don't forget to click on "Save configuration" button to save your choices.)

• Assignable roles

  Check the box next to each role you wish group admins to be able to manage. Make sure you have assigned the appropriate privileges to roles selected here. Note that because these will be assignable by non-site admins, you should be conservative in what permissions you give (maybe 'create' permissions on a special node type, etc.)

  Again, whatever roles you select here, when they are assigned to a user in a group, that user will only have the permissions of that role while he is within the context of the group in which he is assigned the role. When he is outside of that group's context,
  he will no longer have this role.

• Permissions table for users with 'configure restricted member roles' permission. (6.x and higher)
  

OG User Roles 4.x

The 4.x branch version of OG User Roles (OGUR) is a rewrite of the module for efficiency and speed. Much of the additional features, things that integrated OGUR with other modules, had been impeding the functionality and speed of the original module.

The plan for the future is to move OGUR integration with other modules into OGUR-dependent modules that can be enabled or disabled as need be. Currently, the 4.x version of the module only includes the functionality that the module originally had and does not include the "bonus" features like integration with other modules. See this node for the original discussion that prompted the rewrite.

Please refer to the project page for further, up-to-date information.

The rest of these handbook pages only affect earlier versions than 4.x.

OG User Roles 6.x-1.x and 5.x-3.x

IMPORTANT: The following description and guidelines are related to OG User Roles 6.x-1.x and 5.x-3.x only.

Requires og.module.

Important notes:

• Latest 6.x stable release is NOT compatible with OG 6.x-2.0-rc1. If you are using this version of OG, then please download development release for the time being. See: http://drupal.org/node/432544.