professional-wiki / modern-timeline
Adds a modern timeline visualization as Semantic MediaWiki result format
Fund package maintenance!
JeroenDeDauw
Installs: 12 448
Dependents: 1
Suggesters: 0
Security: 0
Stars: 15
Watchers: 5
Forks: 7
Open Issues: 10
Type:mediawiki-extension
Requires
- php: >=7.1
- composer/installers: ^2|^1.0.1
- param-processor/param-processor: ~1.10
This package is auto-updated.
Last update: 2024-11-05 14:27:16 UTC
README
The Modern Timeline extension provides a modern timeline visualization for Semantic MediaWiki as a result format.
It was created by Professional.Wiki and funded by KDZ - Centre for Public Administration Research.
Example timeline
Platform requirements
- PHP 7.1 or later (tested up to PHP 8.0)
- MediaWiki 1.31.x or later (tested up to MediaWiki 1.37)
- Semantic MediaWiki 3.0 or later (tested up to SMW 4.0.2)
See the release notes for more information on the different versions of Modern Timeline.
Installation
The recommended way to install Modern Timeline is using Composer with MediaWiki's built-in support for Composer.
Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided.
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": "~1.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": "~1.0"
Remember to add a comma to the end of the preceding line in this section.
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
Add the following line to the end of your "LocalSettings.php" file:
wfLoadExtension( 'ModernTimeline' );
Usage
See also live demos at the following website: Professional.Wiki Starter demo 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
A full list of supported output parameters can be obtained in wiki via the smwdoc
parser function:
{{#smwdoc: moderntimeline }}
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
- 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 for Professional MediaWiki development or Semantic MediaWiki hosting.
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
- Submit a pull request
- Ask a question on the mailing list
Professional MediaWiki support is available via Professional.Wiki.
License
GNU General Public License v2.0 or later (GPL-2.0-or-later).
Release notes
Version 1.2.2
Released on November 9th, 2023.
- Fixed compatibility with MediaWiki 1.38 and above
- Translation updates from https://translatewiki.net
Version 1.2.1
Released on April 11th, 2022.
- Fixed fatal error in some cases where a Title becomes unavailable
Version 1.2.0
Released on March 29, 2020.
- Fixed error occurring when using the
template
parameter with MediaWiki 1.34 or later - Added
image property
parameter (withimage
alias) - Added
wgModernTimelineImageProperty
configuration parameter - Translation updates from https://translatewiki.net
Version 1.1.0
Released on August 28, 2019.
- Improved handling of large data sets
- Translation updates from https://translatewiki.net
Version 1.0.0
Released on August 16, 2019.
Initial release with a TimelineJS3 based result format featuring 12 customization parameters, template support and date range support.