Aplicação plugável Django com modelos e widgets para os Municípios Brasileiros
Project description
Aplicação plugável Django com modelos e widgets para os Municípios Brasileiros
Form com selector Ajax
widget reutiliz[avel com Field specificop para modelos com campo municipio.
Instalando o django-municipios
$ pip install django-municipios
ou
$ easy_install django-municipios
ou baixar o código fonte do github e rodar “setup.py”:
$ git clone git://github.com/znc-sistemas/django-municipios.git
$ cd django-municipios
$ python setup.py install
Dependências
jQuery (somente para utilizar widget de seleção de Municípios)
Usando o django-municipios
SETTINGS
adicione a aplicação no INSTALLED_APP no seu settings.py
INSTALLED_APPS = ( ... 'municipios', ... )
Utilizando dados geográficos
Se for utilizar GIS adicione a variável MUNICIPIOS_GEO:
MUNICIPIOS_GEO = True
No settings.py, antes de rodar o syncdb. Este parâmetro habilita os campos que armazenam dados Geográficos (GeoDjango).
Para carregar dados geográficos de todos os Municípios e UFs baixe o arquivo de fixture municipios_geo_2013_4674.json.zip (110 MB), e carregue a fixture com
python manage.py loaddata municipios_geo_900913.json.bz2
Utilizando o widget de Seleção de Municípios
from django import forms from municipios.widgets import SelectMunicipioWidget class FormEndereco(forms.Form): municipio = forms.IntegerField(label=u"UF - Município", widget=SelectMunicipioWidget)
View
def teste(request): form = FormEndereco() return render_to_response('endereco/teste.html', {'form':form,}, context_instance = RequestContext(request))
Template
Inclua o jquery no seu template, ou adicione ao media do seu Form.
form.media - o widget depende de codigo js para funcionar o ajax
<script type="text/javascript" src="{{ STATIC_URL }}js/jquery.min.js"></script> {{ form.media }} {{ form }}
Template para o widget
A partir da versão 0.8.0 é possível customizar o template utilizado para apresentar o widget. Os templates identificados pela aplicação são :
municipio_field.html
uf_field.html
e o nome da variável a ser substituída é {{wselect}}
ex.: de template para BootStrapTwitter
<div class="control-group"> <div class="controls"><label>Município</label> {{wselect}} </div> </div>
adicione o HTML acima em um template dentro de por exemplo <app>/municipios/templates/municipios/municipio_field.html
URLs
Adicionar as urls da aplicação no arquivo definido pelo ROOT_URLCONF do setings.py.
( ... url(r'^municipios_app/', include('municipios.urls')), ... )
Arquivos Estáticos
Para o funcionamento do widget de seleção de municípios em ambiente de produção é necessário utilizar o comando collectstatic do Static Files.
History
0.8.1 (2014-01-10)
setup.py refatorado
adicionado arquivos de licença, contribuidores, historico e como contribuir
modificado urls.py para tentar importar primeiro as funcoes do django > 1.4
0.5.0 (2011)
First release on PyPI.
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.