$Id: README.txt,v 1.1.2.2 2007/05/28 15:24:08 somebodysysop Exp $ DESCRIPTION ----------- This module allows you to, for each group type, specify a list of roles that group administrators are allowed to assign. In the subscriber list (og/users/), a 'configure member roles' tab will appear if both the group type is allowed to configure roles and the current user is an admin for the group. For example, if you created a "trusted user" role, and a new node type called "official group," you could allow administrators of only official groups to add selected other group members of to the "trusted user" role. Furthermore, unlike the original og_roles module, this module will restrict the role you select for the user to the group. So, if you have a role called "contributor", and you assign that role to a user and group using this module, the user will only have the role "contributor" in the specified group, and will not have it in any other group unless you specifically add the role to the user in that group. REQUIREMENTS ------------ - Requires the organic groups module. - Requires the organic groups forums module. - Requires additional code in your theme's style.css - Requires Clean URLs. INSTALLATION ------------ - Enable the module from administer >> modules. This should create new table "og_users_roles". If it doesn't then use the og_users_roles.sql file found in the distribution directory to create it manually. - This module uses multi column checkbox settings for display of user roles. This saves space, particulary when your group has lots of users. To activate, you will need to drop the following code into the style.css file of your active theme(s): .checkbox-columns .form-item { font-size:75%; width: 12em; margin-right: 1px; float: left; display: inline; } .checkbox-columns-clear .form-item { font-size:75%; width: 12em; margin-right: 1px; clear: left; float: left; display: inline; } SETTINGS -------- - Go to administer >> Organic groups user roles: 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. Default Non-Group Role for new users If you wish to assign a default site-wide role to every new user that signs up, place a check in: "Set default global (site-wide) role for new signups?" and, select the in which you want all new signups assigned the pulldown: "Selectable roles" Default Group Admin Notification for new subscribers If you wish to automatically send an email notification to the group administrator when a new subscriber is added to a group, then place a check in: "Send email notification to group admin when new subscriber is added to group?" Nodes to automatically place into all available groups If you wish to have certain nodes automatically placed into all available groups each time they are modified, place the comma separated node id numbers into this box: "Nodes to automatically place into all available groups" Note: This is really a specialized customization for my own site. Use it only if you need it. TAC / OG Access Control Integration This is a very specialized feature that you should leave unchecked by default. We have been working on an access control project which allows TAC and OG to work in unison. Basic details of this project are here: http://groups.drupal.org/node/3700 In order to use this feature, you will need a number of patches installed: http://groups.drupal.org/node/4026 Again, unless you understand this project and know what you are doing, please leave this unchecked. USAGE ----- - As a group manager or administrator, go to the Group Home Page. In the group navigation menu you should see an link titled: "# subscribers". Click on this link. You should next see a menu tab which says: "Configure member 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 checked for him while he is within the context of this group. NOTES ----- - Please note that these roles and their permissions will only take effect within the specified group. If you want a user to have the permissions of a role sitewide, then you must apply the role to the user - comment 'Done - note to others' by Ricco I followed the instructions, and all went smooth as silk. To save others time, here are some notes; *) you must have the og_forum module installed first. I hadn't, you can find it here; http://drupal.org/project/og_forum [1] *) it seems that you must disable the og_roles module before you try to enable the og_user_roles module. I hadn't and when I tried to enable the module, i got the happy message; Fatal error: Cannot redeclare _user_roles() (previously declared in /...mypathinfo.../modules/og_roles/og_roles.module:199) in /...mypathinfo.../modules/og_user_roles/og_user_roles.module on line 244 that seems to lock me up for a few seconds... and would not let me even view my site... so use FTP and delete the og_user module (bring it down to your site of course first for backup) and then refresh your browser, and you can get back in, and continue. CREDITS ------- The original og_roles module was Authored and maintained by Farsheed Hamidi-Toosi and Angela Byron of CivicSpace Labs Sponsored by Raven Brooks of BuyBlue.org This version was modified from their original version.