Another way to define dynamic user groups in Plone.
Project description
Overview
Products.PluggableAuthService provides a “Dynamic Groups Plugin”. You can add “virtual” groups, and for each of them Membership is established via a predicate, expressed as a TALES expression.
This package aims to provide a similar functionality, but in a different way. Once the “Another Dynamic Groups Plugin” is installed it will lookup registered group providers (technicaly these are named multi-adapters for the user and the request). Each group provider will provide a set of groups which the user is a member of. It’s similar to borg.localrole but for groups.
The provided plugin is also a “groups introspection plugin”. It means the “virtual” groups created are shown in the Plone management UI for groups. Actually, if we don’t do that the @@usergroup-userprefs view breaks.
Compatibility
Current version was tested with Plone 4.3. Probably it will work for any version in the 4.x series.
Installation
The usual: make the package available in the buildout and have its ZCML loaded. Then you can install it as a Plone add-on into a Plone Site.
Usage
Once the add-on is installed you can add “virtual” groups. These will be the groups dynamically assigned to the users by the plugin. This can also be done through the ZMI:
>>> from collective.anotherdynamicgroupsplugin.util import add_virtual_group >>> add_virtual_group(group_id='group1', title='Group 1') >>> add_virtual_group(group_id='group2', title='Group 2')
We’ll also add a regular group, since group providers can assign users to these too:
>>> from plone import api >>> api.group.create(groupname='group3', title='Group 3') <GroupData ...
Add some users:
>>> for u_id in ('user1', 'user2', 'user3'): ... api.user.create(username=u_id, email=u_id + '@test.org') <MemberData ... <MemberData ... <MemberData ...
Now we create and register the named adapters. The first one just makes everybody a member of “group1”:
>>> from collective.anotherdynamicgroupsplugin.interfaces import IGroupProvider >>> from zope.component import provideAdapter >>> from zope.interface import implements >>> from zope.publisher.interfaces.http import IHTTPRequest >>> from Products.PluggableAuthService.interfaces.authservice import IBasicUser >>> class ProvideGroup1ToAll(object): ... implements(IGroupProvider) ... def __init__(self, user, request): ... self.user = user ... self.request = request ... def __call__(self): ... return ['group1'] >>> provideAdapter( ... ProvideGroup1ToAll, ... adapts=(IBasicUser, IHTTPRequest), ... name=ProvideGroup1ToAll.__name__ ... )
The second adapter makes the user member of the group with correspondent name:
>>> class ProvideCorrespondentGroup(object): ... implements(IGroupProvider) ... def __init__(self, user, request): ... self.user = user ... self.request = request ... def __call__(self): ... if not self.user.getId().startswith('user'): ... return [] ... number = self.user.getId()[-1] ... return ['group' + number] >>> provideAdapter( ... ProvideCorrespondentGroup, ... adapts=(IBasicUser, IHTTPRequest), ... name=ProvideCorrespondentGroup.__name__ ... )
Now let’s check if the groups are correctly assigned to each user:
>>> sorted(g.getId() for g in api.group.get_groups(username='user1')) ['AuthenticatedUsers', 'group1'] >>> sorted(g.getId() for g in api.group.get_groups(username='user2')) ['AuthenticatedUsers', 'group1', 'group2'] >>> sorted(g.getId() for g in api.group.get_groups(username='user3')) ['AuthenticatedUsers', 'group1', 'group3']
Test clean-up:
>>> from zope.component import getGlobalSiteManager >>> sm = getGlobalSiteManager() >>> for a in (ProvideGroup1ToAll, ProvideCorrespondentGroup): ... removed = sm.unregisterAdapter( ... provided=IGroupProvider, ... required=(IBasicUser, IHTTPRequest), ... name=a.__name__ ... ) >>> list(sm.registeredAdapters()) []
Changelog
1.0.0 (2015-03-20)
Plone 4.3 compatibility.
Added documentation stating that membership to regular (non-virtual) groups can also be provided by group providers.
0.3 (2012-01-11)
Fixed MANIFEST.in.
0.2 (2012-01-11)
Added MANIFEST.in so the sdist is not broken.
0.1 (2012-01-11)
First release.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.anotherdynamicgroupsplugin-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c76ad10322ff3be099df0f052b4cbb453920b637990ae37d10b18990aaba49f7 |
|
MD5 | cbb6628c476c9095d8968e948614476b |
|
BLAKE2b-256 | 5892bc8ca14c282b98292fdcaa5374dd9be560099003ea4ed6d099699027c3a9 |