collective.contentgroups 1.0.0a1

Creating groups

Any groups that you add in the Users and Groups control panel, are standard Plone groups.

In the Content UI, you can create a Group, just like you would create a Page or Folder. Use the Add New action menu and select the content type for which you have enabled the behavior.

Deleting groups is also done in the content UI: simply delete the Group like you would delete a Page.

Note that if the Group is private, a Site Adminstrator will see it in the Groups control panel. But other users may not see the group. Editors that have no permission to see the group, will not be able to select it in the Sharing tab. A member of the group may not effectively get the group membership, because the group is not found (in the portal_catalog search).

In other words: setting a Group in the private state is an effective way to disable it.

Adding users

Adding users to a group must be done on the edit form of the content group. It cannot be done in the Users and Groups control panel. In the Users text field, type the ids of users that you want in this group, one per line.

Note: you need the id of the user, not the login name. Usually they are the same, but they may differ, for example when you use email as login.

It is also fine to add a group id in the users field, either from another content group or a standard Plone Group. Such “recursive” group memberships work seemlessly when you use the Plone recursive groups plugin, which is enabled in default Plone. For this to work, the contentgroups PAS plugin needs to be above the recursive_groups plugin in the IGroupsPlugin. The installer takes care of this.

To remove a user from the group, simply remove its id from the Users field.

In the Users and Groups control panel you will be able to see which users are in a content group and to which content groups a user belongs. But you won’t be able to change it.

Adding roles

You cannot add roles to groups, not in the edit form and not in the control panel. What you can do, is:

• Add the content group to a standard Plone group and give this standard group a role. For example, you can add the content group to the Reviewers group.

• Search and select the content group on the Sharing tab and give it a local role.