django-municipios 0.8.1

Aplicação plugável Django com modelos e widgets para os Municípios Brasileiros

Aplicação plugável Django com modelos e widgets para os Municípios Brasileiros

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_900913.json.bz2 (27.5 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

  1. Inclua o jquery no seu template, ou adicione ao media do seu Form.
  2. 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 :

  1. municipio_field.html
  2. 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.

Nota

A partir da versão 1.4 do Django o prefixo da url pode ser qualquer um, nas versões anteriores é necessário utilizar o prefixo "muncipios_app".

(

...

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.
MIT

Author

ZNC Sistemas

Pip

django-municipios==0.8.1

Classifiers

  • Topic :: Utilities
  • Programming Language :: Python
  • Programming Language :: JavaScript
  • Operating System :: OS Independent
  • Natural Language :: Portuguese (Brazilian)
  • License :: OSI Approved :: MIT License
  • Intended Audience :: Developers
  • Framework :: Django
  • Environment :: Web Environment
  • Development Status :: 5 - Production/Stable
File Type Python Version Uploaded On Downloads
django-municipios-0.8.1.tar.gz Source Jan. 16, 2014 1,101
Version Release Date
0.8.1 Jan. 16, 2014
0.8.0 April 19, 2013
0.7.1 June 15, 2012
0.7 June 15, 2012
0.6 June 15, 2012
0.5 Nov. 4, 2014
Date Package Version Action
Nov. 4, 2014, 1:29 p.m. django-municipios 0.7.1 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios 0.6 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios 0.7 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios 0.8.0 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios 0.5 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios 0.8.1 Release Created
Nov. 4, 2014, 1:29 p.m. django-municipios Package Created