Module:Calendar widget/doc

{{Module rating }}

Usage

{{#invoke:Calendar widget|calendar}}

Parameters

Calendar parameters

• |year= – specifies the year to be used when creating a monthly or yearly calendar; Gregorian calendar only; minimum 1583 for yearly calendar; minimum October 1582 for stand-alone month calendar; when omitted or out of range, uses current year
• |month= – specifies the month to be used when creating an stand-alone month calendar in the year specified by |year=; accepts a variety values:

  numbers 1 to 12 – defaults to current month when month number is out of range

  month names (January, March, etc) – defaults to current month when month name is not recognized

  keywords:

  current – display the current month

  last – display the month that occurs before the current month

  next – display the month that occurs after the current month

• |cols= – yearly calendars only; number of columns n to be used for calendar rendering; default is 4; values of n less than 1 or greater than 12 ignored
• |iso= – accepts the single value yes; calendar renders in ISO week format (Monday through Sunday); not needed if |iso_wk= set
• |iso_wk= – accepts the single value yes; calendar renders in ISO week format (Monday through Sunday) with ISO week number in the left column; setting |iso_wk=yes automatically sets |iso=yes

Styling parameters

• |float= – position the rendered calendar; default position is at the left page margin:

  center – middle of the page

  right – at the right page margin

• |hide_year= – accepts the single value yes; suppresses display of year in calendar headers; alias |show_year=off
• |show_today= – accepts the single value yes; highlights the current date in the current-month calendar
• |today_color= – set the highlight color used by |show-today=; alias: |today_colour=
• |title_color= – set background color for the month title bar; overrides |color=; alias: |title_colour=
• |week_color= – set background color for the day-abbreviations title bar; overrides |color=; alias: |week_colour=
• |color= – shorthand for both |title_color= and |week_color=; |color= yields to |title_color= and |week_color=; alias: |colour=
• |wknum_color= – set background color for ISO week numbers; alias: |wknum_colour=

Linking parameters

• |lk= – various date component linking options:

  d – link days in calendar to calendar day of calendar month – [[November 1]]

  m – link month in calendar header to month article – [[November]] 2019

  y – link year in calendar header to year article – November [[2025]]

  dm – link to days and month

  dy – link to days and year

  my – link to month and year

  yes – individually link all date components

  m&y – stand-alone month calendars only; link month and year together as a single composite link – [[November 2025]]

  dm&y – stand-alone month calendars only; link to days and composite month/year

Link prefixes and suffixes

These parameters require |lk=:

• |lk_pref= – prefix for all day, month, and year links enabled by |lk=; yields to specific |lk_pref_x= parameters
• |lk_suff= – suffix for all day, month, and year links enabled by |lk=; yields to specific |lk_suff_x= parameters

These parameters automatically set |lk= to the appropriate value; override values assigned to |lk_pref= and |lk_suff=:

• |lk_pref_d= – prefix for day links
• |lk_pref_m= – prefix for month and composite month/year links
• |lk_pref_y= – prefix for year links
• |lk_suff_d= – suffix for day links
• |lk_suff_m= – suffix for month links and composite month/year links
• |lk_suff_y= – suffix for year links

For stand-alone month calendars only, links to previous- and next-month targets:

• |prevnext= – accepts the single value yes; adds generic << and >> links to month header linked to the preceding and next month articles; automatically set if any of the following parameters are set:
  • |lk_pref_mprev= – prefix for previous-month link
  • |lk_suff_mprev= – suffix for previous-month link
  • |lk_pref_mnext= – prefix for next-month link
  • |lk_suff_mnext= – suffix for next-month link

Examples

if the current page and section is [[An example page#May]] and there is a May calendar there, to offer links to the previous month (April) and next month (June) sections set:

|k_pref_mprev=# – creates link to [[An example page#April]]

|k_pref_mnext=# – creates link to [[An example page#June]]

if the current page is a subpage [[An example page/May]] and there is a May calendar there, to offer links to the previous month and next month subpages set:

|k_pref_mprev=../ – creates link to [[An example page/April]]

|k_pref_mnext=../ – creates link to [[An example page/June]]

in ../, .. is the parent ([[An example page]]) and / is the required path separator; see Uniform Resource Identifier