wiki:WikiCalendarMacro

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

Adding download link for 0.11

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

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