TIP TimelinePlugin is not installed on Foswiki.org.

Timeline Foswiki Plugin


Timeline is a DHTML-based AJAXy widget for visualizing time-based events.

I use it to show a WebChanges timeline with the query below.

Syntax Rules

the %TIMELINE% variable has the following parmeters:
  • DEFAULT - the url of the datasource
  • urltype - XML or JSON (defaults to JSON)
  • interval - (DAY, MONTH, YEAR, DECADE)
  • date - the initial date that the timeline will be centered on
  • height - height in pixels that the timeline area will use
  • width - width in pixels that the timeline area will use
  • orientation - horizontal or vertical (horizontal by default)

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %TIMELINEPLUGIN_SHORTDESCRIPTION%

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Show a scrolling Timeline from a Foswiki SEARCH

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

Example (shows when Plugin is installed and running successfully)

Note that the JSON based output is much more reliable cross browsers, so only use xml is you really need to.

static file

The first example shows a timeline based on a pre-existing JSON file (http://trunk.foswiki.org/pub/System/TimelinePlugin/cubism.js)

%TIMELINE{ urltype="JSON" "http://trunk.foswiki.org/pub/System/TimelinePlugin/cubism.js" interval="DECADE" height="200px" width="700px" date="1890" }%

To use data from a Foswiki topic, you need to set the SKIN=text and add ?contenttype=text/xml (to trick IE's XHTTPRequest into working) to the url


Foswiki SEARCH based timeline

This example uses the TimeLineSearchJSON topic to show the last 10 modified topics in the System,Main,Sandbox webs.

%TIMELINE{ urltype="JSON" "http://trunk.foswiki.org/System/TimeLineSearchJSON?contenttype=text/xml" interval="YEAR" height="450px" width="700px" date="25 Mar 2023" }% The example is made up of the the %TIMELINE% variable that is converted into the client side javascript, and a Foswiki %SEARCH% statement that formats the results into the XML data format that the javascript requires.

date="%DISPLAYTIME{"$day $month $year"}%"

customising the SEARCH based timeline

Using the URLPARAMs defined in TimeLineSearchJSON you can customise the output

the currently defined params are:
  • query - default to '1'
  • querytype - defaults to 'query'
  • webs - defaults to 'System,Main,Sandbox'
  • tracknum - defaults to '' to use autolayout

%TIMELINE{ urltype="JSON" "http://trunk.foswiki.org/System/TimeLineSearchJSON?contenttype=text/xml;query=1;querytype=query;webs=System" interval="YEAR" height="250px" width="700px" date="25 Mar 2023" }%

date="%DISPLAYTIME{"$day $month $year"}%"

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Plugin Info

Plugin Author: Foswiki:Main.SvenDowideit - wikiringlogo20x20.png http://WikiRing.com
Copyright: Foswiki Plugin © 2006-2009, SvenDowideit@fosiki.com
  The SIMILE Timeline software is sponsored by The Andrew W. Mellon Foundation and is maintained by the SIMILE project, in particular: David François Huynh, dfhuynh at csail.mit.edu
Plugin License: GPL 3 (GNU General Public License)
SIMILE Timeline License: BSD license
Plugin Version: 4631 - 2009-08-10T02:40:58Z
Change History:  
9 Aug 2009 update to Timeline 2.3.0
20 Feb 2009 port to Foswiki and update to Timeline 2.2.0
19 March 2008 updated to Revision 9234: http://simile.mit.edu/repository/timeline/trunk/src/webapp/api and http://simile.mit.edu/repository/ajax/trunk/src/webapp/api/ , updated Plugin to add features.
22 July 2006: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Bug reports: http://foswiki.org/Tasks
Plugin Home: http://foswiki.org/Extensions/TimelinePlugin

Related Topics: Plugins, DeveloperDocumentationCategory, AdminDocumentationCategory, DefaultPreferences, SitePreferences

PackageForm edit

ExtensionClassification Data and Files, Information structuring and Search, Interface and Visualisation, User interactivity
ExtensionType PluginPackage
DemoUrl http://
ModificationPolicy CoordinateWithAuthor
I Attachment Action Size Date Who Comment
TimelinePlugin.md5md5 TimelinePlugin.md5 manage 165 bytes 10 Aug 2009 - 02:42 SvenDowideit  
TimelinePlugin.sha1sha1 TimelinePlugin.sha1 manage 189 bytes 10 Aug 2009 - 02:42 SvenDowideit  
TimelinePlugin.tgztgz TimelinePlugin.tgz manage 146 K 10 Aug 2009 - 02:42 SvenDowideit  
TimelinePlugin.zipzip TimelinePlugin.zip manage 181 K 10 Aug 2009 - 02:42 SvenDowideit  
TimelinePlugin_installerEXT TimelinePlugin_installer manage 8 K 10 Aug 2009 - 02:42 SvenDowideit  
timeline.jpgjpg timeline.jpg manage 34 K 10 Aug 2009 - 02:41 SvenDowideit  
wikiringlogo20x20.pngpng wikiringlogo20x20.png manage 1 K 10 Aug 2009 - 02:41 SvenDowideit  
Topic revision: r3 - 09 Dec 2009, CrawfordCurrie
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy