[[PageOutline(2-5,Contents,pullout)]]
= Ticket calendar as box calendar, list and macro in Trac
== Description
This plugin provides a ticket calendar as a box calendar and list view in page and wiki macro. The ticket calendar page can be searched similar to a wiki page. For examples, see below.
== Bugs/Feature Requests
Existing bugs and feature requests for TicketCalendarPlugin are
[report:9?COMPONENT=TicketCalendarPlugin here].
If you have any issues, create a
[/newticket?component=TicketCalendarPlugin new ticket].
[[TicketQuery(component=TicketCalendarPlugin,group=type,format=progress)]]
== Download
Download the zipped source from [export:ticketcalendarplugin here].
== Source
You can check out TicketCalendarPlugin from [/svn/ticketcalendarplugin here] using Subversion, or [source:ticketcalendarplugin browse the source] with Trac.
== Installation
1. Install the plugin:
{{{#!sh
easy_install https://trac-hacks.org/svn/ticketcalendarplugin/0.12
}}}
1. Enable the plugin in your `trac.ini` file:
{{{#!ini
[components]
ticketcalendar.* = enabled
}}}
1. Configuration options can be found on the TracIni#ticketcalendar-section page after installation.
== Example
Click '''Ticket Calendar''' menu in the main navigation bar to show the calendar and associated start and due dates for tickets:
[[Image(calendar-view.png, width=600, border=2)]]
The calendar can also be displayed in a list view:
[[Image(list-view.png, width=600, border=2)]]
== 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.
== Recent Changes
[[ChangeLog(ticketcalendarplugin, 3)]]
== Author/Contributors
'''Author:''' [http://www.opengroove.com OpenGroove,Inc.] and [http://tracpath.com/ tracpath] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' Genie