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
Mapbox.js / Leaflet.js: - API docs - examples - Leaflet API docs
ViaMichelin: - API docs
CHANGELOG
0.13.0 (2021-03-21)
Run tests with a test project against all modern Python + Django + CMS combinations
Remove u-strings and dependency on six (backward-compatibility for Python 2)
Fix ImportError on django CMS 3.8.0 (thanks @arnodeceuninck)
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.
Source Distribution
Built Distribution
Hashes for djangocms_maps-0.13.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3a3a1c4825e14d699966a1e0fbfe8ae6c109d254e074d3702c326aa10ad99f2d |
|
MD5 | 2dda16a55652dedc043532fbdd1e8a7c |
|
BLAKE2b-256 | cbd441bcce4da5b57a77e530ba2b5c29365617ac022d6b897b271355dbe5f89b |