wiki:WikiCalendarMacro

Version 27 (modified by rjollos, 5 years ago) (diff)

Adding ChangeLog section

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 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 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 here.

If you have any issues, create a new ticket.

Download

Source

You can check out the source for WikiCalendarMacro from Subversion here or browse the source with Trac.

Example

[[WikiCalendar(Meeting-%Y-%m-%d)]]

will render as

No image "WikiCalendarMacro.png" attached to WikiCalendarMacro

Version 5 renders as

Screenshot of version 5

Recent Changes

[13798] by hasienda on 2014-03-31 21:33:53
WikiCalendarMacro: Improve 'today' offset calculation to succeed for any day-of-month, refs #11656.
[13656] by hasienda on 2014-02-11 23:30:45
WikiCalendarMacro: Pre-filter tickets by calendar time range for performance.
[12991] by hasienda on 2013-04-21 00:13:04
WikiCalendarMacro: Releasing current, tested macro package as final product, closes #7639, #8175, #9718, #10991, #10992 and #10993.

Special thanks to Jun Omae for pushing development by testing and providing
valuable hints in our discussion about utilizing Babel for better
localization and for making macro execution thread-safe as well.

Author/Contributors

Author: mgood
Maintainer: rjollos
Contributors: Alexander Klimetschek, JoshuaH TagIt(macro,mgood,example,0.8,0.9,0.11)?

Attachments (2)

Download all attachments as: .zip