RU:Simple image MediaWiki Extension

From OpenStreetMap Wiki
Jump to navigation Jump to search

This page describes a simple image MediaWiki extension. See MediaWiki extension for details of other ideas / enhancements we could develop.

The extension is now installed and running on this wiki. It simply puts a map image on the wiki page by referencing the flexible "MapOf" image generating interface created by User:Ojw.

The extension supports wiki markup of the form

<map lat="51.485" lon="-0.15" z="11" w="300" h="200" format="jpeg" />

There should be no contents placed between start and end tags <map>xxxx</map>

The syntax results in a map! :

The extension simply spits out an <IMG> tag with the src set to a URL like this one:

Old syntax

It used to supports this old format with '|' pipe characters:


This is no longer supported. Any pages using that will see an error

MediaWiki Versions

Harry Wood originally developed this to work on his old version 1.4 MediaWiki installation, but it has since been rewritten, and probably requires v1.6 onwards (unverified)


  • Download the three files which make up this extension. Right-click the links and do 'save as'
  • Save them into a folder called 'SimpleMap'
  • Upload this into your mediawiki installation in the 'extensions' subdirectory
  • Edit your 'LocalSettings.php' file. Add the following lines:
//openstreetmap extension 
$wgMapOfServiceUrl = "";
//$wgMapOfServiceUrl = "";
//$wgMapOfServiceUrl = "";
  • Try it out! e.g. Stick the map syntax example above on your 'SandBox' page.

Dependency note

This introduces a dependency between your wiki and the image generating service running on the openstreetmap server. If openstreetmap ceases to provide images under these URLS ( is caching squid proxy fetching from ), for whatever reason, then your wiki will still function, but it will show image errors. The width and height of the image are specified explicitly in the output HTML, so most browsers will fetch and browse around the rest of your wiki without being slowed down by images failing to load.

We are offering no guarantees about the long-term continuation of this (or indeed any) openstreetmap service. This particular service is experimental, and may be particularly prone to down-time or being moved to a new URL. Equally the extension code may be re-written, and you should aim to use the latest code available here. e.g. for security fixes.

There are a number of limitations and things which could be enhanced. The MediaWiki extension page has lots of ideas for this.

Known Issues / ideas

  • Click takes you to the map, but perhaps it should take you to the Osmarender layer in order to see exact correspondance with the image seen in the wiki.

Who's working on it

The extension code

The code is in subversion:

For more info on subversion see Getting The Source. Changes don't get deployed to the live OSM wiki server until one of the System Administrators does it (ask User:Firefishy or User:TomH). Usually though the latest code you see there should be the code running on this OpenStreetMap wiki.