[[PageOutline(2-5,Contents,pullout)]]
= Calendar view of Milestones and Tickets =
== Description ==

Macro for the Trac Wiki Ticketing system to display Milestones and Tickets in a calendar view.  The original version of the macro was hosted [http://macgeek.dyndns.org/software/Trac_WikiTicketCalendar here].

[[Image(wikiticketcalendar_screenshot.png)]][[BR]]
screenshot of WikiTicketCalendarMacro 1.1.0 for Trac 0.12 with German localization (calendar header and tooltip)

Versions compatible with Trac 0.11, 0.12 and even for old 0.10 are available now, so test, enjoy and report back any issue, please.

== Bugs/Feature Requests ==

Existing bugs and feature requests for WikiTicketCalendarMacro are 
[query:status!=closed&component=WikiTicketCalendarMacro&order=priority here].

If you have any issues, create a 
[/newticket?component=WikiTicketCalendarMacro&owner=rjollos new ticket].

== Download ==

Download the zipped source from [download:wikiticketcalendarmacro here].[[BR]]
However, to get the one-file version you could look at and save it with the Trac repository browser:
 * [browser:wikiticketcalendarmacro/branches/0.10 0.10]
 * [browser:wikiticketcalendarmacro/branches/0.11 0.11]/0.12 without i18n ^1^
 * [browser:wikiticketcalendarmacro/branches/0.12 0.12] with [#Abouti18nl10nsupport i18n support]

^1^ Note: The 0.11 single-file macro install is somewhat smaller than the Python egg with translations,[[BR]]
and there's no visible difference to the genuine 0.12 version, if you don't use localization for Trac 0.12. 

== Source ==

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

== Example ==

Excerpt of the source documentation:
{{{
  Activate it in 'trac.ini'

  [components]
  WikiTicketCalendarMacro.* = enabled


  format:
    WikiTicketCalendar([year,month,[showbuttons,[wiki_page_format,
        [show_ticket_open_dates,[wiki_page_template]]]]])

    displays a calendar, the days link to:
     - milestones (day in bold) if there is one on that day
     - a wiki page that has wiki_page_format (if exist)
     - create that wiki page if it does not exist
     - use page template (if exist) for new wiki page

  arguments:
    year, month = display calendar for month in year ('*' for current year/month)
    showbuttons = true/false, show prev/next buttons
    wiki_page_format = strftime format for wiki pages to display as link
                       (if there is not a milestone placed on that day)
                       (if exist, otherwise link to create page)
                       default is "%Y-%m-%d", '*' for default
    show_ticket_open_dates = true/false, show also when a ticket was opened
    wiki_page_template = wiki template tried to create new page

  examples:
    WikiTicketCalendar(2006,07)
    WikiTicketCalendar(2006,07,false)
    WikiTicketCalendar(*,*,true,Meeting-%Y-%m-%d)
    WikiTicketCalendar(2006,07,false,Meeting-%Y-%m-%d)
    WikiTicketCalendar(2006,07,true,*,true)
    WikiTicketCalendar(2006,07,true,Meeting-%Y-%m-%d,true,Meeting)
}}}

== About i18n/l10n support ==
The development version of this plugin is prepared for localization (tooltip customization in calendar navigation).[[BR]]
But English message texts are still the (POSIX) default. If this isn't your preferred language, you can
 1. look, if it's already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar Transifex] or
 2. do it yourself (see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).

You've done a new translation? Superb! Contributing your translation is highly appreciated.[[BR]]
You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project]
via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:

Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar/ wikiticketcalendar][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar/)]]
Kindly provided by [[Image(http://sw.transifex.net/2/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]]

== Recent Changes ==

[[ChangeLog(wikiticketcalendarmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:mcomb] [[BR]]
'''Maintainer:''' [wiki:rjollos] [[BR]]
'''Contributors:''' [wiki:hasienda]