Maps plugin for django CMS 3
Clone or download
Pull request Compare This branch is 31 commits ahead, 51 commits behind divio:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.tx
djangocms_maps
.gitignore
.travis.yml
CHANGELOG.rst
LICENSE.txt
MANIFEST.in
README.rst
setup.py
tox.ini
updatetranslations.sh

README.rst

djangocms-maps Latest version on PyPI

Build status Code health Python versions 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

All map providers require an API key, which you usually get for free by creating a developer account (using the links below).

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 = [ ('<str>', '<str>'), ... ]

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 = '<str>'

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

MAPS_GOOGLEMAPS_API_KEY = '<str>'

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

MAPS_HERE_API_KEY = {'app_id': '<str>', 'app_code': '<str>'}

APP_ID and APP_CODE for HERE WeGo (required for using HERE maps).

MAPS_MAPBOX_API_KEY = '<str>'

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

MAPS_VIAMICHELIN_API_KEY = '<str>'

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

Examples

Organice Demo:

https://demo.organice.io/about/directions/

Your maps plugin playground! Allows you to directly edit and view (albeit not to publish) changes on the maps plugin after authenticating.

Translations

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

Developer Resources