Google Maps widget for address fields in Wagtail
Project description
wagtailgmaps
==================
![Wagtailgmaps screenshot](http://i.imgur.com/9m9Gfcf.png)
Simple Google Maps address formatter 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.
When editing the model from the admin interface the affected field shows up with a map, like the screenshot above.
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>
```
==================
![Wagtailgmaps screenshot](http://i.imgur.com/9m9Gfcf.png)
Simple Google Maps address formatter 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.
When editing the model from the admin interface the affected field shows up with a map, like the screenshot above.
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>
```
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
wagtailgmaps-0.2.2.tar.gz
(6.4 kB
view hashes)
Built Distribution
Close
Hashes for wagtailgmaps-0.2.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ab155e2ee75176bc9757c5d5175828108121b20a7acbe2e5e2cc550432434e0 |
|
MD5 | f4a463b2ddce1b7d4a93b05b7df8670c |
|
BLAKE2b-256 | 34ef42cd6948753f27da7fe8fbca62a7b3ba49f8134608e4e95f3b84f41233e2 |