Extension:MsCalendar

MediaWiki extensions manual

File:OOjs UI icon advanced-invert.svg MsCalendar Release status: stable
File:Mscal6.png
Implementation	Ajax, Tag
Description	Provides an easy-to-use month view calendar
Author(s)	Martin Schwindl, Martin Keyler, Frédéric Souchon, Felipe Schenone and Patrick Dudics
Latest version	3.0 (2023-03-19)
MediaWiki	1.39+
PHP	5.3+
Database changes	Yes
License	GNU General Public License 3.0 only
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Example	https://mediawiki.solutions/wiki/MsCalendar
Tags ‎<MsCalendar>
Hooks used LoadExtensionSchemaUpdates ParserFirstCallInit
Quarterly downloads
Public wikis using
Translate the MsCalendar extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The MsCalendar extension provides an easy-to-use month view calendar. Entries are formatted as one-liners and can span multiple days.

Installation

• <translate> [[<tvar name=2>Special:ExtensionDistributor/MsCalendar</tvar>|Download]] and move the extracted <tvar name=name>MsCalendar</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MsCalendar
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'MsCalendar' );
  

• <translate> Run the [[<tvar name=update>Special:MyLanguage/Manual:Update.php</tvar>|update script]] which will automatically create the necessary database tables that this extension needs.</translate>
• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

File:OOjs UI icon notice-destructive.svg <translate> Warning:</translate>

Some older versions of this extension had an XSS vulnerability in it. You should make sure you are either using exactly version 2.0-1, or are using version 2.3 or higher

Usage

Wikitext

To insert a calendar into a wiki page, the minimal wikitext is:

<MsCalendar>Name of the calendar</MsCalendar>

By default, all entries are listed alphabetically. If you want to sort them by id (the date at which they were added), do:

<MsCalendar sort="id">Name of the calendar</MsCalendar>

Interface

On opening a calendar page, today's date is viewed and highlighted by default:

You can navigate the calendar, using the panel at the top. The "HEUTE" button will always take you back to today's date:

Add an entry by clicking the little "+" sign at the according date:

Now you can name your event ("Name des Events"), change the date ("Datum") of the event, set the duration in days ("Dauer in Tagen") and choose if the event is recurring annually ("Jährlich wiederholen"). Confirm your entries by clicking "Eintrag erstellen":

To change or delete ("Event Löschen") an entry, just click on it.

Please keep in mind that all entries are displayed as one-liners and shortened accordingly if too long. Using "mouse-over" they still can be read without opening them:

As you can see, this example calendar uses the sorting option: