Skip to main content

Universal maps plugin for django CMS

Project description

Build status Code health Python versions Monthly downloads from PyPI Software license Gitter chat room

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

CHANGELOG

0.1.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

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page