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

= Ticket calendar as box calendar, list and macro in Trac

== Description

This plugin provides ticket calendar as box calendar and list view in page and wiki macro. The ticket calendar page can search as the same query page.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Example

Click ''Ticket Calendar'' menu in main navigation.

[[Image(calendar-view.png,width=300)]]
[[Image(list-view.png,width=300)]]

== Installation

 1. Install the plugin:
 {{{#!sh
easy_install http://trac-hacks.org/svn/ticketcalendarplugin/0.12
}}}
 1. Enable the plugin:
 {{{#!ini
; conf/trac.ini
[components]
ticketcalendar.* = enabled
}}}
 1. Configuration options can be found on the TracIni#ticketcalendar-section page after installation.

== Macro Usage

`[[TicketCalendar(type=box,query=status!=closed,month=2013-05)]]`

`[[TicketCalendar(type=list,query=status!=closed,duration=2013-05-16/P7D)]]`

 * The `type` parameter determines how the tickets and milestones are presented:
   - `box`: display in calendar view (default)
   - `list`: display in list view
 * The `query` parameter is used to query the tickets to display.
 * The `month` parameter can be specified as `YYYY-MM` in only calendar view. The default is current month.
 * The `duration` parameter can be specified as `YYYY-MM-DD/PnD` in only list view. The default is today and 7 days.

== [log:ticketcalendarplugin Recent Changes]

[[ChangeLog(ticketcalendarplugin, 3)]]

== Author/Contributors

'''Author:''' [http://www.opengroove.com OpenGroove,Inc.] and [http://tracpath.com/ tracpath] [[BR]]
'''Maintainer:''' [wiki:jun66j5] [[BR]]
'''Contributors:''' Genie