Configurações disponíveis¶
Aqui temos uma lista completa de todas as configurações disponíveis, em ordem alfabética, e seus valores padrãos.
ABSOLUTE_URL_OVERRIDES¶
Padrão: {}
(Dicionário vazio)
Um mapeamento de strings num dicionário "app_label.model_name"
para funções
que recebem um objeto model e retornam sua URL. Esta é a forma de sobrescrever
métodos get_absolute_url()
numa instalação básica. Exemplo:
ABSOLUTE_URL_OVERRIDES = {
'blogs.weblog': lambda o: "/blogs/%s/" % o.slug,
'news.story': lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),
}
Perceba que o nome do model usado nesta configuração deve ser todo em minúsculo, indiferente da configuração do nome da classe atual do model.
ADMIN_FOR¶
Padrão: ()
(Tupla vazia)
Usado para configurar módulos do site admin, ele deve ser uma tupla de módulos
de configuração (no formato 'foo.bar.baz'
) para que este site esteja no
admin.
O site admin usa isto na introspecção automática de documentação dos models, views e tags de templates.
ADMIN_MEDIA_PREFIX¶
Padrão: '/media/'
Prefixo de URL para as mídias do admin – CSS, Javascript e imagens usadas
pela interface adminstrativa do Django. Assegure-se de usar um barra no final
do caminho, e de ele ser diferente da configuração MEDIA_URL
(uma vez que
uma mesma URL não pode ser mapeada para dois conjuntos diferentes de arquivos).
ADMINS¶
Padrão: ()
(Tupla vazia)
Uma tupla que lista pessoas que receberam notificações de erro. Quando o
DEBUG=False
e uma view lança uma exceção, o Django enviará um e-mail para
estas pessoas com a informação completa da exceção. Cada item da tupla deve
ser uma tupla com (Nome completo, endereço de e-mail). Exemplo:
(('John', 'john@example.com'), ('Mary', 'mary@example.com'))
Perceba que o Django enviará um e-mail para todos que estiverem na lista, toda vez que um erro ocorrer. Veja Reporte de erros via e-mail para mais informações.
ALLOWED_INCLUDE_ROOTS¶
Padrão: ()
(Tupla vazia)
Uma tupla de strings representando prefixos permitidos para a template tag
{% ssi %}
. Esta é uma medida de segurança, de modo que os autores de
templates não possam acessar arquivos que não deveriam acessar.
Por exemplo, se ALLOWED_INCLUDE_ROOTS
é ('/home/html', '/var/www')
,
então o {% ssi /home/html/foo.txt %}
funcionaria, mas
{% ssi /etc/passwd %}
não.
APPEND_SLASH¶
Padrão: True
Para atachar uma barra ao final das URLS. Isto é utilizado somente se o
CommonMiddleware
estiver instalado (veja Middleware).
veja também PREPEND_WWW
.
AUTHENTICATION_BACKENDS¶
Padrão: ('django.contrib.auth.backends.ModelBackend',)
Uma tupla de classes de backend de autenticação (como strings) para serem usadas nas tentativas de autenticação de usuários. Veja a documentação de backends de autenticação para mais detalhes.
AUTH_PROFILE_MODULE¶
Padrão: Not defined
O model de “profile” de usuário específico para um site, e usado para este site. Veja Armazenando informações adicionais sobre usuários.
CACHE_BACKEND¶
Padrão: 'locmem://'
O backed de cache a ser utilizado. Veja O framework de cache do Django.
CACHE_MIDDLEWARE_KEY_PREFIX¶
Padrão: ''
(Empty string)
A chave de prefixo do cache, que o middleware de cache deverá usar. Veja O framework de cache do Django.
CACHE_MIDDLEWARE_SECONDS¶
Padrão: 600
O número padrão de segundos para fazer cache e uma página quando o middleware de
cache ou o decorador chache_page()
for usado.
DATABASE_ENGINE¶
Padrão: ''
(Empty string)
O backend de banco de dados a ser utilizado. Os backends de banco de dados
embutidos no Django são 'postgresql_psycopg2'
, 'postgresql'
,
'mysql'
, 'sqlite3'
, e 'oracle'
.
Você pode usar um backend de banco de dados que não é entregue com o Django
setando o DATABASE_ENGINE
com um caminho completo (i.e.
mypackage.backends.whatever
). Escrever todo um novo backend de banco de
dados do zero é deixado como um exercício para o leitor; estude os outros
backends como exemplos.
DATABASE_HOST¶
Padrão: ''
(Empty string)
Qual host será usado quando conectar-se a um banco de dados. Uma string vazia significa localhost. Não é utilizado com SQLite.
Se este valor começa com um uma barra ('/'
) e você estiver usando MySQL,
o MySQL se conectará a um socket Unix no socket especificado. Por exemplo:
DATABASE_HOST = '/var/run/mysql'
Se você estiver usando o MySQL e este valor não começar com uma barra, então este valor é assumido como um host.
Se você estiver usando o PostgreSQL, uma string vazia significa usar um socket
de domínio Unix para a conexão, ao invés de uma conexão de rede para localhost.
Se você precisa ser explícito em usar uma conexão TCP/IP na máquina local com
PostgreSQL, especifique localhost
aqui.
DATABASE_NAME¶
Padrão: ''
(Empty string)
O nome do banco de dados que será usado. Para o SQLite, este valor é o caminho
completo do arquivo de banco de dados. Quando especificar o caminho, sempre
use barras ('/'
), mesmo no ambiente Windows
(e.g. C:/homes/user/mysite/sqlite3.db
).
DATABASE_OPTIONS¶
Padrão: {}
(Empty dictionary)
Parâmetros extra para usar quando contectar-se ao banco de dados. Consulte a documentação dos módulos backends para chaves disponíveis.
DATABASE_PASSWORD¶
Padrão: ''
(Empty string)
A senha a ser usada quando contectar com o banco de dados. Não é usado no SQLite.
DATABASE_PORT¶
Padrão: ''
(Empty string)
A porta a ser usada quando conectar ao banco de dados. Uma string vazia significa a porta padrão. Não é usado com SQLite.
DATABASE_USER¶
Padrão: ''
(Empty string)
O nome de usuário a ser usado quando conectar com o banco de dados. Não é usado com SQLite.
DATE_FORMAT¶
Padrão: 'N j, Y'
(e.g. Feb. 4, 2003
)
O formato padrão a ser utilizado para os campos de data no admin do Django, nas
páginas de listagem – e, possivelmente, por outras partes do sistema. Veja
formatos de string permitidos para datas
.
Veja também DATETIME_FORMAT
, TIME_FORMAT
, YEAR_MONTH_FORMAT
e
MONTH_DAY_FORMAT
.
DATETIME_FORMAT¶
Padrão: 'N j, Y, P'
(e.g. Feb. 4, 2003, 4 p.m.
)
O formato padrão usado nos campos de data no admin do Django, nas páginas de
listagem – e, possivelmente, por outras partes do sistema. Veja
formatos de string permitidos para datas
.
Veja também DATE_FORMAT
, DATETIME_FORMAT
, TIME_FORMAT
,
YEAR_MONTH_FORMAT
e MONTH_DAY_FORMAT
.
DEBUG¶
Padrão: False
Um booleano que liga ou desliga o modo debug.
Se você define uma configuração personalizada, django/views/debug.py tem uma
expressão regular HIDDEN_SETTINGS
será escondida da visão de DEBUG tudo que
contém 'SECRET'
, 'PASSWORD'
, ou 'PROFANITIES'
. Isso permite que
usuários, não confiáveis, recebam backtraces sem ver configurações sensíveis do
sistema.
Ainda, não que há seções de sua saída de depuração que são inapropriadas para o consumo do público. Caminhos de arquivos, opções de configuração, é como dar informações extra sobre o seu servidor aos atacantes.
É importante lembrar também, que quando estiver rodando com o DEBUG
ligado,
o Django evoca todas as consultas SQL executadas. Isto é usual quando você está
debugando, mas no servidor de produção, irá consumir rapidamente muita memória.
Nunca coloque um site em produção com o DEBUG
ligado.
DEBUG_PROPAGATE_EXCEPTIONS¶
Padrão: False
Se for True, a manipulador de exceção normal do Django das funções view será suprimido, e as exceções serão propagadas para os níveis superiores. Isto pode ser útil numa configuração de testes, e nunca deve ser usado num site em produção.
DEFAULT_CHARSET¶
Padrão: 'utf-8'
O charset a ser utilizado para todas os objetos HttpResponse
, se um tipo
MIME não for manualmente especificado. Usado com DEFAULT_CONTENT_TYPE
para
construir o cabeçalho Content-Type
.
DEFAULT_CONTENT_TYPE¶
Padrão: 'text/html'
Tipo de conteúdo padrão a ser utilizado por todos os objetos HttpResponse
,
se um tipo MIME não for manualmente especificado. Usado como
DEFAULT_CHARSET
para construir o cabeçalho Content-Type
.
DEFAULT_FILE_STORAGE¶
Padrão: 'django.core.files.storage.FileSystemStorage'
Arquivo padrão de classe storage a ser usado por quaisquer operações relacionadas a arquivos que não especificam um sistema de armazenamento particular. Veja Gerenciando arquivos.
DEFAULT_FROM_EMAIL¶
Padrão: 'webmaster@localhost'
Endereço de email padrão para ser usado por várias correspondências automáticas para o(s) gerente(s) do site.
DEFAULT_TABLESPACE¶
Padrão: ''
(Empty string)
Tablespace padrão a ser usado pelos models que não especificarem um, caso o backend suporte.
DEFAULT_INDEX_TABLESPACE¶
Padrão: ''
(Empty string)
Tablespace padrão a ser usado para indexes dos campos que não especificar um, caso o backend suporte.
DISALLOWED_USER_AGENTS¶
Padrão: ()
(Empty tuple)
Lista de objetos de expressões regulares compiladas representando strings de
User-Agent que não são permitidos para visitar qualquer página, ao longo do
sistema. Use isto contra robots/crawlers.
Isso somente será usado se o CommonMiddleware
estiver instalado (veja
Middleware).
EMAIL_HOST_PASSWORD¶
Padrão: ''
(Empty string)
Password do servidor SMTP definido no EMAIL_HOST
. Esta configuração é usada
na conjunção com o EMAIL_HOST_USER
durante a autenticação do servidor SMTP.
Se ambas configurações forem vazias, o Django não tenta fazer a autenticação.
Veja também EMAIL_HOST_USER
.
EMAIL_HOST_USER¶
Padrão: ''
(Empty string)
Username para o servidor SMTP definido em EMMAIL_HOST
. Se vazio, o Django
não tentará a autenticação.
Veja também EMAIL_HOST_PASSWORD
.
EMAIL_SUBJECT_PREFIX¶
Padrão: '[Django] '
Prefixo de assunto para as mensagens de e-mail enviadas com
django.core.mail.mail_admins
ou django.core.mail.mail_managers
. Você
provavelmente precisará incluir o espaço no final da linha.
FILE_CHARSET¶
Padrão: 'utf-8'
A codificação de caracteres usado para decodificar qualquer arquivo lido do disco. Este inclui os arquivos de template e arquivos de dados SQL iniciais.
FILE_UPLOAD_HANDLERS¶
Padrão:
("django.core.files.uploadhandler.MemoryFileUploadHandler",
"django.core.files.uploadhandler.TemporaryFileUploadHandler",)
Uma tupla de manipuladores de upload. Veja Gerenciando arquivos para detalhes.
FILE_UPLOAD_MAX_MEMORY_SIZE¶
Padrão: 2621440
(i.e. 2.5 MB).
O tamanho máximo (em bytes) de um upload terá, antes de ser redirecionado para o sistema de arquivo. Veja Gerenciando arquivos para detalhes.
FILE_UPLOAD_TEMP_DIR¶
Padrão: None
O diretório para armazenar os arquivos durante o processo de upload. Se
None
, o Django usará o diretório temporário padrão do sistema operacional.
Por exemplo, ele será ‘/tmp’ em sistemas operacionais *nix.
Veja Gerenciando arquivos para detalhes.
FILE_UPLOAD_PERMISSIONS¶
Padrão: None
O modo numérico (i.e. 0644
) para setar o novo arquivo enviado. Para mais
informações sobre o que significa esses modos, veja a documentação do
os.chmod
Se este não for dado ou for None
, você terá um comportamento dependendo do
sistema operacional. Na maioria das plataformas, arquivos temporários possuem um
mode 0600
, e arquivos salvos a partir da memória serão salvos usando o
umask padrão do sistema.
Warning
Sempre prefixe o mode com um 0.
Se você não está familiarizado com os modes de arquivos, por favor perceba
que o zero, 0
, que vai na frente é muito importante: ele indica um
número octal, pois é como os modos são especificados. Se você tentar usar
644
, você terá um comportamento totalmente errado.
FIXTURE_DIRS¶
Padrão: ()
(Empty tuple)
Lista de localizações de arquivos de dados para fixtures, na ordem de busca. Note que estes caminhos devem usar o estilo Unix, com barras ‘/’, mesmo no Windows. Veja Testando aplicações Django.
FORCE_SCRIPT_NAME¶
Padrão: None
Se não for None
, ele será usado como o valor de ambiente SCRIPT_NAME
em
qualquer requisição HTTP. Esta configuração pode ser usada para sobrescrevr o
valor fornecido pelo servidor SCRIPT_NAME
, que pode ser uma versão reescrita
do valor preferido ou não fornecido.
IGNORABLE_404_ENDS¶
Padrão: ('mail.pl', 'mailform.pl', 'mail.cgi', 'mailform.cgi', 'favicon.ico', '.php')
Veja também IGNORABLE_404_STARTS
e Error reporting via e-mail
.
IGNORABLE_404_STARTS¶
Padrão: ('/cgi-bin/', '/_vti_bin', '/_vti_inf')
Uma tupla de strings que especificam o início de URLs que devem ser ignoradas
pelo e-mailer 404. Veja SEND_BROKEN_LINK_EMAILS
, INGNORABLE_404_ENDS
e
o Reporte de erros via e-mail.
INSTALLED_APPS¶
Padrão: ()
(Empty tuple)
Uma tupla de strings designando todas as aplicações que estão habilitadas nesta
instalação do Django. Cada string deve ser um caminho do Python completo para o
pacote que contem uma aplicação Django, como criada pelo
django-admin.py startapp
.
INTERNAL_IPS¶
Padrão: ()
(Empty tuple)
Uma tupla de endereços de IP, como strings, que:
- Veja os comentários do debug, quando
DEBUG
forTrue
- Recebe um cabeçalho X se o
XViewMiddleware
estiver instalado (veja Middleware)
JING_PATH¶
Padrão: '/usr/bin/jing'
Caminho para o executável “Jing”. Jing é um validador RELAX NG, e o Django usa
ele para validar cada XMLField
nos seus models.
Veja http://www.thaiopensource.com/relaxng/jing.html .
LANGUAGE_CODE¶
Padrão: 'en-us'
Uma string representando o código do idioma para esta instalação. Este deve ser
no formato de linguagens padrão. Por exemplo, para U.S. English é "en-us"
.
Para Internacionalização.
LANGUAGE_COOKIE_NAME¶
Padrão: 'django_language'
O nome que será usado para o cookie de linguagem. Este pode ser qualquer nome
que quiser (mas deve ser diferente do SESSINO_COOKIE_NAME
). Veja
Internacionalização.
LANGUAGES¶
Padrão: A tuple of all available languages. This list is continually growing
and including a copy here would inevitably become rapidly out of date. You can
see the current list of translated languages by looking in
django/conf/global_settings.py
(or view the online source).
A lista é uma tupla de tuplas duplas no formato (código do idioma, nome do
idioma) – por exemplo, ('ja', 'Japanese')
. Isto especifica quais idiomas
estão disponíveis para seleção. Veja Internacionalização.
Geralmente, o valor padrão deveria bastar. Somente sete esta configuração se você quer restringir a selação de idiomas para um subconjunto de línguas fornecidas pelo Django.
Se você define uma configuração de LANGUAGES
personalizada, ela está OK para
marcar as línguas como strings de tradução (como no valor padrão mostrado acima)
– mas use uma função gettext()
“dummy”, não a que está em
django.utils.translation
. Você nunca deve importar o
django.utils.translation
de dentro do seu arquivo de configuração, porquê
este módulo em si depende do settings, e que poderia causar uma importação
circular.
A solução é usar uma função gettext()
“dummy”. Aqui temos um exemplo:
gettext = lambda s: s
LANGUAGES = (
('de', gettext('German')),
('en', gettext('English')),
)
Com este arranjo, o django-admin.py makemessages
ainda encontrará e marcará
estas strings para tradução, mas a tradução não acontecerá em tempo de execução
– então você terá de lembrar de envolver os idiomas no gettext()
real em
qualquer código que usar o LANGUAGES
em tempo de execução.
LOCALE_PATHS¶
Padrão: ()
(Empty tuple)
Uma tupla de diretórios onde o Django procura por arquivos de tradução. Veja Usando traduções em seus próprios projetos.
LOGIN_REDIRECT_URL¶
Padrão: '/accounts/profile/'
A URL para onde a requisição é redirecionada depois do login, quando o view
contrib.auth.login
não recebe um parametro next
.
Este é usado pelo decorador
login_required()
, por exemplo.
LOGIN_URL¶
Padrão: '/accounts/login/'
A URL onde as requisições são redirecionadas para o login, especialmente quando
se usa o decorador login_required()
.
MANAGERS¶
Padrão: ()
(Empty tuple)
Uma tupla no mesmo formato do ADMINS
que especifica quem deve receber
notificações de links quebrados quando SEND_BROKEN_LINK_EMAILS=True
.
MEDIA_ROOT¶
Padrão: ''
(Empty string)
Caminho absoluto para o diretório que mantem as mídias desta instalação.
Exemplo: "/home/media/media.lawrence.com/"
Veja também MEDIA_URL
.
MEDIA_URL¶
Padrão: ''
(Empty string)
A URL que manipula a mídia servida por MEDIA_ROOT
.
Exemplo: "http://media.lawrence.com"
Note que este deve ter uma barra no final, se ele tem um componente de caminho.
Bom: "http://www.example.com/static/"
Ruim: "http://www.example.com/static"
MIDDLEWARE_CLASSES¶
Padrão:
("django.contrib.sessions.middleware.SessionMiddleware",
"django.contrib.auth.middleware.AuthenticationMiddleware",
"django.middleware.common.CommonMiddleware",
"django.middleware.doc.XViewMiddleware")
Uma tupla de classes middleware para usar. Veja Middleware.
MONTH_DAY_FORMAT¶
Padrão: 'F j'
O formato padrão a ser usado para campos de data nas páginas de listagens do Django admin – e, possivelmente, por outras partes do sistema – em casos onde somente o mês e o dia são mostrados.
Por exemplo, quando uma página de listagem do Django admin está sendo filtrada por data, o cabeçalho para um dado dia mostra o dia e o mês. Diferentes localidades possuem diferentes formatos. Por exemplo, nos E.U.A costumam dizer “January 1,” em áreas espanholas pode ser dito “1 Enero.”
Veja formatos de strings de data permitidos
. Veja também DATE_FORMAT
,
DATETIME_FORMAT
, TIME_FORMAT
and YEAR_MONTH_FORMAT
.
PREPEND_WWW¶
Padrão: False
Para prefixar o subdomínio “www.” nas URLs que não o possuem. Este é somente
usado se CommonMiddleware
estiver instalado (veja
Middleware). Veja também APPEND_SLASH
.
PROFANITIES_LIST¶
Uma tupla de profanities, como strings, que engatilharão um erro de validação
quando o validador hasNoProfanities
for chamado.
Nós não listamos os valores padrão aqui, porque eles podem ser profanos. Para ver os valores padrões, veja o arquivo django/conf/global_settings.py.
ROOT_URLCONF¶
Padrão: Not defined
Uma string representando o caminho de import completo do Python para o seu
URLconf. Por exemplo: "mydjangoapps.urls"
. Pode ser sobrescrito caso
necessário, definindo o atributo urlconf
no objeto HttpRequest
que
chega. Veja Como o Django processa uma requisição para detalhes.
SECRET_KEY¶
Padrão: ''
(Empty string)
Uma chave secreta para esta instalação do Django em particular. Usada para
prover uma chave secreta para o algorítimo de hash. Defina como uma string
aleatória – quanto maior, melhor. O django-amdin.py startproject
cria uma
automaticamente.
SEND_BROKEN_LINK_EMAILS¶
Padrão: False
Para enviar um e-mail para os MANAGERS
toda vez que alguém visita uma página
feita com o Django que retornou um erro 404 com um referer não vazio (i.e.
um link quebrado). Isso só é usado se o CommonMiddleware
estiver instalado
(veja Middleware. Veja também IGNORABLE_404_STARTS
,
IGNORABLE_404_ENDS
e Reporte de erros via e-mail.
SERIALIZATION_MODULES¶
Padrão: Not defined.
A dictionary of modules containing serializer definitions (provided as strings), keyed by a string identifier for that serialization type. For example, to define a YAML serializer, use:
SERIALIZATION_MODULES = { 'yaml' : 'path.to.yaml_serializer' }
SERVER_EMAIL¶
Padrão: 'root@localhost'
O endereço de e-mail de onde vem as mensagens de erro, como um dos que envia
para os ADMINS
e MANAGERS
.
SESSION_ENGINE¶
Padrão: django.contrib.sessions.backends.db
Controla onde o Django armazena os dados da sessão. Valores válidos são:
'django.contrib.sessions.backends.db'
'django.contrib.sessions.backends.file'
'django.contrib.sessions.backends.cache'
Veja Como utilizar sessões.
SESSION_COOKIE_AGE¶
Padrão: 1209600
(2 weeks, in seconds)
A longevidade dos coockies de sessão, em segundos. Veja Como utilizar sessões.
SESSION_COOKIE_DOMAIN¶
Padrão: None
O domínio dos coockies de sessão. Defina isso como uma string, por exemplo
".lawrence.com"
, para coockies cross-domain, ou use None
para um nome de
domínio padrão . Veja o Como utilizar sessões.
SESSION_COOKIE_NAME¶
Padrão: 'sessionid'
O nome do coockie das sessões. Este pode ser qualquer um que você queira (mas
deve ser diferente do LANGUAGE_COOKIE_NAME
). Veja
Como utilizar sessões.
SESSION_COOKIE_PATH¶
Padrão: '/'
O caminho setado no cookie da sessão. Isso deve corresponder ao caminho ou a URL de sua instalação do Django ou ser antecessor deste caminho.
Isso é útil se você tem várias instâncias do Django rodando sob o mesmo hostname. Eles podem usar diferentes caminhos de cookie, e cada instância somente verá seu próprio cookie de sessão.
SESSION_COOKIE_SECURE¶
Padrão: False
Para usar um cookie seguro como cookie de sessão. Se este é setado como
True
, o cookie será marcado como “secure”, o que significa que os
navegadores podem assegurar que o cookie é somente enviado sob uma conecção
HTTPS.
Veja o Como utilizar sessões.
SESSION_EXPIRE_AT_BROWSER_CLOSE¶
Padrão: False
Para expirar a sessão quando o usuário fecha seu navegador. Veja o Como utilizar sessões.
SESSION_FILE_PATH¶
Padrão: None
Se você estiver usando armazenamento de sessão baseado em arquivos, este seta o
diretório em que o Django armazenará os dados de sessão.
Veja Como utilizar sessões. Quando o valor padrão None
é usado, o
Django usará o diretório padrão do sistema.
SESSION_SAVE_EVERY_REQUEST¶
Padrão: False
Para salvar os dados da sessão em toda requisição. Veja Como utilizar sessões.
SITE_ID¶
Padrão: Not defined
O iID, como um inteiro, do site atual na tabela do banco de dados
django_site
. Isso é usado de modo que os dados da aplicação possam ser
presos a um ou mais sites específicos. Um mesmo banco de dados pode gerenciar
o conteúdo de múltiplos sites.
Veja The “sites” framework.
TEMPLATE_CONTEXT_PROCESSORS¶
Padrão:
("django.core.context_processors.auth",
"django.core.context_processors.debug",
"django.core.context_processors.i18n",
"django.core.context_processors.media")
Uma tupla com funções chamáveis que são usadas para popular o contexto no
RequestContext
. Estas funções recebem um objeto request como seu argumento
e retornam um dicionário de ítens a serem mesclados ao contexto.
TEMPLATE_DEBUG¶
Padrão: False
Um booleano que liga/desliga o modo debug do template. Se for True
, a página
de erro mostrará um relatório detalhado para qualquer TemplateSyntaxError
.
Este relatório contém o fragmento relevante do template, com a linha apropriada
em destaque.
Note que o Django somente mostra páginas de erros se o DEBUG
for True
,
de modo que você precisará setar isso para obter vantagem desta configuração.
Veja também DEBUG
.
TEMPLATE_DIRS¶
Padrão: ()
(Empty tuple)
Lista de localizações de arquivos fontes de templates, na ordem de busca. Note que estes caminhos devem usar o estilo Unix, com uma barra na frente, mesmo no Windows.
Veja The Django template language..
TEMPLATE_LOADERS¶
Padrão:
('django.template.loaders.filesystem.load_template_source',
'django.template.loaders.app_directories.load_template_source')
Uma tupla de funções (como strings) que sabem como importar templates de várias fontes. Veja The Django template language: For Python programmers.
TEMPLATE_STRING_IF_INVALID¶
Padrão: ''
(Empty string)
Saída, como uma string, que o sistema de template deve usar para variáveis inválidas (e.g. com erro de escrita). Veja How invalid variables are handled..
TEST_DATABASE_CHARSET¶
Padrão: None
A codificação de caracteres usado para criar as tabelas de testes. O valor desta string é passado diretamente para banco de dados, então seu formato é específico para os backends.
Suportado pelos backends PostgreSQL (postgresql
, postgresql_psycopg2
) e
MySQL (mysql
).
TEST_DATABASE_COLLATION¶
Padrão: None
A forma de agrupamento a ser usada quando criar as tabelas no banco de dados de testes. Este valor é passado diretamente para o backend, de modo que seu formato é especifico para os backends.
Somente suportado pelo backend do mysql
(veja seção 10.3.2 do manual do
MySQL para detalhes).
TEST_DATABASE_NAME¶
Padrão: None
O nome do banco de dados a ser usado quando se roda os testes.
Se o valor padrão (None
) for usado como o motor de banco de dados SQLite, os
testes usarão um banco de dados em memória. Para todos os outros bancos de dados
o banco de teste usará o nome 'test_' + settings.DATABASE_NAME
.
TEST_RUNNER¶
Padrão: 'django.test.simple.run_tests'
O nome do método a ser usado para começar a suite de testes. Veja Testando aplicações Django.
TIME_FORMAT¶
Padrão: 'P'
(e.g. 4 p.m.
)
O formato padrão para usar em campos de tempo nas páginas de listagem do Django
admin – e, possivelmente, por outras partes do sistema. Veja
formatos de string de data permitidos
.
Veja também DATE_FORMAT
, DATETIME_FORMAT
, TIME_FORMAT
,
YEAR_MONTH_FORMAT
and MONTH_DAY_FORMAT
.
TIME_ZONE¶
Padrão: 'America/Chicago'
Uma string representando o fuso horário para esta instalação. Veja opções
disponíveis. (Note que a lista de escolhas disponíveis lista mais de uma na
mesma linha; você vai querer usar só uma das escolhas para um dado fuso horário.
Por instância, uma linha diz 'Europe/London GB GB-Eire'
, mas você deve usar
o primeiro pedaço dela – 'Europe/London'
– como sua configuração de
TIME_ZONE
.)
Note que este é o mesmo fuso horário para o qual o Django converterá todas as datas/horas – não necessáriamente o fuso horário do servidor. Pore exemplo, um servidor pode servir vários sites feitos com o Django, cada um com uma configuração de fuso diferentes.
Normalmente, o Django seta a variável os.environ['TZ']
para o fuso que você
especificar na configuração TIME_ZONE
. Deste modo, todos os seus views e
models automaticamente trabalharão no fuso horário correto. Entretanto, se você
está manualmente, configurando o settings, o Django não tocará na variável de
ambiente TZ
, e ele deixará para você assegurar que seu processo está rodando
no ambiente correto.
Note
O Django não pode usar com segurança um fuso alternativo no ambiente Windows. Se você estiver rodando o Django no Windows, esta variável deve ser setada pra combinar com o fuso horário do sistema.
URL_VALIDATOR_USER_AGENT¶
Padrão: Django/<version> (http://www.djangoproject.com/)
A string a ser usada como cabeçalho User-Agent
quando checando a existência
de URLs (veja a opção verify_exists
em URLField
).
USE_ETAGS¶
Padrão: False
Um booleano que especifica a saída do cabeçalho “Etag”. Este poupa largura de
banda mas diminui a performance. Isso somente é usado se CommonMiddleware
estiver instalado (veja Middleware).
USE_I18N¶
Padrão: True
Um booleano que especifica se o sistema de internacionalização do Django deve
ser habilitado. Este fornece uma forma fácil de desligá-lo, por questões de
performance. Se estíver setado como False
, o Django fará algumas otimizações
para não carregar os mecanismos de internacionalização.
YEAR_MONTH_FORMAT¶
Padrão: 'F Y'
O formato padrão a ser usado por campos de datas nas páginas de listagens do Django admin – e, possivelmente, por outras partes do sistema – em casos onde somente o ano e mês são exibidos.
Por exemplo, quando numa página de listagem do Django admin é feita uma filtragem por detalhamento de data, o cabeçalho para um dado mês mostra o mês e o ano. Diferentes locais têm diferentes formatos. Por exemplo, Nos E.U.A costuma-se dizer “Janeiro 2006”, e noutros lugares podem dizer “2006/Janeiro.”
Veja formato de strings de datas permitidos
. Veja também DATE_FORMAT
,
DATETIME_FORMAT
, TIME_FORMAT
and MONTH_DAY_FORMAT
.