This page (revision-1) was last changed on 19-Jul-2006 09:36 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version -1 and -1

At line 1 added 31 lines

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.