[[PageOutline(2-5,Contents,pullout)]]
= Small calendar with days linking to wiki pages =

The "sister" macro WikiTicketCalendarMacro, once forked off from this macro, has been re-integrated.
Both macros are available in `wikicalendar-2.0.0` and later.

== Description ==

Inserts a small calendar where each day links to a wiki page whose name matches the `wiki-page-format` argument.
The current day is highlighted, and days with Milestones are marked in bold.  This macro makes heavy use of CSS for formatting.

It can be used for maintaining a calendar of meeting minutes or any situation where the wiki page name is based on the date.  It is designed to work well with the [trac:MacroBazaar#Blog Blog] macro, so if a previous month is selected from the Blog, the calendar will display the selected month.

Non-existent pages link directly to the edit form for the requested page to make it easy to add new meeting minutes pages.  It uses the time format syntax from the Python [http://python.org/doc/current/lib/module-time.html time module]'s {{{strftime}}} method.  Resolution of relative wiki paths is available.

Check the documentation for WikiTicketCalendarMacro to learn about it's option to preselect a wiki page template for new pages and much more.

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

You can check out the source for !WikiCalendarMacro from Subversion [http://trac-hacks.org/svn/wikicalendarmacro here] or [source:wikicalendarmacro browse the source] with Trac.

== Installation ==

Requires Trac >= 0.11.3. After [11741] you should be able to use the plugin even with Trac 0.11.

If you experience strange results (see #8818 for an [attachment:ticket:8818:wtc.jpg example]),
you may want to force CSS definitions into the HTML page with the following option:
{{{
#!ini
[wikicalendar]
internal_css = True
ticket.due_field = due_close
ticket.due_field.format = %y-%m-%d
}}}
 ''available since'' [11746], WikiTicketCalendarMacro options supported since [11749]

Easy upgrade: Rename your old `[wikiticketcalendar]` section, and the required option name change `ticket.due_field.name --> ticket.due_field.name` will be done automatically for you.

== Example ==
    
Usage:
{{{
[[WikiCalendar([year, [month, [show-buttons, [wiki-page-format]]]])]]
}}}

Arguments:
 1. `year` (4-digit year) - defaults to `*` (current year)
 1. `month` (2-digit month) - defaults to `*` (current month)
 1. `show-buttons` (boolean) - defaults to `true`
 1. `wiki-page-format` (string) - defaults to `%Y-%m-%d`

{{{
[[WikiCalendar(2006,07)]]
[[WikiCalendar(2006,07,false)]]
[[WikiCalendar(*,*,true,Meeting-%Y-%m-%d)]]
[[WikiCalendar(2006,07,false,Meeting-%Y-%m-%d)]]
}}}
Note: relative wiki paths are supported as well, what might be especially relevant, if you later change position of the wiki page containing the !WikiCalendarMacro relative to the stack of related wiki pages:
{{{
[[WikiCalendar(*,*,true,../Meeting/%Y-%m-%d)]]
}}}

[[Image(wiki-calendar-screen.2.png)]]

== Recent Changes ==

[[ChangeLog(wikicalendarmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:mgood mgood] [[BR]]
'''Maintainer:''' hasienda [[BR]]
'''Contributors:''' [mailto:alexander.klimetschek@hpi.uni-potsdam.de Alexander Klimetschek], [wiki:rjollos], JoshuaH, YouLi, fjruiz