PHPackages                             professional-wiki/modern-timeline - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. professional-wiki/modern-timeline

ActiveMediawiki-extension[Utility & Helpers](/categories/utility)

professional-wiki/modern-timeline
=================================

Adds a modern timeline visualization as Semantic MediaWiki result format

2.0.0(10mo ago)1820.8k—6.3%11[12 issues](https://github.com/ProfessionalWiki/ModernTimeline/issues)1GPL-2.0-or-laterPHPPHP >=8.0CI passing

Since Aug 5Pushed 6mo ago6 watchersCompare

[ Source](https://github.com/ProfessionalWiki/ModernTimeline)[ Packagist](https://packagist.org/packages/professional-wiki/modern-timeline)[ Docs](https://professional.wiki/en/extension/modern-timeline)[ GitHub Sponsors](https://github.com/JeroenDeDauw)[ RSS](/packages/professional-wiki-modern-timeline/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (9)Used By (1)

Modern Timeline
===============

[](#modern-timeline)

[![Code Coverage](https://camo.githubusercontent.com/d492d7200af294c423e2d3d64805ba9c416531645dce684b442f53cd8db238f1/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f50726f66657373696f6e616c57696b692f4d6f6465726e54696d656c696e652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ProfessionalWiki/ModernTimeline/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/72945f40080128e3a8338f0ac4a79a7a286a723653a81a2749c8c2848cfdbb76/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f6d6f6465726e2d74696d656c696e652f762f737461626c65)](https://packagist.org/packages/professional-wiki/modern-timeline)[![Download count](https://camo.githubusercontent.com/7c8b0c715fd9781979c70eea823ef5602c0bc7244e1b2694092d14a3e5176264/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f6d6f6465726e2d74696d656c696e652f646f776e6c6f616473)](https://packagist.org/packages/professional-wiki/modern-timeline)

The **Modern Timeline** extension provides a [modern timeline visualization](https://timeline.knightlab.com) for [Semantic MediaWiki](https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki) as a [result format](https://www.semantic-mediawiki.org/wiki/Help:Result_formats).

It was created by [Professional Wiki](https://professional.wiki/) and funded by [KDZ - Centre for Public Administration Research](https://www.kdz.eu/).

Example timeline

[![image](https://user-images.githubusercontent.com/146040/78048722-70915b00-737a-11ea-89af-7c555b4f2ae7.png)](https://fina.oeaw.ac.at/wiki/index.php/Timeline_of_Correspondence_in_the_16th_Century#event-aahrefhttpsfinaoeawacatwikiindexphpchristopheplantin-fulvioorsini-1574-11-6christopheaplantina-afulvioaorsinia-a1574-11-6a)

Platform requirements
---------------------

[](#platform-requirements)

- PHP 8.1 or later
- MediaWiki 1.43 or later (tested up to MediaWiki 1.43)
- Semantic MediaWiki 6.0 or later (tested up to SMW 6.0.1)

See the [release notes](#release-notes) for more information on the different versions of Modern Timeline.

Installation
------------

[](#installation)

The recommended way to install Modern Timeline is using [Composer](https://getcomposer.org) with [MediaWiki's built-in support for Composer](https://professional.wiki/en/articles/installing-mediawiki-extensions-with-composer).

Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided.

### Step 1

[](#step-1)

Change to the base directory of your MediaWiki installation. If you do not have a "composer.local.json" file yet, create one and add the following content to it:

```
{
	"require": {
		"professional-wiki/modern-timeline": "~3.0"
	}
}

```

If you already have a "composer.local.json" file add the following line to the end of the "require" section in your file:

```
"professional-wiki/modern-timeline": "~3.0"

```

Remember to add a comma to the end of the preceding line in this section.

### Step 2

[](#step-2)

Run the following command in your shell:

```
php composer.phar update --no-dev

```

Note if you have Git installed on your system add the `--prefer-source` flag to the above command.

### Step 3

[](#step-3)

Add the following line to the end of your "LocalSettings.php" file:

```
wfLoadExtension( 'ModernTimeline' );

```

Usage
-----

[](#usage)

See also live demos at the following website: [ProWiki - Demo and Test Wiki - Category:Modern Timeline examples.](https://test.pro.wiki/wiki/Category:Modern_Timeline_examples)

The first date printout is used as date for the timeline events:

```
{{#ask:
 [[Modification date::+]]
 |format=moderntimeline
 |?Modification date
}}

```

If a second date printout is present it is used as end date and the event is displayed as a range:

```
{{#ask:
 [[Start date::+]]
 |format=moderntimeline
 |?Start date
 |?End date
}}

```

Display and behaviour of the timeline can be changed via several output parameters:

```
{{#ask:
 [[Modification date::+]]
 |format=moderntimeline
 |?Modification date
 |width=75%
 |height=500px
 |start at end=on
}}

```

### Parameters

[](#parameters)

A full list of supported output parameters can be obtained in wiki via the `smwdoc` parser function:

```
{{#smwdoc: moderntimeline }}

```

You can also check the [parameter documentation](https://professional.wiki/en/extension/modern-timeline#Parameters)

PHP Configuration
-----------------

[](#php-configuration)

The default value of all parameters can be changed by placing configuration in "LocalSettings.php". These configuration settings are available:

- `$wgModernTimelineWidth` – Timeline width in %. Can also be specified in px, em and ex
- `$wgModernTimelineHeight` – Timeline height in pixels. Can also be specified in em and ex
- `$wgModernTimelineBookmark` – Make the timeline bookmarkable via the page URL
- `$wgModernTimelineBackground` – Background color for the timeline slides (CSS color values)
- `$wgModernTimelineScaleFactor` – Timeline width in screen widths at first presentation
- `$wgModernTimelinePosition` – Display the timeline navigation at the top or at the bottom
- `$wgModernTimelineTickWidth` – Optimal distance (in pixels) between ticks on the axis
- `$wgModernTimelineStartSlide` – The first slide to display when the timeline is loaded
- `$wgModernTimelineStartAtEnd` – Start with the last timeline slide
- `$wgModernTimelineTransitionDuration` – Slide transition in milliseconds
- `$wgModernTimelineNavHeight` – Height of the timeline navigation section in % or px
- `$wgModernTimelineTemplate` – Name of a template to show the slide area with
- `$wgModernTimelineImageProperty` – Semantic property of type Page. Needs to be queried as print request

Default values of these configuration settings can be found in "extension.json". Do not change "extension.json".

Example of changing one of the configuration settings:

```
$wgModernTimelineHeight = '500px';
```

Limitations
-----------

[](#limitations)

- The template parameter is not supported on "Special:Ask"
- The timeline style does not automatically match that of the wiki
- The timeline language does not automatically match that of the wiki

Contact [Professional.Wiki](https://professional.wiki/) for [Professional MediaWiki development](https://professional.wiki/en/mediawiki-development) or [Semantic MediaWiki hosting](https://www.pro.wiki/semantic-mediawiki).

Contribution and support
------------------------

[](#contribution-and-support)

If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guideline.

- [File an issue](https://github.com/ProfessionalWiki/ModernTimeline/issues)
- [Submit a pull request](https://github.com/ProfessionalWiki/ModernTimeline/pulls)
- Ask a question on [the mailing list](https://www.semantic-mediawiki.org/wiki/Mailing_list)

[Professional MediaWiki support](https://professional.wiki/en/support) is available via [Professional Wiki](https://professional.wiki/).

License
-------

[](#license)

[GNU General Public License v2.0 or later (GPL-2.0-or-later)](/COPYING).

Release notes
-------------

[](#release-notes)

### Version 3.0.0

[](#version-300)

Under development.

- Raised minimum PHP version to 8.1
- Raised minimum MediaWiki version to 1.43
- Raised minimum Semantic MediaWiki version to 6.0
- Fixed compatibility with MediaWiki 1.44
- Translation updates from

### Version 2.0.0

[](#version-200)

Released on July 7th, 2025.

- Raised minimum PHP version to 8.0
- Raised minimum MediaWiki version to 1.39
- Upgraded to TimelineJS3 3.9.6
- Translation updates from

### Version 1.2.2

[](#version-122)

Released on November 9th, 2023.

- Fixed compatibility with MediaWiki 1.38 and above
- Translation updates from

### Version 1.2.1

[](#version-121)

Released on April 11th, 2022.

- Fixed fatal error in some cases where a Title becomes unavailable

### Version 1.2.0

[](#version-120)

Released on March 29, 2020.

- Fixed error occurring when using the `template` parameter with MediaWiki 1.34 or later
- Added `image property` parameter (with `image` alias)
- Added `wgModernTimelineImageProperty` configuration parameter
- Translation updates from

### Version 1.1.0

[](#version-110)

Released on August 28, 2019.

- Improved handling of large data sets
- Translation updates from

### Version 1.0.0

[](#version-100)

Released on August 16, 2019.

Initial release with a [TimelineJS3](https://github.com/NUKnightLab/TimelineJS3)based result format featuring 12 customization parameters, template support and date range support.

Examples
--------

[](#examples)

[![image](https://user-images.githubusercontent.com/146040/78049781-c31f4700-737b-11ea-839e-4ec8fe1d9d70.png)](https://user-images.githubusercontent.com/146040/78049781-c31f4700-737b-11ea-839e-4ec8fe1d9d70.png)

---

[![image](https://user-images.githubusercontent.com/146040/78048722-70915b00-737a-11ea-89af-7c555b4f2ae7.png)](https://fina.oeaw.ac.at/wiki/index.php/Timeline_of_Correspondence_in_the_16th_Century#event-aahrefhttpsfinaoeawacatwikiindexphpchristopheplantin-fulvioorsini-1574-11-6christopheaplantina-afulvioaorsinia-a1574-11-6a)

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance47

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 72.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~360 days

Recently: every ~535 days

Total

7

Last Release

315d ago

Major Versions

0.1.0 → 1.0.02019-08-16

1.2.2 → 2.0.02025-07-07

PHP version history (2 changes)0.1.0PHP >=7.1

2.0.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/451bd4039d530fed8f9c3da91bfa519233a397d2182cdfdcad700f6cfea19b7f?d=identicon)[Jeroen De Dauw](/maintainers/Jeroen%20De%20Dauw)

![](https://avatars.githubusercontent.com/u/1104078?v=4)[Karsten Hoffmeyer](/maintainers/kghbln)[@kghbln](https://github.com/kghbln)

---

Top Contributors

[![JeroenDeDauw](https://avatars.githubusercontent.com/u/146040?v=4)](https://github.com/JeroenDeDauw "JeroenDeDauw (164 commits)")[![translatewiki](https://avatars.githubusercontent.com/u/24829418?v=4)](https://github.com/translatewiki "translatewiki (33 commits)")[![kghbln](https://avatars.githubusercontent.com/u/1104078?v=4)](https://github.com/kghbln "kghbln (13 commits)")[![malberts](https://avatars.githubusercontent.com/u/1428594?v=4)](https://github.com/malberts "malberts (9 commits)")[![alistair3149](https://avatars.githubusercontent.com/u/9260542?v=4)](https://github.com/alistair3149 "alistair3149 (3 commits)")[![ZabeMath](https://avatars.githubusercontent.com/u/35405030?v=4)](https://github.com/ZabeMath "ZabeMath (1 commits)")[![Seb35](https://avatars.githubusercontent.com/u/772681?v=4)](https://github.com/Seb35 "Seb35 (1 commits)")[![Universal-Omega](https://avatars.githubusercontent.com/u/54654040?v=4)](https://github.com/Universal-Omega "Universal-Omega (1 commits)")

---

Tags

mediawikimediawiki-extensionsemantic-mediawikisemantic-mediawiki-extensiontimelinemediawikitimelinewikiSemantic MediaWikivisualizationtimelineJS3Result format

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/professional-wiki-modern-timeline/health.svg)

```
[![Health](https://phpackages.com/badges/professional-wiki-modern-timeline/health.svg)](https://phpackages.com/packages/professional-wiki-modern-timeline)
```

###  Alternatives

[mediawiki/semantic-bundle

Bundle extension that installs and loads Semantic MediaWiki and associated extensions

204.4k](/packages/mediawiki-semantic-bundle)[mediawiki/semantic-media-wiki

An extension to MediaWiki that lets you store and query structured data within wiki pages

586361.8k33](/packages/mediawiki-semantic-media-wiki)[mediawiki/maps

Adds various mapping features to MediaWiki

84145.0k3](/packages/mediawiki-maps)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[mediawiki/semantic-extra-special-properties

Provides extra special properties for Semantic MediaWiki

3074.6k1](/packages/mediawiki-semantic-extra-special-properties)[mediawiki/semantic-scribunto

A Semantic Mediawiki extension to natively support the Scribunto extension

2967.5k](/packages/mediawiki-semantic-scribunto)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)