Metadata-Version: 1.0
Name: django-municipios
Version: 0.7
Summary: Aplicação plugável Django com modelos e widgets para os Municípios Brasileiros
Home-page: https://github.com/znc-sistemas/django-municipios
Author: ZNC Sistemas
Author-email: contato@znc.com.br
License: UNKNOWN
Description: ==================================
        Municípios Brasileiros para Django
        ==================================
        
        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',
        
                ...
        
            )
          
            
        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) 
            
            
        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.
        2. form.media - o widget depende de codigo js para funcionar o ajax
        
        ::
        
            <script type="text/javascript" src="{{ STATIC_URL }}js/jquery-1.5.2.min.js"></script>
        
            {{form.media}}
        
            {{form}}
        
        
        URLs
        ~~~~
        1. Adiciona o staticfiles.urls . O Widget depende de um arquivo javascript incluso no widget
        2. url "municipios_app" - por enquanto é ncessário a utilização desta url para inclusão correta do template 
        
        ::
        
            (
        
            ...
        
            url(r'^municipios_app/', include('municipios.urls')),
        
            url(r'^teste/', 'endereco.views.teste', name='teste'),
        
            ...
        
            )
        
            from django.contrib.staticfiles.urls import staticfiles_urlpatterns
        
            urlpatterns += staticfiles_urlpatterns()
        
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: JavaScript
Classifier: Topic :: Utilities
Classifier: Natural Language :: Portuguese (Brazilian)
