[[PageOutline(2-5,Contents,pullout)]]
= Fill Assign-To by looking at permission groups
{{{#!box info
The plugin is deprecated in Trac 1.1.3 and later (trac:#11839). Groups and permissions can be included in the `set_owner` workflow attribute when the action contains the `set_owner` or `may_set_owner` workflow operation (see trac:wiki:1.1/TracWorkflow for more details). The plugin should be uninstalled when upgrading to Trac 1.1.3 or later.
}}}
== Description
This plugin is an {{{IValidOwnerProvider}}}, providing the
FlexibleAssignToPlugin with a specific method to determine user lists for the Assign-To dropdown box.
The list of users is constructed by looking into the '''permissions''' table for
all-lowercase usernames which are members of certain (configurable) groups.
There is both a global configuration option for a list of such group names,
as well as a per-workflow-step variable which takes precedence when it exists.
The groups do not need to have any special permissions defined. Group resolution is done recursively (to a hardcoded depth of 5).
== Usage
First, make sure the FlexibleAssignToPlugin is installed and enabled.
Install the plugin using setuptools ([TracPlugins how to]).
Activate the component in trac.ini like this:
{{{#!ini
[components]
groupingassignto.* = enabled
}}}
Add a new section, headed {{{[groupingassignto]}}}. Put an '''owner_group = Some_Group'''
setting there - by default, any user who is directly or indirectly a member of that
group, will be shown in the Assign-To box.
For each individual workflow step where you would like to have a different list of
usernames in the Assign-To box, write a workflow setting {{{.owner_group = Some_Other_Group}}}.
Instead of single group names, you can also list multiple group names separated by a pipe symbol,
like this: {{{.owner_group = This_Group | That_Group}}}. The Assign-To box will list
all users who are member of either group.
== Example
Assuming permission groups '''Owner_All''', '''Owner_Developer''',
and '''Owner_Developer_Management''', and an already existing workflow step '''submit-to-development''', the following configuration will
* by default, put all users of group ''Owner_All'' into the assign-to box
* for the special workflow step, put there the users from either group
''Owner_Developer'' or ''Owner_Developer_Manager''.
{{{#!ini
[groupingassignto]
owner_group = Owner_All
[ticket-workflow]
...
submit-to-development.owner_group = Owner_Developer | Owner_Developer_Manager
}}}
== Bugs/Feature Requests
Existing bugs and feature requests for GroupingAssignToPlugin are
[report:9?COMPONENT=GroupingAssignToPlugin here].
If you have any issues, create a
[http://trac-hacks.org/newticket?component=GroupingAssignToPlugin&owner=bof new ticket].
== Download
Download the zipped source from [download:groupingassigntoplugin here].
== Source
You can check out GroupingAssignToPlugin from [http://trac-hacks.org/svn/groupingassigntoplugin here] using Subversion, or [source:groupingassigntoplugin browse the source] with Trac.
== Recent Changes
[[ChangeLog(groupingassigntoplugin, 3)]]
== Author/Contributors
'''Author:''' [wiki:bof] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Sponsor:''' [http://www.yalwa.de/ Yalwa Branchenbuch] [[BR]]
'''Contributors:'''