djangocms-maps 0.5.0

Universal maps plugin for django CMS

A universal maps plugin for django CMS, supporting all major map providers.

Supported online map providers:

• Mapbox OpenStreetMap powered by Leaflet.js

• Bing Maps

• Google Maps

• HERE WeGo

• ViaMichelin

As of today (2016) all map providers require an API key.

Installation

This plugin requires django CMS 3.3 (and Django 1.8) or above.

• In your project’s virtualenv, run pip install djangocms-maps.

• Add 'djangocms_maps' to your INSTALLED_APPS setting.

• Run manage.py migrate djangocms_maps.

Configuration

MAPS_PROVIDERS

Optional. Allows you to specify the providers you want to offer, their display labels and sort order in the user interface. Put a provider on top of the list to make it the default. Default:

MAPS_PROVIDERS = [
    ('mapbox', _('Mapbox OSM (API key required)')),
    ('bingmaps', _('Bing Maps (API key required)')),
    ('googlemaps', _('Google Maps (API key required)')),
    ('here', _('HERE WeGo (API key required)')),
    ('viamichelin', _('ViaMichelin (API key required)')),
]

MAPS_BINGMAPS_API_KEY

API key for Bing Maps (required for using Bing Maps).

MAPS_GOOGLEMAPS_API_KEY

API key for Google Maps (required for using Google Maps).

MAPS_HERE_API_KEY

API key for HERE WeGo (required for using HERE maps).

MAPS_MAPBOX_API_KEY

Access token for Mapbox (required for using OSM maps with Mapbox tile layers).

MAPS_VIAMICHELIN_API_KEY

API key for ViaMichelin (required for using ViaMichelin maps).

Translations

If you want to help translate the plugin please do it on transifex.

Developer Resources

• Bing: - Dev Center - API docs - examples

• Google: - API docs

• HERE: - API docs - examples

• Mapbox.js / Leaflet.js: - API docs - examples - Leaflet API docs

• ViaMichelin: - API docs

CHANGELOG

0.5.0 (2016-09-01)

• Fork djangocms-googlemap plugin, remove legacy burden

• Refactor template structure for multi-provider support

• Remove routing options from plugin UI (plan: re-implement on the map)

• Reorganice plugin UI to avoid excessive scrolling

• Add settings (API keys) for Google Maps and all future providers

• Implement Mapbox provider

• Add stubs for Bing, HERE, ViaMichelin

before 0.5.0

• See change log of Divio’s djangocms-googlemap.