Os add-ons “django.contrib”¶

O Django procura seguir a filosofia Python das “baterias incluídas”. Ele vem com uma variedade de extras, ferramentas opcionais que resolvem os problemas comuns ao desenvolvimento web.

O código está em django/contrib na distribuição do Django. Este documento apresenta um resumo dos pacotes contrib, juntamente com as suas possíveis dependências.

Nota

A maioria desses add-ons – especificamente, os add-ons que incluem models ou template tags – você precisará adicionar o nome do pacote (e.x., 'django.contrib.admin') a sua configuração INSTALLED_APPS e executar manage.py syncdb.

admin¶

A interface administrativa automática do Django. Para mais informações, veja Tutorial 2 e a documentação do admin.

Precisa que os pacotes contrib auth e contenttypes estejam instalados.

auth¶

O framework de autenticação do Django.

Veja Autenticação de Usuário no Django.

comments¶

O aplicativo de comentários foi reescrito. Veja Atualizando o sistema de comentários de um Django anterior para informações sobre como atualizar seu código.

Um simples e flexível sistema de comentários. Veja Framework de comentários do Django.

contenttypes¶

Um framework leve para a conexão de “tipos” de conteúdo, onde cada model Django instalado é um tipo de coneteúdo diferente.

Veja a documentação do contenttypes.

csrf¶

Um middleware para prevenir Cross Site Request Forgeries.

Veja a documentação csrf.

flatpages¶

Um framework para gerenciar simples conteúdo HTML “planos” no banco de dados.

Veja a documentação flatpages.

Precisa que o pacote contrib sites seja instalado também.

formtools¶

Um conjunto de abstrações de alto nível para os forms Django (django.forms).

django.contrib.formtools.preview¶

Uma abstração para o seguinte fluxo:

“Exibe um formulário HTML, força um preview, então faça algo com a submissão.”

Veja a documentação do form preview.

django.contrib.formtools.wizard¶

Divide um form em várias páginas.

Veja a documentação do assistente de formulários.

humanize¶

Um conjunto de template filters úteis para adicionar um “toque humano” aos dados.

Veja a documentação do humanize.

localflavor¶

Uma coleção de vários snippets que são úteis somente para um país ou cultura. Por exemplo, django.contrib.localflavor.us.forms contém um USZipCodeField que você pode usar para validar zip codes dos Estado Unidos.

Veja a documentação localflavor.

markup¶

Uma coleção de template filters que implementam as linguagens de marcação mais comuns:

textile – implementa Textile
markdown – implementa Markdown
restructuredtext – implementa ReST (ReStructured Text)

Em cada caso, o filtro espera por uma marcação formatada como string e retorna uma string representando o texto processado. Por exemplo, o filtro textile converte texto escrito no formato Textile em HTML.

Para ativar esses filtros, adicione 'django.contrib.markup' às suas INSTALLED_APPS. Uma vez adicionado, use {% load markup %} em um template, e você terá acesso à esses filtros. Para mais documentação, leia o código fonte em django/contrib/markup/templatetags/markup.py.

redirects¶

Um framework para gerenciar redirecionamentos.

Veja a documentação de redirects.

sessions¶

Um framework para armazenar dados em sessões anônimas.

Veja a documentação de sessões.

sites¶

Um framework leve que permite que você gerencie múltiplos web sites no mesmo banco de dados e instalação do Django. Ele te dá ganchos para associar objetos a um ou mais sites.

Veja a documentação de sites.

sitemaps¶

Um framework para gerar arquivos XML no formato de sitemap do Google.

Veja a documentação de sitemaps.

syndication¶

Um framework para gerar feed, em RSS e Atom, facilmente.

Veja a documentação do syndication.

webdesign¶

Ajudantes que são particularmente úteis à web designers, e não desenvolvedores web.

Veja a documentação dos ajudantes de web design.

Outros add-ons¶

Se você tem uma idéia de funcionalidade para incluir no contrib, nos conte! Codifique-a e poste na django-users mailing list.