Semantic Maps

The educational technology and digital learning wiki
Jump to navigation Jump to search
Category:MediaWiki extension
Semantic Maps
Extension name Semantic Maps
About this article / disclaimer This is not official documentation
Logo Placeholder.png
Screenshot Placeholder.png
Location of the main author The following coordinate was not recognized: Geocoding failed.
Coordinates of the main authors Geocoding failed
Developers Jeroen De Dauw, others
Licences GPL v2+
Description Semantic Maps is an extension to Semantic MediaWiki (SMW) that adds semantic capabilities to the Maps extension and adds the datatype Geographic coordinate.
Mediawiki requirements 1.17.* or greater
Dependencies Maps, Semantic MediaWiki, ParamProcessor
Related extensions (documented here) Semantic Forms, Semantic Forms Inputs, Semantic MediaWiki, Semantic Result Formats
Related extensions
Discussion
Language support
Status stable
First release date 2009/07/01
Last release date (as of 2013/08/15!) 2012/12/13
Last version number 2.0.1 (2012-12-13)
Programming language PHP
Alternatives
Website home page
Publications
Support websites web site
Example websites
Last edited 2013/08/15

“Semantic Maps is an extension to Semantic MediaWiki (SMW) that adds semantic capabilities to the Maps extension and adds the datatype Geographic coordinate. This includes the ability to add, edit, aggregate and visualize coordinate data stored through the Semantic MediaWiki extension. It is based on the Maps extension and replaces the earlier implementations Semantic Google Maps and Semantic Layers.” Semantic Maps, retrieved Aug 2013

Download, versions and dependencies

Semantic maps is based on other extensions. Typically, you must include Validator (or ParamProcessor), SMW, semantic Forms, Maps, and finally Semantic Maps.

As of August 2013, you have to make a choice between and older and a newer version. In addition, documentation for ParamProcessor isn't up-to-date, i.e. some confusion of what you need. Also read Wikidata/Notes/SMW and Wikidata

Version 3.0.x

Currently (Aug 2013), alpha but should be working fine if you also upgrade all the dependencies. Same setup as 2.0.x.

Version 2.0.x

Download and instructions: Extension:Semantic_Maps

  • Maps 2.0.1 or above
  • ParamProcessor 1.0 or above. This is a new version of Validator and it also keeps the validator extension directory.
  • DataValues (needed by ParamProcessor)
  • Mediawiki 1.18 or above
  • PHP 5.3 or above

Version 1.0.5

Download and instructions: Extension:Semantic_Maps and the old documentation wiki

Installation notes

Not stable, I just write down the steps I am currently playing with - 17:35, 16 August 2013 (CEST)

  • Installing the latest maps versions seems to break the semantic forms version that is currently installed (.... to be continued)

Environment / SMW already installed

  • Mediawiki version: Special:Version (this wiki)
  • SMW and SMF installed and working

Read the Semantic MediaWiki article for some installation notes ...

Download

Keep a copy of directories that you will have to overwrite. Since Semantic Maps is under aggressive development, their latest versions only seem to work with the latest versions of SMW, SMF, etc. In other words, you are likely to break your wiki and therefore should be prepared to reinstall older versions ...

cd extensions
cp -rp Validator Validator.save
cp -rp SemanticForms SemanticForms.save
cp -rp SemanticMediaWiki SemanticMediaWiki.save

Then install the latest versions....

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/DataValues.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Validator.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/SemanticMediaWiki.git
git clone https://git.wikimedia.org/git/mediawiki/extensions/SemanticForms.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Maps.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/SemanticMaps.git

Edit LocalSettings.php

(1) Add DataValues before Validator

(2) After Validator, SMW and SMF and the maps extensions

Example configuration:

// Start of SMW namespaces (after 106/107 = Coap)
$smwgNamespaceIndex = 108;
# DataValues (needed for ParaProcessor)
require_once( "$IP/extensions/DataValues/DataValues.php" );
# aka ParamProcessor (needed for SMW)
require_once( "$IP/extensions/Validator/Validator.php" );
# SMW
include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php");
enableSemantics('edutechwiki.unige.ch'); // adjust to yours

$smwgShowFactbox = SMW_FACTBOX_NONEMPTY;
// $smwgShowFactbox = SMW_FACTBOX_HIDDEN;

include_once("$IP/extensions/SemanticForms/SemanticForms.php");

# If one or more of your fields can contain internal links entered by users (e.g., "This is a [[cat]]")
$smwgLinksInValues = true;

# Semantic Drilldown. Needs yet another namespace
$sdgNamespaceIndex = 118;
include_once("$IP/extensions/SemanticDrilldown/SemanticDrilldown.php");

# Semantic Result Forms
require_once("$IP/extensions/SemanticResultFormats/SemanticResultFormats.php");

# Semantic Forms Inpus
require_once("$IP/extensions/SemanticFormsInputs/SemanticFormsInputs.php");

# Maps
require_once( "$IP/extensions/Maps/Maps.php" );
# Semantic Maps
require_once( "$IP/extensions/SemanticMaps/SemanticMaps.php" );