Edit Mediawiki extension: Semantic Maps

Free text:

{{quotation|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.|}} [http://www.semantic-mediawiki.org/wiki/Semantic_Maps Semantic Maps], retrieved Aug 2013 == Basic how to == Semantic maps are based on the [[Maps (MediaWiki extension)|Maps]] extension. This Maps extension has two types of features: * Display maps with markers for a coordinates using varies mapping services * One can use [http://semantic-mediawiki.org/wiki/Maps/Geocoding Geocoding], i.e. normal addresses instead of coordinates. However, this doesn't seem to work all the time - [[User:Daniel K. Schneider|Daniel K. Schneider]] ([[User talk:Daniel K. Schneider|talk]]) 19:30, 7 January 2014 (CET) Read more in [[Maps (MediaWiki extension)|Maps]] Semantic Maps, as suggested by its name, allows to retrieve coordinates from properties. Let's look at some data: <source lang="bibtex"> {{#ask: [[Category:MediaWiki extension]] | ?Has address | ?Has location | format=table }} </source> {{#ask: [[Category:MediaWiki extension]] | ?Has address | ?Has location | format=table }} And produce a map from the "has location" properties <source lang="bibtex"> {{#ask: [[Category:MediaWiki extension]] | ?Has location | format=map }} </source> {{#ask: [[Category:MediaWiki extension]] | ?Has location | format=map }} * More tests: [[:Category:MediaWiki_extension]] == Installation notes == === 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 [https://meta.wikimedia.org/wiki/Wikidata/Notes/SMW_and_Wikidata Wikidata/Notes/SMW and Wikidata] ==== Version 3.0.x ==== Currently (dec 2013), beta but should be working fine with MW 1.22 and SMW 1.9x * We suggest using the composer dependency manager to install, read the [[Semantic MediaWiki]] article. ==== Version 2.0.x ==== Download and instructions: [https://www.mediawiki.org/wiki/Extension:Semantic_Maps Extension:Semantic_Maps] * [https://www.mediawiki.org/wiki/Maps Maps 2.0.1] or above * [https://www.mediawiki.org/wiki/Extension:ParamProcessor ParamProcessor] 1.0 or above. This is a new version of Validator and it also keeps the validator extension directory. * [https://www.mediawiki.org/wiki/Extension:DataValues DataValues] (needed by ParamProcessor) * Mediawiki 1.18 or above * [[PHP]] 5.3 or above ==== Version 1.0.5 ==== Download and instructions: [https://www.mediawiki.org/wiki/Extension:Semantic_Maps Extension:Semantic_Maps] '''and''' [http://mapping.referata.com/wiki/Semantic_Maps the old documentation wiki] * [https://www.mediawiki.org/wiki/Maps Maps 1.0.5] * MediaWiki 1.17 or above * [https://www.mediawiki.org/wiki/Validator Validator] later than 0.4.12 === Requirements === '''PHP and Mediawiki version''' You need some sort of "magic combo". We suggest upgrading the wiki to alpha (i.e. get all the code, including extension code from GET). Using MW 1.20x, default PHP of Ubuntu LTS 20.04, we had a severe problem with Validator and SMW (relatated to the version of this wiki). <source lang="bibtex" enclose="div"> Class '\\ValueValidators\\RangeValidator' not found in /export/data/portails/mediawiki/extensions/Validator/includes/ParamProcessor/ParamDefinitionFactory.php on line 181, referer: http://edutechwiki.unige.ch/en/Semantic_Forms </source> This might be due to an older php version but we don't know .... After upgrading both the server and the wiki (see [[special:version]]) to bleeding edge code, it worked. See our [[Special:Version|Mediawiki version]] '''Semantic MediaWiki version''' SMW and SMF should be installed and working. Read the [[Semantic MediaWiki]] article for some installation notes ... === Download === (tested on Jan 30, 2014) Since MW 1.22 (end of 2013), we suggest to use the composer manager. Read the [[Semantic MediaWiki]] article for more details about this framework and how to install it. cd /your/mediawiki-installation-directory * To install the require maps extensions, type: composer require mediawiki/maps "*" * To install Semantic Maps, type: composer require mediawiki/semantic-maps "dev-master" * To update (all extensions), type: composer update However, this may change at some point, e.g. instead of downloading "dev-master", you rather should take a stable version. === Configure LocalSettings.php for older MediaWikis === This is '''before''' composer, do not use this for MW 1.22 or more recent ! (1) Add DataValues before Validator (2) Add the SemanticMaps after all the other SMW extensions (e.g. Validator, SMW and SMF and Maps). Example configuration: <source lang="PHP"> // 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" ); </source> === Understanding and Testing Maps === Since SemanticMaps are based on Maps, it's a good idea to understand how to use Maps first. '''Read:''' * [http://semantic-mediawiki.org/wiki/Maps/Coordinates coordinates] * [http://semantic-mediawiki.org/wiki/Maps/Geocoding geocoding] * [http://semantic-mediawiki.org/wiki/Maps/Displaying_maps Maps/Displaying maps] '''Try a simple Geocoding function like this:''' <source lang="bibtex"> {{#geocode:location=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}} </source> It should show like this: : {{#geocode:location=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}} '''Then, create a map, using geocoding:''' <source lang="bibtex"> {{#display_map:address=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}} </source> It should produce something like that, i.e. the location where this very page has been written :) {{#display_map:address=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}} '''Test the [[Special:MapEditor]] page''' * Insert stuff and export the wiki code, then paste into some page.

Save page Show preview Show changes Cancel