Calendar Action Documentation

This is the documentation page for the calendar action.

Documentation

See also:
Development: JwCalendar (with source code, and some background and discussion).
NOTE
This feature is available since:
WikkaWiki 1.1.6.0


Short description
Display a calendar face for a specified or the current month. Currently, only years between 1970 and 2037 are supported - earliest timestamp PHP can handle (Windows and some others - to be safe).

Usage
{{calendar [year="yyyy"] [month="mm"]}}

Parameters
nametyperequired?defaultdescription
yearintegeroptionalcurrent year 4-digit year of the month to be displayed; the default can be overridden by providing a URL parameter 'year'
monthintegeroptionalcurrent month number of month (1 or 2 digits) to be displayed; the default can be overridden by providing a URL parameter 'month'

Long description
Specifying a month and/or year in the action itself results in a "static" calendar face without navigation; conversely, providing no parameters in the action results in a calendar face with navigation links to previous, current and next month, with URL parameters determining which month is shown (with the current month as default).

You can have one "dynamic" (navigable) calendar on a page (multiple ones would just be the same) and any number of "static" calendars.

The current date (if visible) gets a special class to allow a different styling with CSS.

Credits
This action was inspired mainly by the "Calendar Menu" code written by Marcus Kazmierczak (© 1998-2002 Astonish Inc.) which we traced back as being the ultimate origin of this code although our starting point was actually a (probably second-hand) variant found on the web which did not contain any attribution.
However, not much of the original code is left in this version. Nevertheless, credit to Marcus Kazmierczak for the original that inspired this, however indirectly: Thanks!

Author
GmBowen (first draft)
JavaWoman (more modifications)

Examples

{{calendar}}

March 2024
Sun Mon Tue Wed Thu Fri Sat
          1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31            
<< = >>


{{calendar month="12" year="1982"}}

December 1982
Sun Mon Tue Wed Thu Fri Sat
      1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31  



CategoryEN
There are 4 comments on this page. [Show comments]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki