jspωiki
CalendarTag

The Calendar Tag allows one to insert a simple calendar in a template. It is mainly meant to be used in conjunction with the WebLogPlugin.


Usage#

<wiki:CalendarTag pageformat="<date format string>" urlformat="<date format string>" />

Parameters#

You can direct the behaviour of the CalendarTag using the following tag parameters:

pageformat
A page name description string. If a page corresponding to this page format exists, then a link of the 'urlformat' below, is generated.
urlformat
Each link of a date should correspond to this URL. The parameters are the same as in the java.util.SimpleDateFormat. Required.

Example#

       <wiki:Calendar pageformat="'Main_blogentry_'ddMMyy'_1'"
                      urlformat="'Wiki.jsp?page=Main&weblog.startDate='ddMMyy'&weblog.days=1'"/>

This creates a calendar, where each date that has a corresponding "Main_blogentry_ddMMyy_1" page in existence, points to an URL defined using the urlformat parameter.

Note that you will need to escape any real text using single quotes, since the ~SimpleDateFormat format does not use anything fancy like %d. You are free to use any formatting options available.

HTTP Parameters#

The initial start date is taken from HTTP parameters "calendar.date", or "weblog.startDate". The date format should be "ddMMyy". This allows the CalendarTag to set the date accordingly, and also pass it to other tags on the page.