django-municipios 1.2.1

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

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.

(

...

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.