Extension:Calendar-Wikivoyage
![]() Release status: stable |
|
---|---|
Implementation | Parser function |
Description | Creates a table showing the monthly calendar. |
Author(s) | Roland Unger |
Latest version | 1.1 |
MediaWiki | 1.32+ |
License | GNU General Public License 2.0 or later |
Download | |
Translate the Calendar-Wikivoyage extension if it is available at translatewiki.net | |
Calendar is an extension that creates a Calendar in pages. This extension was originally from the old Wikivoyage project.
Download
editThe extension can be retrieved directly from Git [?]:
- Browse code
- Some extensions have tags for stable releases.
- Browse tags
- Select the tag
- Click "snapshot"
- Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
- Browse branches
- Select a branch name
- Click "Continue"
Extract the snapshot and place it in the extensions/Calendar/ directory of your MediaWiki installation.
If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Calendar.git Calendar
Installation
edit- Download and place the file(s) in a directory called
Calendar
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'Calendar' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Usage
editThe Calendar extension implements the following functions:
- calendar: Creates a table showing the monthly calendar.
- Example for application:
{{#calendar: | title= Table header. Instead of a missing title the month and year are shown. | prevLink= Text or link with the meaning of "previous". The text can contain place-holders. | nextLink= Text or link with the meaning of "next". The text can contain place-holders. | month= month to show. Possible values are 1 through 12. A missing month is substituted by the current month. | year= year to show. A missing year is substituted by the current year. Possible values are between 1970 and 2038. | offset= offset to the given month/year in months. | lang= Language of days and months names. Supported language codes are 'user' (user language) or 'content' (content language; default). | highlightedDays= Highlighted days in addition to the current day. Values are separated by spaces. | start= first day of week. Possible values are 0 (Sundays) and 1 (Mondays). | position= defines additional floating. Possible values are (nothing), left, right and center (case insensitive) | 1= to 31= For every day a link can be specified | titleLink= Link to the title. The link can contain place-holders. Do not use link parentheses. | generalLinks= Identical links to all days. The links can contain place-holders. Do not use link parentheses. generalLinks is overwritten by the options 1= to 31= | dayCharsCount= maximum numbers of characters for weekday names | monthCharsCount= maximum numbers of characters for month names | tableWidth= width of the table. 'none' means no definition, 'default' the default width of 20em You can also specify other CSS values like 50%, 300px or 30em. | showToday= specify the highlightings of the today's day. 'true' is default. 'false' prevents highlighting }}
- Place-holders for links:
$a - abbreviated weekday name $A - full weekday name $b - abbreviated month name $B - full month name $d - day of the month, range 01 to 31 $D - day of the month, range 1 to 31 $e - day of the month, range ' 1' to '31' $m - month as a decimal number, range 01 to 12 $M - next month as a decimal number, range 01 to 12 $n - abbreviated month name of the next month $N - full month name of the next month $o - year of the next month as a decimal number without a century, range 00 to 99 $O - year of the next month as a decimal number including the century $p - abbreviated month name of the previous month $P - full month name of the previous month $q - year of the previous month as a decimal number without a century, range 00 to 99 $Q - year of the previous month as a decimal number including the century $R - previous month as a decimal number, range 01 to 12 $y - year as a decimal number without a century, range 00 to 99 $Y - year as a decimal number including the century $% - Dollar sign (use it if necessary)
Used style classes
edit{{#calendar:|position=Right|start=1|lang=user|highlightedDays=1 9 17}} In the Calendar directory you will find the file Calendar.css. It can be overwritten in Common.css or Monobook.css.
- class="calendar" -- for the table as a whole
- class="calLeft" -- left floating
- class="calRight" -- right floating
- class="prevNext" -- for previous and next links
- class="calTitle" -- for the table header
- class="sundays" -- highlighting for sundays
- class="today" -- highlighting for the date of today
- class="highlighted" -- additional highlighted dates
Known Problems
editIt is not possible to convert non-ASCII characters in month names to upper case characters. ucfirst() works only with ASCII characters but not with other Unicode characters.
This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |