[[PageOutline(2-5,Contents,pullout)]]

= Enable a drop-down list to select users for custom fields. Set a specific user according to workflow

{{{#!box info
This plugin uses a 'patch-style' implementation rather than according to standard Trac's guidelines. It may adversely affect other plugins that depend on {{{TicketSystem.custom_fields}}} and {{{ConfigurableTicketWorkflow._to_users}}}.

Not recommended in production use. Use at your own risks.
}}}

== Description

This plugin enables a field to select a specific user according to configuration. This field can later be used in workflow.

1. Create a select Custom Field in your `trac.ini` file:

 {{{#!ini
project_usera = select
project_usera.format = user
project_usera.user = Manager     
}}}

 where:
 * field type must be 'select', 
 * format must be 'user',
 * user is optional and default to 'authenticated', and can be set to comma separated users, groups or PERMISSIONS.

 [[Image(1.png, border=2)]]

2. Use this user in the workflow configuration section in your `trac.ini` file:
 {{{#!ini
pj0102_test = PJ01 -> PJ02
pj0102_test.operations = set_owner
pj0102_test.name = test
pj0102_test.set_owner = $project_usera
}}}

 all you need to do is use a '$' with the field name.

 [[Image(2.png, border=2)]]

'''Note''': Function 2 can also be achieved by AdvancedTicketWorkflowPlugin's set_owner_to_field operation:
{{{#!ini
[ticket]
workflow = ConfigurableTicketWorkflow, TicketWorkflowOpOwnerField

[ticket-workflow]
reassign2 = new,assigned,accepted,reopened -> assigned
reassign2.operations = set_owner_to_field
reassign2.set_owner_to_field = project_usera
}}}

== !Bugs/Feature Requests

Existing bugs and feature requests for TracUserSelectFieldPlugin are 
[report:9?COMPONENT=TracUserSelectFieldPlugin here].

If you have any issues, create a 
[/newticket?component=TracUserSelectFieldPlugin new ticket].

[[TicketQuery(component=TracUserSelectFieldPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [https://github.com/CaulyKan/TracUserSelectFieldPlugin/archive/master.zip here].

== Source

You can check out TracUserSelectFieldPlugin from [https://github.com/CaulyKan/TracUserSelectFieldPlugin.git here] using Git.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

'''Note''': UserSelectFieldPlugin should be activated, but PatchedTicketSystem is NOT supposed to be activated!

Make the following changes in your `trac.ini` file:
{{{#!ini
tracuserselectfield.userselectfield.patchedticketsystem = disabled
tracuserselectfield.userselectfield.userselectfieldplugin = enabled
}}}

== !Author/Contributors

**Author:** [wiki:cauly] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**