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.

monthurlformat

The month and year name on top of the calendar should point to this URL. The parameters are the same as in the java.util.SimpleDateFormat class. Optional. In addition, you can use "%d" to signify the length of the current month.

Also, in all of the parameters the wildcard "%p" can be used to point at the current page name.

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.