wiki:WikiCalendarMacro

Version 46 (modified by Steffen Hoffmann, 12 years ago) (diff)

add comment regarding support for relative wiki paths as requested by lucasrangit in #9398

Small calendar with days linking to wiki pages

Notice: This plugin is unmaintained and available for adoption.

This plugin is under development and will join with the sister plugin WikiTicketCalendarMacro soon. This wiki page will become the home for both. If you have a patch or another idea for future development, please don't hesitate to send it. The current version of the macro seems to be stable and working well with Trac >= 0.11.

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 version 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 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 time module's strftime method.

Bugs/Feature Requests

Existing bugs and feature requests for WikiCalendarMacro are here.

If you have any issues, create a new ticket.

Download

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

Source

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

Installation

Requires Trac >= 0.11.3.

Example

Usage:

[[WikiCalendar([year, [month, [show-buttons, [wiki-page-format]]]])]]

Arguments:

  1. year (4-digit year) - defaults to * (current year)
  2. month (2-digit month) - defaults to * (current month)
  3. show-buttons (boolean) - defaults to true
  4. 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)]]

Screenshot of version 5

Recent Changes

17886 by rjollos on 2020-12-02 22:28:02
2.2.0dev: Make compatible with Trac 1.0 and 1.0.1
17857 by rjollos on 2020-08-25 20:15:06
2.2.0dev: Remove print statement from r17850

Refs #13847.

17851 by rjollos on 2020-08-20 18:12:13
2.2.0dev: Change plugin name

This prepares for publishing on PyPI.

Refs #13847.

(more)

Author/Contributors

Author: mgood
Maintainer: hasienda
Contributors: Alexander Klimetschek, rjollos, JoshuaH, YouLi, fjruiz

Attachments (2)

Download all attachments as: .zip