Skip to content

🗺 Maps is the MediaWiki extension that enables visualization of geographic data with dynamic embedded maps.

License

Notifications You must be signed in to change notification settings

gcebelieu/Maps

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Maps

Maps is a MediaWiki extension to work with and visualize geographical information.

Features:

  • Powerful #display_map parser hook for embedding highly customizable dynamic maps into wiki pages.
  • Support for multiple mapping services: Leaflet, Google Maps, OpenLayers and OpenStreetMap.
  • Integration with Semantic MediaWiki via a coordinate datatype
    • Query your stored coordinates and visualize them on dynamic maps, as tables or as lists
    • Export your coordinates as KML or RDF
    • Combine coordinates with other structured data stored in your wiki
  • Geocoding via several supported services with the #geocode parser function.
  • Coordinate formatting and format conversion via the #coordinates parser function.
  • Geospatial operations
    • Calculating the distance between two points with #geodistance
    • Finding a destination given a starting point, bearing and distance with #finddestination
  • Distance formatting and format conversion via the #distance parser function.
  • Visual map editor (Special:MapEditor) to edit #display_map wikitext (requires Google Maps).

Maps has been maintained since 2009 and is installed on over 1000 public wikis.

User manual

For administrators

For wiki users

Getting support

Project status

  • Latest version                    Latest Stable Version
  • Downloads on Packagist Download count
  • TravisCI                              Build Status
  • Code quality                       Scrutinizer Quality Score
  • Open bugs and feature requests
  • Maps on OpenHub
  • Blog posts about Maps

Contributing

Running the tests

As setup, run composer install inside of the Maps root directory.

You can run the MediaWiki independent tests by executing phpunit in the root directory of maps:

phpunit

This is possible without having a MediaWiki installation or webserver. A clone of the Maps code suffices.

If you do not have PHPUnit installed, you can download the .phar into the root directory and execute it there:

wget -O phpunit.phar https://phar.phpunit.de/phpunit-7.phar
php phpunit.phar

To run the tests with MediaWiki, change into tests/phpunit of your MediaWiki installation and run

php phpunit.php --wiki wiki -c ../../extensions/Maps/phpunit.xml.dist

Where you either update wiki to match your wikis name, or drop the parameter. The above command works without modification if you are using the MediaWiki Vagrant.

Beware that due to technical debt, some tests access the network.

Links

About

🗺 Maps is the MediaWiki extension that enables visualization of geographic data with dynamic embedded maps.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 54.8%
  • PHP 40.7%
  • CSS 4.0%
  • Other 0.5%