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

= Multi-Select Custom Fields =

== Description ==

This patch allows for multi-select custom fields. They use the same syntax as normal select fields (including '|Option1|Option2' to allow for null values), but display as lists and multi-selects in the ticket profile.

This patch tries not to mangle core too much, opting to store Multi-Selects in the database as a pipe-delimited string (e.g. 'Option1|Option2|Option3|'). It uses some magic to display the fields correctly within the ticket profile and in reports. This patch also makes 'contains' work correctly when using !TicketQueries by using the pipe ('|') character.

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Example ==

{{{
#!ini
[ticket-custom]
foo = multi
foo.label = Foos
foo.options = |Bar|Baz
}}}

== Recent Changes ==

[[ChangeLog(multiselectcustomfieldspatch, 3)]]

== Author/Contributors ==

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