codehead / maps

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

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: Google Maps, OpenLayers, OpenStreetMap and Leaflet.
• 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
• Coordinate formatting and format conversion via the #coordinates parser function.
• Geocoding via several supported services with the #geocode 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.

User manual

For administrators

• Installation and configuration
• Release notes - detailed list of changes per release
• Platform compatibility - overview of PHP and MediaWiki support per release

For wiki users

• Usage instructions
• Usage examples
• Semantic usage examples

Getting support

• Ask a question on the mailing list
• Ask a question on the #mediawiki IRC channel on Freenode.
• File an issue on our issue tracker (technical issues only)

Project status

On Packagist:

• Open bugs and feature requests
• Maps on Ohloh
• Blog posts about Maps

Contributing

• File an issue
• Submit a pull request (tasks for newcomers)

Running the tests

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

You can run the MediaWiki independent tests by changing into the Maps root directory and running

phpunit

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

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 severe technical debt, some tests access the network.

Links

• Maps examples
• Maps on Ohloh
• Maps on MediaWiki.org
• Maps on Packagist
• TravisCI build status
• Semantic Maps on MediaWiki.org