[[PageOutline(2-5,Contents,pullout)]] = Add custom date fields to tickets = == Description == This plugin allows for validating custom fields as dates in tickets. Just set up the field as a [http://trac.edgewall.org/wiki/TracTicketsCustomFields custom field], then use these extra options in the trac.ini file: ''fieldname''.date = true:: Enable extra date stuff on this field. ''fieldname''.date_empty = true:: Allow this field to be blank. or use the CustomFieldAdminPlugin to create a date field: [[Image(customfields.jpg)]] Currently this will only validate that the given input looks like the specified date format (see below). Date range checking could be added if someone asks nicely enough. '''The configurable options are:''' ''format = '':: valid formats are `dmy`, `mdy`, and `ymd` ''separator = '':: possible values are `-` or `.` or `/` ''first_day = '':: let you change the first day of week (0=Sunday .. 6=Saturday) (as introduced in #1726) '''The following options are available since [7192]''' ''months = 1'':: How many months to show at once? ''milestone = false'':: Use datepicker for milestone due/complete? (format= must match your locale) ''weeknumbers = false'':: Show ISO8601 week numbers? ''panel = false'':: Show a button panel with "Today" and "Done" buttons (at bottom)? ''change_month = false'':: Show a dropdown with month selection? ''change_year = false'':: Show a dropdown with year selection? ''match_request = '':: Use datepicker on arbitrary request paths. Use text fields with class=datepick in your template, and configure the start of request path (in list format), like: ''match_request = /query,/other_path'' There are many other options, but you need to modify the datefield.html template if you want to use them. See [http://docs.jquery.com/UI/Datepicker] == Bugs/Feature Requests == DateFieldPlugin now requires >= [trac:changeset:7982], or apply the [trac:changeset:7982] patch. Alternatively, you can use [http://trac-hacks.org/changeset/3982?format=zip&new=3982 r3982] which is older, has more bugs and less features. Existing bugs and feature requests for DateFieldPlugin are [report:9?COMPONENT=DateFieldPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=DateFieldPlugin&owner=doki_pen new ticket]. == Download == Download the zipped source from [download:datefieldplugin here]. == Source == You can check out DateFieldPlugin from [http://trac-hacks.org/svn/datefieldplugin/0.11 here] using Subversion, or [source:datefieldplugin browse the source] with Trac. == Example == To enable: {{{ [components] datefield.* = enabled }}} To add a Due Date: {{{ [ticket-custom] due_date = text due_date.date = true due_date.label = Due Date due_date.value = MM-DD-YYYY due_date.date_empty = true }}} To configure: {{{ [datefield] format = mdy separator = - first_day = 1 }}} [[Image(datefield.jpg)]] == Recent Changes == [[ChangeLog(datefieldplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:coderanger] [[BR]] '''Maintainer:''' [wiki:doki_pen] [[BR]] '''Contributors:''' [wiki:doki_pen], [wiki:terje] [[BR]]