Metadata-Version: 1.1
Name: fluentcms-googlemaps
Version: 1.1
Summary: Google Maps widget for django-fluent-contents
Home-page: https://github.com/edoburu/fluentcms-googlemaps
Author: Diederik van der Boor
Author-email: opensource@edoburu.nl
License: Apache 2.0
Download-URL: https://github.com/edoburu/fluentcms-googlemaps/zipball/master
Description: fluentcms-googlemaps
        ====================
        
        A plugin for django-fluent-contents_ to show a Google Maps widget on a website.
        
        This plugin is a work in progress.
        It's already used in production, just know that there are two main area's that need improval:
        
        * Use a better GeoPosition widget (e.g. by using a lightbox/popup)
        * Make cluster icons configurable.
        
        
        Installation
        ============
        
        First install the module, preferably in a virtual environment. It can be installed from PyPI::
        
            pip install fluentcms-googlemaps
        
        
        Backend Configuration
        ---------------------
        
        First make sure the project is configured for django-fluent-contents_.
        
        Then add the following settings::
        
            INSTALLED_APPS += (
                'fluentcms_googlemaps',
            )
        
        Add the following to ``urls.py``::
        
            urlpatterns = [
                ...
        
                url(r'^api/googlemaps/', include('fluentcms_googlemaps.urls')),
            ]
        
        The database tables can be created afterwards::
        
            ./manage.py migrate
        
        Now, the ``MapPlugin`` can be added to your ``PlaceholderField``
        and ``PlaceholderEditorAdmin`` admin screens.
        
        
        Frontend Configuration
        ----------------------
        
        Make sure that all plugin media files are exposed by django-fluent-contents_::
        
            {% load frontend_contents_tags %}
        
            {% render_content_items_media %}
        
        This tag should be placed at the bottom of the page, after all plugins are rendered.
        For more configuration options - e.g. integration with django-compressor -
        see the `template tag documentation <http://django-fluent-contents.readthedocs.org/en/latest/templatetags.html#frontend-media>`_.
        
        CSS Code
        ~~~~~~~~
        
        The stylesheet code is purposefully left out, since authors typically like to provide their own styling.
        
        JavaScript Code
        ~~~~~~~~~~~~~~~
        
        No configuration is required for the JavaScript integration.
        
        By default, the plugin includes all required JavaScript code.
        
        If needed, the includes resources can be changed by using the following settings::
        
            MAP_MARKERWITHLABEL_JS = "fluentcms_googlemaps/vendor/markerwithlabel.js"
            MAP_MARKERCLUSTERER_JS = "fluentcms_googlemaps/vendor/markerclusterer_compiled.js"
            MAPPLUGIN_JS = "fluentcms_googlemaps/js/mapplugin.js"
            MAPSEARCH_JS = "fluentcms_googlemaps/js/mapsearch.js"
        
            FLUENTCMS_GOOGLEMAPS_JS = (
                MAP_MARKERWITHLABEL_JS,
                MAP_MARKERCLUSTERER_JS,
                MAPPLUGIN_JS,
            )
        
            FLUENTCMS_GOOGLEMAPS_CSS = {}
        
        If a value is defined as ``None``, it will be excluded from the frontend media.
        
        HTML code
        ~~~~~~~~~
        
        If needed, the HTML code can be overwritten by redefining ``fluentcms_googlemaps/maps/default.html``.
        Also, you can create additional map styles and define these in ``FLUENTCMS_GOOGLEMAPS_STYLES``.
        The default is::
        
            FLUENTCMS_GOOGLEMAPS_STYLES = (
                ('default', {
                    'title': _("Default"),
                    'template': "fluentcms_googlemaps/maps/default.html",
                }),
                ('search', {
                    'title': _("Search field"),
                    'template': "fluentcms_googlemaps/maps/search.html",
                    'extra_js': (
                        MAPSEARCH_JS,   # = "fluentcms_googlemaps/js/mapsearch.js" unless MAPSEARCH_JS is redefined
                    ),
                }),
            )
        
        By default, the following templates are looked up:
        
        * A explicitly defined ``template`` option in the ``FLUENTCMS_GOOGLEMAPS_STYLES``.
        * A template named: ``fluentcms_googlemaps/maps/{style}.html``.
        * The default; ``fluentcms_googlemaps/maps/default.html``.
        
        
        Contributing
        ------------
        
        If you like this module, forked it, or would like to improve it, please let us know!
        Pull requests are welcome too. :-)
        
        .. _django-fluent-contents: https://github.com/edoburu/django-fluent-contents
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.4
Classifier: Framework :: Django :: 1.5
Classifier: Framework :: Django :: 1.6
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires: Django (>=1.4)
