Metadata-Version: 2.1
Name: djangocms-maps
Version: 0.13.0
Summary: Universal maps plugin for django CMS
Home-page: https://github.com/Organice/djangocms-maps
Author: Peter Bittner
Author-email: django@bittner.it
License: BSD
Description: ===============================
        djangocms-maps |latest-version|
        ===============================
        
        |build-status| |health| |python-support| |license| |gitter|
        
        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:**
        
        .. code-block:: python
        
            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 <https://www.bingmapsportal.com/>`__
          - `docs overview <https://msdn.microsoft.com/en-us/library/dd877180.aspx>`__
          - `API docs <https://msdn.microsoft.com/en-us/library/mt712552.aspx>`__
          - `examples <http://www.bing.com/api/maps/sdk/mapcontrol/isdk>`__
        - Google:
          - `API docs <https://developers.google.com/maps/documentation/javascript/>`__
        - HERE:
          - `API docs <https://developer.here.com/javascript-apis/documentation/v3/maps/topics/api-reference.html>`__
          - `examples <https://developer.here.com/api-explorer/maps-js/>`__
        - Mapbox.js / Leaflet.js:
          - `API docs <https://www.mapbox.com/mapbox.js/api/>`__
          - `examples <https://www.mapbox.com/mapbox.js/examples/>`__
          - `Leaflet API docs <http://leafletjs.com/reference.html>`__
        - ViaMichelin:
          - `API docs <http://dev.viamichelin.com/map-service.html>`__
        
        
        .. |latest-version| image:: https://img.shields.io/pypi/v/djangocms-maps.svg
           :alt: Latest version on PyPI
           :target: https://pypi.python.org/pypi/djangocms-maps
        .. |build-status| image:: https://img.shields.io/travis/Organice/djangocms-maps/master.svg
           :alt: Build status
           :target: https://travis-ci.org/Organice/djangocms-maps
        .. |health| image:: https://img.shields.io/codacy/grade/4ffaf0c75cff489682f4184676785e03/master.svg
           :target: https://www.codacy.com/app/Organice/djangocms-maps
           :alt: Code health
        .. |python-support| image:: https://img.shields.io/pypi/pyversions/djangocms-maps.svg
           :target: https://pypi.python.org/pypi/djangocms-maps
           :alt: Python versions
        .. |license| image:: https://img.shields.io/pypi/l/djangocms-maps.svg
           :alt: Software license
           :target: https://github.com/Organice/djangocms-maps/blob/master/LICENSE.txt
        .. |gitter| image:: https://badges.gitter.im/Organice/djangocms-maps.svg
           :alt: Gitter chat room
           :target: https://gitter.im/Organice/chat
        
        .. _Leaflet.js: http://leafletjs.com/
        .. _django CMS: https://github.com/divio/django-cms
        .. _virtualenv: https://virtualenv.pypa.io/en/stable/
        .. _API key for Bing Maps: https://msdn.microsoft.com/en-us/library/mt712556.aspx
        .. _API key for Google Maps:
            https://developers.google.com/maps/documentation/javascript/get-api-key
        .. _APP_ID and APP_CODE for HERE WeGo:
            https://developer.here.com/javascript-apis/documentation/v3/maps/common/credentials.html
        .. _Access token for Mapbox: https://www.mapbox.com/help/create-api-access-token/
        .. _API key for ViaMichelin:
            http://business-solutions.travel.michelin.com/contact-us/open-a-free-api-test-account.html
        .. _transifex: https://www.transifex.com/divio/djangocms-maps/
        
        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_.
        
        .. _djangocms-googlemap: https://github.com/divio/djangocms-googlemap/blob/master/CHANGELOG.rst
        
Platform: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Communications
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Message Boards
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/x-rst
