Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erdem/django-map-widgets
Pluggable map widgets for Django Postgis fields
https://github.com/erdem/django-map-widgets
django-admin django-map-widgets map-widgets
Last synced: about 2 months ago
JSON representation
Pluggable map widgets for Django Postgis fields
- Host: GitHub
- URL: https://github.com/erdem/django-map-widgets
- Owner: erdem
- License: mit
- Created: 2016-02-21T14:27:13.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-05-28T19:58:56.000Z (7 months ago)
- Last Synced: 2024-05-29T10:49:25.216Z (7 months ago)
- Topics: django-admin, django-map-widgets, map-widgets
- Language: JavaScript
- Homepage:
- Size: 7.79 MB
- Stars: 436
- Watchers: 21
- Forks: 121
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://coveralls.io/github/erdem/django-map-widgets?branch=master)
[](https://travis-ci.org/erdem/django-map-widgets)
[](https://badge.fury.io/py/django-map-widgets)
### Django Map Widgets
Configurable, pluggable and more user friendly map widgets for Django PostGIS fields.
* **Documentation**: http://django-map-widgets.readthedocs.io/
* **Project Home Page**: https://github.com/erdem/django-map-widgets/
### Achievements
The aim of the Django map widgets is to make all Geo Django widgets more user-friendly and configurable.
Django map widgets package has support for Mapbox and Google Map services currently, if you want to see more widgets and think you can help, feel free to contribute to the project.
We would be happy to review and merge your contributions. :)
### Installation
pip install django-map-widgets
Add ‘map_widgets’ to your `INSTALLED_APPS` in settings.py
```python
INSTALLED_APPS = [
...
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'mapwidgets',
]
```
Collects the static files into `STATIC_ROOT`.
```bash
python manage.py collectstatic
```
**Django Admin**
```python
from django.contrib.gis.db import models
from mapwidgets.widgets import GooglePointFieldWidget
class CityAdmin(admin.ModelAdmin):
formfield_overrides = {
models.PointField: {"widget": GooglePointFieldWidget}
}
```
**Django Forms**
```python
from mapwidgets.widgets import GooglePointFieldWidget, GoogleStaticOverlayMapWidget
class CityForm(forms.ModelForm):
class Meta:
model = City
fields = ("coordinates", "city_hall")
widgets = {
'coordinates': GooglePointFieldWidget,
'city_hall': GoogleStaticOverlayMapWidget,
}
```
...and your template should look something like this
```html
{% csrf_token %}
{{form.media}}
{{form.as_p}}
```
### Requirements
Django Map Widgets needs Jquery dependency to work in your regular views. In Django Admin case, you don't need to provide the jQuery.
Just add map widgets to your django admin forms.
### Screenshots
##### Google Map Point Field Widget
##### MapBox Map Point Field Widget
##### Google Map Static Overlay Widget
This widget is working with Magnific Popup jQuery plugin.
### Release Notes
#### 0.4.2
> - GooglePointFieldInlineWidget bug fixes for Django 4.2.x (#142), thanks for @isarota.
> - Added `.readthedocs.yaml` to cover new **Read the Docs** updates.
#### 0.4.1
> - Added scroll wheel zooming functionality switch to Google Point Map Settings. (#134)
> - Added Chinese(ZH) localisation support. (#133)
#### 0.4.0
> - Supported MapBox Map for Django Geo Point Field.
> - Fixed undefined place object binding issue in javascript triggers. (#125)
> - Documented MapBox point field map widget features.
> - Updated various localize files.
#### 0.3.3
> - Replaced [ugettext_lazy](https://github.com/erdem/django-map-widgets/pull/127) usages with [gettext_lazy](https://docs.djangoproject.com/en/4.0/releases/4.0/#features-removed-in-4-0) for Django 4.0. (#127)
> - Updated [Travis CI file](https://github.com/erdem/django-map-widgets/pull/129). (#129)
#### 0.3.2
> - Added [streetViewControl](https://developers.google.com/maps/documentation/javascript/streetview#StreetViewMapUsage) switch to GooglePointFieldWidget settings. (#124)
#### 0.3.1
> - Removed `six` package usages. (#117)
> - Added a new general widget setting in order to specify Google JS libraries. (#119)
> - Implemented some improvements for the demo project.
#### 0.3.0
> - Implemented a new demo project with Django 2.x.
> - Fixed Django Admin jQuery conflicts. (#100)
> - Fixed a new widget JS instance initialising issue for Django Admin Inlines. (#84)
> - Added Python 3.8 env settings to TravisCI configuration.
[See release notes](https://django-map-widgets.readthedocs.io/en/mapbox_widget_fixes/releases/index.html) for all versions.