Extension:EasyTimeline/installation

This section deals with issues on how to activate EasyTimeline in other MediaWiki installations.

EasyTimeline is part of the MediaWiki software. However you need to do a few things in order to activate it.

Note: when you run MediaWiki on another platform than Linux, the following may not apply or be incomplete.

Download Ploticus
EasyTimeline uses open source program Ploticus, which is not included in the MediaWiki installation. Download the proper version for your OS here.

If you can't put the Ploticus executable pl in /usr/local/bin, or any of the other suggested locations, just make sure it's executable and put the appropriate location in LocalSettings.php.

Important: Ploticus 2.30 has a critical bug. Upgrade to 2.31

Download PHP/PERL scripts
EasyTimeline.pl is the actual plug-in, written in perl.

Timeline.php is the MediaWiki php wrapper that invokes the perl script with proper arguments, and feeds generated image and image map (if applicable) to the html output.

Follow these links to get the latest revision of both files : php file:, perl file:

Do not use the EasyTimeline.pl script, or its compiled version, from the authors support page. These are meant for offline usage (= outside WikiMedia).

Important: Newest Ploticus (from 2.31) has changed behaviour. You'll need to patch the php file, see Charts not clickable below.

Settings
For background info see also Write_your_own_MediaWiki_extension

Some rename the php file from Timeline.php to EasyTimeline.php to match the perl file name. In any case make sure to refer to it correctly in the LocalSettings.php file:

include("extensions/EasyTimeline.php"); $wgTimelineSettings->ploticusCommand = "/usr/local/bin/pl"; $wgTimelineSettings->perlCommand = "/usr/local/bin/perl";
 * 1) Add support for EasyTimeline extension

Obviously, the path specified is just an example, you may need to set these parameters differently.

Script location
EasyTimeline.pl needs to be installed in WIKIDIR/extensions/timeline/EasyTimeline.pl (or make a symlink, of course)

Image directory
Create a directory for timeline images:

mkdir WIKIDIR/images/timeline chmod 777 WIKIDIR/images/timeline

Charts not clickable
Ploticus 2.30 is buggy and does never produce a html map file, so no clickable images.

Ploticus 2.31 has fixed this but has changed behaviour: map file is now written to stdout instead of file :(

So you need to apply the patch described below or download pre-patched Timeline.php (version 1.7) here.

Patch by Twhite

[twhite@home]$ diff EasyTimeline.php Timeline-1.7.php 48,58d47 <                else { <                   $lines = split("\n", $ret); <                   $handle = fopen($fname.".map", "w"); <                   for($i=0;$i < count($lines);$i++) { <                      // check if string is area part <                      if(strpos($lines[$i], "area shape") == 1) { <                         fwrite($handle, $lines[$i] . "\n"); <                      } <                    } <                    fclose($handle); <                }