README

Simple calendar extension for MediaWiki.

Install

Require via Composer:

composer require cdamian/wikicalendar

Or copy this directory into your extensions/ directory as WikiCalendar, then add to LocalSettings.php:

wfLoadExtension( 'WikiCalendar' );

Requires MediaWiki 1.43+ and PHP 8.1+.

<calendar>
name=mycalendar
view=year
</calendar>

Parameter	Description
`view`	`days`, `rdays` (reverse), `week`, `month`, `threemonths`, `year` (default), `weeks`, `months`
`name`	Calendar name; used as prefix for day page names
`format`	Day page name pattern, default `%name_%year_%month_%day`
`formattitle`	Title pattern for today/days/week view
`day`, `month`, `year`	Start date (defaults to today)
`date`	strtotime string, overrides `day`/`month`/`year` — e.g. `+1 week`, `next monday`
`enddate`	End date for `weeks` view
`weekstart`	First day of week: `1`=Monday … `7`=Sunday (default `1`)
`skipempty`	Skip empty days in week view
`showempty`	Show "add entry" invitation on empty days (default `1`)
`weekformat`	Week/day layout: `text` (default), `list`, `table`
`months`	Number of months for `months` view
`mergemonth`	Include day page content in month/year views
`merge`	Comma-separated list of calendars to merge into this one

format and formattitle accept %name, %day, %month, %year, and any date() specifier prefixed with % (e.g. %d, %m, %Y).

composer install
vendor/bin/phpcs       # lint
vendor/bin/phpstan analyse  # static analysis
vendor/bin/phpunit     # tests