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

= MultiSelectFieldPlugin =

== Description ==

Plugin allowing custom fields in tickets supporting multiple selection mode. Predefined values must be defined for each field, from which multiple values can be selected by the user.

The data is saved as a normal text field with the values separated by '|'.

The selection component itself is using http://harvesthq.github.io/chosen/ to implement multiple selection in a more user friendly way.

== Bugs/Feature Requests == 

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

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

== Download ==

Download the zipped source from [download:multiselectfieldplugin here].

== Source ==

You can check out MultiSelectFieldPlugin from [http://trac-hacks.org/svn/multiselectfieldplugin here] using Subversion, or [source:multiselectfieldplugin browse the source] with Trac.

== Example ==

Install and enable plugin. Then add a new custom field to your conf/trac.ini

For example:
{{{
#!ini
[ticket-custom]
environment.format = list
environment = text
environment.label = Environment
environment.multiselect = true
environment.options = Android|iPhone|iPad|Windows|Linux|MacOs
environment.order = 2
}}}

This will add a new field supporting multiple selection called 'environment' with some predefined values.

[[Image(multiselectfield.2.png)]]

== TODO ==

 * Graphics are glitcing a bit with the remove 'x' button.
 * Behaviour when removing predefined option that is in use in existing tickets is not well defined or tested.

== Recent Changes ==

[[ChangeLog(multiselectfieldplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:ollika] ([http://suikki.wordpress.com]) [[BR]]
'''Maintainer:''' [wiki:ollika] [[BR]]
'''Contributors:'''