Jump to content

Extension:MultiMaps

From mediawiki.org
MediaWiki extensions manual
MultiMaps
Release status: unmaintained
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)
MediaWiki
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
Quarterly downloads 9 (Ranked 124th)
Translate the MultiMaps extension
Issues Open tasks · Report a bug

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 Maps extension.

Documentation

[edit]
Main page: Documentation

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 move the extracted MultiMaps folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MultiMaps
  • Add the following code at the bottom of your LocalSettings.php file:
    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. For TMS sources, use {-y}.

$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 width 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]