= !WikiCalendar Macro = == Description == Renders a calendar of links to date-based wiki pages. Its primary use is for maintaining a calendar of meeting minutes, but it can be used in 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 takes one argument to specify the format of the page names. It uses the time format syntax from the Python [http://python.org/doc/current/lib/module-time.html time module]'s {{{strftime}}} method. == Another Version: Automatic linking to Milestones == I have created another version [http://myhpi.de/~alexklim/WikiCalendar.py] (newer than the attached file, includes a time parse bug fix!) which has these new features: (I cannot attach any file to this page anymore, so the link is external. If someone with more privileges could attach that file again under the name WikiCalendar.py it would be very nice) * allows to specify the year,month to display * allows to enable/disable the prev/next buttons * still allows to define a wiki page * but will display a link to a milestone in bold if there is one placed on that day * default format for wiki page is "%Y-%m-%d" * table header with weekdays will be in bold Description: {{{ Format: WikiCalendar([year,month,[showbuttons,[wiki_page_format]]]) Description: Displays a calendar, the days will 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 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" Examples: WikiCalendar shows a calendar for the current month, wiki pages will have the format "%Y-%m-%d" WikiCalendar(2006,07) shows a calender for July 2006, wiki pages will have the format "%Y-%m-%d" WikiCalendar(2006,07,false) as above, but don't display the prev/next buttons WikiCalendar(*,*,true,Meeting-%Y-%m-%d) shows a calendar for the current month, with buttons, and wiki pages with the format "Meeting-%Y-%m-%d" WikiCalendar(2006,07,false,Meeting-%Y-%m-%d) shows a calendar for July 2006, no buttons, and wiki pages with the format "Meeting-%Y-%m-%d" }}} == 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=mgood new ticket]. == Download == * [source:wikicalendarmacro/0.8 WikiCalendarMacro for 0.8]. * [source:wikicalendarmacro/0.9 WikiCalendarMacro for 0.9]. * [source:wikicalendarmacro/0.9 WikiCalendarMacro for 0.11]. == 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. == Example == {{{ [[WikiCalendar(Meeting-%Y-%m-%d)]] }}} will render as [[Image(WikiCalendarMacro.png)]] Version 5 renders as [[Image(wiki-calendar-screen.2.png)]] == Recent Changes == [[ChangeLog(wikicalendarmacro, 3)]] == Author/Contributors == '''Author:''' [wiki:mgood mgood] [[BR]] '''Maintainer:''' [wiki:rjollos] [[BR]] '''Contributors:''' [mailto:alexander.klimetschek@hpi.uni-potsdam.de Alexander Klimetschek], JoshuaH [[TagIt(macro,mgood,example,0.8,0.9,0.11)]]