Metadata-Version: 1.1
Name: wagtailgmaps
Version: 0.2.4
Summary: Google Maps widget for address fields in Wagtail
Home-page: https://github.com/springload/wagtailgmaps/
Author: Jordi J. Tablada
Author-email: jordi@springload.co.nz
License: BSD License
Description: wagtailgmaps
        ==================
        
        ![Wagtailgmaps screenshot](http://i.imgur.com/9m9Gfcf.png)
        
        Simple Google Maps address formatter and LatLng provider for Wagtail fields.
        
        # Quickstart
        
        Assuming you have a [Wagtail](https://wagtail.io/) project up and running:
        
        ``` $ pip install wagtailgmaps```
        
        add wagtailgmaps to your `settings.py` in the INSTALLED_APPS section:
        
        ```
        ...
            'modelcluster',
            'wagtailgmaps',
            'wagtail.contrib.wagtailsitemaps',
        ...
        ```
        
        Add a couple of necessary constants in your `settings.py` file:
        
        ```
        ...
        WAGTAIL_ADDRESS_MAP_CENTER = 'Wellington, New Zealand'
        WAGTAIL_ADDRESS_MAP_ZOOM = 8
        ...
        ```
        `WAGTAIL_ADDRESS_MAP_CENTER` must be a properly formatted address. Also, remember valid zoom levels go from 0 to 18. See [Map options](https://developers.google.com/maps/documentation/javascript/tutorial#MapOptions) for details.
        
        As for now, only fields using `FieldPanel` inside a `MultiFieldPanel` are supported. This is due to the lack of support of the `classname` attribute for other panel fields other than `MultiFieldPanel`.
        
        In your `models.py`, your custom Page model would have something similar to:
        
        ```
        address_panels = MultiFieldPanel([
            FieldPanel('address', classname="gmap"),
        ], heading="Street Address")
        ```
        
        Notice the `FieldPanel` is embedded in a `MultiFieldPanel`, even if it only contains a single element. If you define your `FieldPanel` outside it won't work. The app supports more than one map (field) at the same time.
        
        If instead of outputting a formatted address, you want to output a LatLng, you should add `gmap--latlng` modifier class to the panel:
        
        ```
        latlng = models.CharField(max_length=255)
        
        panels = [
            MultiFieldPanel([
                FieldPanel('latlng', classname="gmap gmap--latlng"),
            ], heading="Map location"),
        ]
        ```
        
        When editing the model from the admin interface the affected field shows up with a map, like the screenshot above.
        
        If using the address option, the field gets updated according to the [Google Geocoding Service](https://developers.google.com/maps/documentation/geocoding/) each time:
        
        * The map market gets dragged and dropped into a location (`dragend` JS event).
        * Click happens somewhere in the map (`click` JS event).
        * Return key is pressed after editing the field (`enterKey` JS event for return key only).
        
        Feel free to edit the provided JS to add/edit the events you might need.
        
        Once your address field is properly formatted and stored in the database you can use it in your front end Django templates. Example:
        
        ```
        <a href="http://maps.google.com/?q={{ address }}">Open map</a>
        ```
        
        Or if you opted for the LatLng pair option:
        
        ```
        <a href="http://maps.google.com/?q={{ latlng }}">Open map</a>
        ```
        
Platform: UNKNOWN
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: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
