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

= Autocomplete ticket fields

{{{#!box warning
**Notice:** This plugin is deprecated and should not be used with Trac >= 1.0. AutocompleteUsersPlugin should be used instead. Missing features can be requested for that plugin.
}}}

== Description

This plugin auto completes user info when input report, owner, cc in ticket, and provides a popup dialog to edit cc to help input multiple recipients. The user information are maintained in Trac instance's `../conf/username_list.txt` file. 

This plugin is designed to be used in enterprise environments, where there may be hundreds or thousands of users who are potential notification recipients. Trac administrator should maintain a full list of users and their full name, instead of using Trac's built-in user list.

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

Alternative plugin: AutocompleteUsersPlugin, that uses Trac's built-in user list to accomplish this purpose.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

You can check out TracAutoCompletePlugin from [/svn/tracautocompleteplugin here] using Subversion, or [source:tracautocompleteplugin browse the source] with Trac.

== Installation

You can install this software as a normal Trac plugin.

 1. Uninstall TracAutoCompletePlugin if you have installed before.
 1. Change to the directory containning setup.py.
 1. If you want to install this plugin globally, that will install this plugin to the python path:
  * python setup.py install
 1. If you want to install this plugin to trac instance only:
  * python setup.py bdist_egg
  * copy the generated egg file to the trac instance's plugin directory
 {{{#!sh
cp dist/*.egg /srv/trac/env/plugins
}}}
 1. Configure your `trac.ini` file as follows:
 {{{#!ini
[components]
autocomplete.* = enabled
}}}
 1. Create and edit file /srv/trac/env/conf/username_list.txt. '''Please make sure this file encoded with UTF-8'''.
 {{{
userfoo [User Foo]
userbar [User Bar]
}}} 

== Recent Changes

[[ChangeLog(tracautocompleteplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:richard] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''