Universal maps plugin for django CMS
Project description
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
- Bing: - Dev Center - docs overview - 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.12.0 (2020-02-04)
- Adjust migrations for Django 2+ (thanks @macolo)
- Fix some code smell in JS reported by Codacy
- Allow jshint to run locally (via tox)
0.11.0 (2019-05-08)
- Add aldryn_config.py to make plugin visible on Divio marketplace
- Reformat code (inital migrations, models, forms, templatetags)
0.10.0 (2019-01-30)
- Convert float to string before evaluating (thanks @mireq)
0.9.0 (2019-01-12)
- Don’t show map title when it’s blank (thanks @adrien-delhorme)
0.8.0 (2018-03-04)
- Fix float rounding error for map coordinates on German sites (which use a colon instead of a period)
- Configure HERE WeGo to use HTTPS by default
0.7.0 (2016-09-14)
- Implement ViaMichelin provider
0.6.0 (2016-09-02)
- Allow to display or hide layers control and scale bar
- Implement HERE WeGo provider
- Bugfix: Allow keyboard navigation (Mapbox)
- Run static code analysis for all supported Python versions
- Implement Bing Maps provider
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size djangocms_maps-0.12.0-py3-none-any.whl (216.8 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size djangocms-maps-0.12.0.tar.gz (58.1 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for djangocms_maps-0.12.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 24ee667588433194bbd8cc2a130f566b848485770414ef7993c2a21e0a1f3f30 |
|
MD5 | 9474fe5256dbbd215b1b35af0806b643 |
|
BLAKE2-256 | 2db82e31579c04b76ebf904a921fff7ff38882c00a3637d88a02fc19bff9c99a |