[[PageOutline(2-5,Contents,pullout)]]
= Autocomplete user fields (assigned to and CC) on tickets =

== Description ==

The AutocompleteUsersPlugin allows AJAX completion of users for the owner, reporter and CC fields on new and existing tickets.  Currently, all the known users are autocompleted, though this could be restricted to those that have the ticket owner permission.  A `/subjects` URL is served which presents the users and/or groups in a format suitable for the jQuery Autocompleter.  The AutocompleteUsersPlugin should gracefully degrade when !JavaScript is disabled. In addition to fields on new and existing tickets, the following fields are also autcompleted:
 * User and group fields on the admin Permissions page.
 * User field on the admin Components page (forthcoming).
 * Ticket custom fields (forthcoming).

'''Note:''' Email addresses shown by this plugin are handled accordingly to the setting `trac.show_email_addresses` and the permission `EMAIL_VIEW`. That is, if `trac.show_email_addresses` is set to `false` and the current user doesn't have the permission `EMAIL_VIEW` all mail address will be obfuscated as usual in Trac (i.e. email addresses will be displayed as `donjaun@...` rather than `donjaun@example.com`). In any other case the full email address is visible.

See also: TracAutoCompletePlugin

== Bugs/Feature Requests == 

{{{
#!NewsFlash

= Development News =

Version 0.4.2dev of this plugin is now available. The 0.11 branch is undergoing frequent change. If you want to test out the latest version, report back how it is working and possibly do some debugging, then the latest version is for you. Otherwise, r10974 should be fairly stable.
}}}

Existing bugs and feature requests for AutocompleteUsersPlugin are 
[query:status!=closed&component=AutocompleteUsersPlugin&order=priority here].

If you have any issues, create a 
[/newticket?component=AutocompleteUsersPlugin&owner=rjollos new ticket].

== Download and Source ==

Download the [download:autocompleteusersplugin zipped source], check out [/svn/autocompleteusersplugin using Subversion], or [source:autocompleteusersplugin browse the source] with Trac.

== Configuration ==

After installing the plugin add the following to the ''trac.ini'' configuration file:

{{{
[components]
autocompleteusers.* = enabled
}}}

== Example ==

Screenshot of the plugin in action:

[[Image(screenshot.png)]]

== Recent Changes ==

[[ChangeLog(autocompleteusersplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:k0s] [[BR]]
'''Maintainer:''' rjollos, jun66j5 [[BR]]
'''Contributors:''' [wiki:tenzochris], [wiki:manski Sebastian Krysmanski], mitar, manski, chrisheller [[BR]]
'''License''': 3-Clause BSD