{ "info": { "author": "ZNC Sistemas", "author_email": "contato@znc.com.br", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: Portuguese (Brazilian)", "Operating System :: OS Independent", "Programming Language :: JavaScript", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Topic :: Utilities" ], "description": "==================================\nMunic\u00edpios Brasileiros para Django\n==================================\n\nAplica\u00e7\u00e3o plug\u00e1vel Django com modelos e widgets para os Munic\u00edpios Brasileiros\n\n- Form com selector Ajax\n- widget reutiliz[avel com Field specificop para modelos com campo municipio.\n\n\nInstalando o django-municipios\n==============================\n\n $ pip install django-municipios\n \nou\n \n $ easy_install django-municipios\n\nou baixar o c\u00f3digo fonte do github e rodar \"setup.py\":\n\n $ git clone git://github.com/znc-sistemas/django-municipios.git\n\n $ cd django-municipios\n\n $ python setup.py install\n\n\nDepend\u00eancias\n============\n\n * jQuery (somente para utilizar widget de sele\u00e7\u00e3o de Munic\u00edpios) \n\nUsando o django-municipios\n==========================\n\nSETTINGS\n~~~~~~~~\nadicione a aplica\u00e7\u00e3o no INSTALLED_APP no seu settings.py\n\n::\n\n INSTALLED_APPS = (\n ...\n\n 'municipios',\n\n ...\n\n )\n \n\nUtilizando dados geogr\u00e1ficos\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n \nSe for utilizar GIS adicione a vari\u00e1vel ``MUNICIPIOS_GEO``:\n\n\n:: \n \n MUNICIPIOS_GEO = True \n\n \nNo settings.py, antes de rodar o `syncdb`.\nEste par\u00e2metro habilita os campos que armazenam dados Geogr\u00e1ficos (GeoDjango).\n\nPara carregar dados geogr\u00e1ficos de todos os Munic\u00edpios e UFs baixe o arquivo de fixture \nmunicipios_geo_2013_4674.json.zip_ (110 MB), e carregue a fixture com \n\n::\n \n python manage.py loaddata municipios_geo_900913.json.bz2\n\n.. _municipios_geo_2013_4674.json.zip: https://github.com/znc-sistemas/django-municipios/releases/download/0.8.1/municipios_geo_2013_4674.json.zip\n \n \nUtilizando o widget de Sele\u00e7\u00e3o de Munic\u00edpios\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ \n\n::\n\n from django import forms\n from municipios.widgets import SelectMunicipioWidget\n\n class FormEndereco(forms.Form):\n municipio = forms.IntegerField(label=u\"UF - Munic\u00edpio\", widget=SelectMunicipioWidget)\n\n\nView\n~~~~\n\n::\n\n def teste(request):\n form = FormEndereco()\n return render_to_response('endereco/teste.html', \n {'form':form,}, context_instance = RequestContext(request))\n\n\nTemplate\n~~~~~~~~ \n1. Inclua o jquery no seu template, ou adicione ao media do seu Form.\n2. form.media - o widget depende de codigo js para funcionar o ajax\n\n::\n\n \n\n {{ form.media }}\n\n {{ form }}\n\n\nTemplate para o widget\n~~~~~~~~~~~~~~~~~~~~~~ \nA partir da vers\u00e3o 0.8.0 \u00e9 poss\u00edvel customizar o template utilizado para apresentar o widget.\nOs templates identificados pela aplica\u00e7\u00e3o s\u00e3o :\n\n1. municipio_field.html\n2. uf_field.html\n\ne o nome da vari\u00e1vel a ser substitu\u00edda \u00e9 ``{{wselect}}``\n\n ex.: de template para BootStrapTwitter\n\n::\n\n