[[PageOutline(2-5,Contents,pullout)]]
= Admin Panels for Custom Fields =

== Description ==

The !CustomSelectAdmin plugin generates custom admin panels for each custom ticket field that is of type 'select.' These custom panels look and behave very similar to the 'Components', 'Milestones', etc. panels.

== Install !CustomSelectAdmin ==

 * By hand:
   * Download and untar the source directory
   * Drop the compiled egg into the plugins directory of your Trac instance
   {{{
   #!sh
   $ python setup.py bdist_egg
   $ cp dist/CustomSelectAdmin<ADDITIONAL-INFO>.egg <PATH-TO-TRAC-INTANCE>/plugins
   }}}
 * Globally:
   * easy_install the egg so it will apply to all Trac instances
     {{{
     #!sh
     $ easy_install CustomSelectAdmin
     }}}

Add the following lines to trac.ini (create [components] if it does not exist)

{{{
#!ini
[components]
CustomSelectAdmin.* = enabled
}}}

or, if you you don't have access to trac.ini but do have the TRAC_ADMIN permission (the Admin panel shows up in the main nav
when you're logged in), you can go to the Plugins section within the Admin area and check 'Enabled' next to !CustomSelectAdmin.

== Bugs/Feature Requests == 

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=CustomSelectAdminPlugin&owner=jetheis new ticket].

== Download ==

Download the zipped source from [http://pypi.python.org/pypi/CustomSelectAdmin/ here].

== Example ==

Within the [ticket-custom] section you can add an additional field, (FIELDNAME).panel = (PANELTITLE) to specify what string will display on the left-hand panel selection area inside the Trac `Admin` section

For Instance:
{{{
#!ini
[ticket-custom]
workcode = select
workcode.label = Work Code
workcode.options = W001 | W002
workcode.value = Plugin
workcode.panel = Work Codes
}}}

== Recent Changes ==

[[ChangeLog(customselectadminplugin, 3)]]

== Author/Contributors ==

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