Extension:MultiMaps

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
MultiMaps
Release status: stable
MultiMaps Leaflet frame.png
Implementation Parser extension
Description Allows users to display maps and coordinate data using multiple mapping services
Author(s) Pavel Astakhov (pastakhovtalk)
Latest version 0.7.3 (2019-06-15)
PHP 5.3+
Database changes No
License GNU General Public License 2.0 or later
Download
Example osmwiki:Wiki:Maps
  • $egMultiMaps_AllowGeocoderTests
  • $egMultiMaps_CoordinatesSeparator
  • $egMultiMaps_DefaultZoom
  • $egMultiMaps_DelimiterParam
  • $egMultiMaps_DelimiterParam
  • $egMultiMaps_GoogleApiKey
  • $egMultiMaps_Height
  • $egMultiMaps_IconAllowFromDirectory
  • $egMultiMaps_IconPath
  • $egMultiMaps_MapServices
  • $egMultiMaps_SeparatorItems
  • $egMultiMaps_Width
  • $egMultiMaps_YandexApiKey
multimaps
Translate the MultiMaps extension
Check usage and version matrix.

The MultiMaps extension allows users to display maps and coordinate data using multiple mapping services. Currently available maps are openstreetmap (by service leaflet), google, yandex and they can display markers, lines, polygons, rectangles, circles. Starting in version 0.7.3, it is also possible to assign an additional URL to a service.

If possible, the parameter syntax will be compatible with extension Maps.

Documentation[edit]

To quickly display a map with all-default settings at position N10° and E10°, write:

{{#multimaps: 10, 10
}}

Example[edit]

Example available at

Installation[edit]

  • Download and place the file(s) in a directory called MultiMaps in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/MultiMaps/MultiMaps.php";
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration[edit]

Configuration settings (defaults defined in Settings.php)
Parameter Default Comment
$egMultiMaps_AllowGeocoderTests false
$egMultiMaps_MapServices
[
 'Leaflet',
 'Google',
 'Yandex',
 'Wikimedia' => [
  'service' => 'Leaflet',
  'attribution' => '<a href="https://wikimediafoundation.org/wiki/Maps_Terms_of_Use">Wikimedia maps</a> | Map data &copy; <a href="osm.org/copyright">OpenStreetMap contributors</a>',
  'source' => 'https://maps.wikimedia.org/osm-intl/{z}/{x}/{y}.png',
 ]
];
lists all map services provided to the wiki users, first entry is default

Since version 0.7.3 it is possible to specify different tile addresses and attribution notices and link them to a service as seen with Wikimedia. The source attribute is provided in Leaflet notation here.

$egMultiMaps_DefaultZoom 14 default zoom level of map displays, can be configured individually for each map using zoom parameter
$egMultiMaps_SeparatorItems ';'
$egMultiMaps_DelimiterParam '~'
$egMultiMaps_OptionsSeparator ',' delimiter between latitude and longitude
$egMultiMaps_CoordinatesSeparator ':' Geographic coordinates can be a delimited list of values ​​specified in the variable.
$egMultiMaps_Width 'auto' default height of map displays, can be configured individually for each map using width parameter
$egMultiMaps_Height '350px' default height of map displays, can be configured individually for each map using height parameter
$egMultiMaps_IconAllowFromDirectory false If true, allow specify an icon for the marker from the directory
$egMultiMaps_IconPath "$wgScriptPath/mapicons" provide a source for map icons using a URL

An overview of OpenStreetMap-based map styles is located at osmwiki:Tile servers. Please always remember to review their usage policy before using.

See also[edit]