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

= Autocomplete user fields (assigned to and CC) on tickets

== Description

This plugin 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 plugin 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`, then all mail addresses will be obfuscated as usual in Trac. That is, email addresses will be displayed as `donjaun@...` rather than `donjaun@example.com`. In all other cases the full email address is visible.

See also: TracAutoCompletePlugin

== Bugs/Feature Requests

{{{#!NewsFlash

= Development News

Version 0.4.3 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&cc=rjollos,jun66j5 new ticket].

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

== Download

Download the zipped source from [export:autocompleteusersplugin here].

== Source

Check out AutocompleteUsersPlugin from [/svn/autocompleteusersplugin here] using Subversion, or [source:autocompleteusersplugin browse the source] with Trac.

== Installation

You can install this plugin with easy_install/pip command from PyPI (pypi:TracAutocompleteUsersPlugin):

{{{#!sh
$ easy_install TracAutocompleteUsersPlugin
or
$ pip install TracAutocompleteUsersPlugin
}}}

== Configuration

After installing the plugin, add the following to your `trac.ini` file:

{{{#!ini
[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:''' jun66j5, [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:tenzochris], [wiki:manski Sebastian Krysmanski], mitar, manski, chrisheller, rjollos [[BR]]