<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Settings — Django v1.3.1 documentation</title> <link rel="stylesheet" href="../_static/default.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '1.3.1', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="top" title="Django v1.3.1 documentation" href="../index.html" /> <link rel="up" title="API Reference" href="index.html" /> <link rel="next" title="Signals" href="signals.html" /> <link rel="prev" title="TemplateResponse and SimpleTemplateResponse" href="template-response.html" /> <script type="text/javascript" src="../templatebuiltins.js"></script> <script type="text/javascript"> (function($) { if (!django_template_builtins) { // templatebuiltins.js missing, do nothing. return; } $(document).ready(function() { // Hyperlink Django template tags and filters var base = "templates/builtins.html"; if (base == "#") { // Special case for builtins.html itself base = ""; } // Tags are keywords, class '.k' $("div.highlight\\-html\\+django span.k").each(function(i, elem) { var tagname = $(elem).text(); if ($.inArray(tagname, django_template_builtins.ttags) != -1) { var fragment = tagname.replace(/_/, '-'); $(elem).html("<a href='" + base + "#" + fragment + "'>" + tagname + "</a>"); } }); // Filters are functions, class '.nf' $("div.highlight\\-html\\+django span.nf").each(function(i, elem) { var filtername = $(elem).text(); if ($.inArray(filtername, django_template_builtins.tfilters) != -1) { var fragment = filtername.replace(/_/, '-'); $(elem).html("<a href='" + base + "#" + fragment + "'>" + filtername + "</a>"); } }); }); })(jQuery); </script> </head> <body> <div class="document"> <div id="custom-doc" class="yui-t6"> <div id="hd"> <h1><a href="../index.html">Django v1.3.1 documentation</a></h1> <div id="global-nav"> <a title="Home page" href="../index.html">Home</a> | <a title="Table of contents" href="../contents.html">Table of contents</a> | <a title="Global index" href="../genindex.html">Index</a> | <a title="Module index" href="../py-modindex.html">Modules</a> </div> <div class="nav"> « <a href="template-response.html" title="TemplateResponse and SimpleTemplateResponse">previous</a> | <a href="index.html" title="API Reference" accesskey="U">up</a> | <a href="signals.html" title="Signals">next</a> »</div> </div> <div id="bd"> <div id="yui-main"> <div class="yui-b"> <div class="yui-g" id="ref-settings"> <div class="section" id="s-settings"> <span id="settings"></span><h1>Settings<a class="headerlink" href="#settings" title="Permalink to this headline">¶</a></h1> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#available-settings" id="id4">Available settings</a></li> <li><a class="reference internal" href="#deprecated-settings" id="id5">Deprecated settings</a></li> </ul> </div> <div class="section" id="s-available-settings"> <span id="available-settings"></span><h2><a class="toc-backref" href="#id4">Available settings</a><a class="headerlink" href="#available-settings" title="Permalink to this headline">¶</a></h2> <p>Here’s a full list of all available settings, in alphabetical order, and their default values.</p> <div class="section" id="s-absolute-url-overrides"> <span id="s-std:setting-ABSOLUTE_URL_OVERRIDES"></span><span id="absolute-url-overrides"></span><span id="std:setting-ABSOLUTE_URL_OVERRIDES"></span><h3>ABSOLUTE_URL_OVERRIDES<a class="headerlink" href="#absolute-url-overrides" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">{}</span></tt> (Empty dictionary)</p> <p>A dictionary mapping <tt class="docutils literal"><span class="pre">"app_label.model_name"</span></tt> strings to functions that take a model object and return its URL. This is a way of overriding <tt class="docutils literal"><span class="pre">get_absolute_url()</span></tt> methods on a per-installation basis. Example:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">ABSOLUTE_URL_OVERRIDES</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'blogs.weblog'</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">o</span><span class="p">:</span> <span class="s">"/blogs/</span><span class="si">%s</span><span class="s">/"</span> <span class="o">%</span> <span class="n">o</span><span class="o">.</span><span class="n">slug</span><span class="p">,</span> <span class="s">'news.story'</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">o</span><span class="p">:</span> <span class="s">"/stories/</span><span class="si">%s</span><span class="s">/</span><span class="si">%s</span><span class="s">/"</span> <span class="o">%</span> <span class="p">(</span><span class="n">o</span><span class="o">.</span><span class="n">pub_year</span><span class="p">,</span> <span class="n">o</span><span class="o">.</span><span class="n">slug</span><span class="p">),</span> <span class="p">}</span> </pre></div> </div> <p>Note that the model name used in this setting should be all lower-case, regardless of the case of the actual model class name.</p> </div> <div class="section" id="s-admin-for"> <span id="s-std:setting-ADMIN_FOR"></span><span id="admin-for"></span><span id="std:setting-ADMIN_FOR"></span><h3>ADMIN_FOR<a class="headerlink" href="#admin-for" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>Used for admin-site settings modules, this should be a tuple of settings modules (in the format <tt class="docutils literal"><span class="pre">'foo.bar.baz'</span></tt>) for which this site is an admin.</p> <p>The admin site uses this in its automatically-introspected documentation of models, views and template tags.</p> </div> <div class="section" id="s-admin-media-prefix"> <span id="s-std:setting-ADMIN_MEDIA_PREFIX"></span><span id="admin-media-prefix"></span><span id="std:setting-ADMIN_MEDIA_PREFIX"></span><h3>ADMIN_MEDIA_PREFIX<a class="headerlink" href="#admin-media-prefix" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'/static/admin/'</span></tt></p> <p>The URL prefix for admin media -- CSS, JavaScript and images used by the Django administrative interface. Make sure to use a trailing slash, and to have this be different from the <a class="reference internal" href="#std:setting-MEDIA_URL"><tt class="xref std std-setting docutils literal"><span class="pre">MEDIA_URL</span></tt></a> setting (since the same URL cannot be mapped onto two different sets of files). For integration with <a class="reference internal" href="contrib/staticfiles.html"><em>staticfiles</em></a>, this should be the same as <a class="reference internal" href="#std:setting-STATIC_URL"><tt class="xref std std-setting docutils literal"><span class="pre">STATIC_URL</span></tt></a> followed by <tt class="docutils literal"><span class="pre">'admin/'</span></tt>.</p> </div> <div class="section" id="s-admins"> <span id="s-std:setting-ADMINS"></span><span id="admins"></span><span id="std:setting-ADMINS"></span><h3>ADMINS<a class="headerlink" href="#admins" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple that lists people who get code error notifications. When <tt class="docutils literal"><span class="pre">DEBUG=False</span></tt> and a view raises an exception, Django will e-mail these people with the full exception information. Each member of the tuple should be a tuple of (Full name, e-mail address). Example:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">((</span><span class="s">'John'</span><span class="p">,</span> <span class="s">'john@example.com'</span><span class="p">),</span> <span class="p">(</span><span class="s">'Mary'</span><span class="p">,</span> <span class="s">'mary@example.com'</span><span class="p">))</span> </pre></div> </div> <p>Note that Django will e-mail <em>all</em> of these people whenever an error happens. See <a class="reference internal" href="../howto/error-reporting.html"><em>Error reporting via e-mail</em></a> for more information.</p> </div> <div class="section" id="s-allowed-include-roots"> <span id="s-std:setting-ALLOWED_INCLUDE_ROOTS"></span><span id="allowed-include-roots"></span><span id="std:setting-ALLOWED_INCLUDE_ROOTS"></span><h3>ALLOWED_INCLUDE_ROOTS<a class="headerlink" href="#allowed-include-roots" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple of strings representing allowed prefixes for the <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">ssi</span> <span class="pre">%}</span></tt> template tag. This is a security measure, so that template authors can't access files that they shouldn't be accessing.</p> <p>For example, if <a class="reference internal" href="#std:setting-ALLOWED_INCLUDE_ROOTS"><tt class="xref std std-setting docutils literal"><span class="pre">ALLOWED_INCLUDE_ROOTS</span></tt></a> is <tt class="docutils literal"><span class="pre">('/home/html',</span> <span class="pre">'/var/www')</span></tt>, then <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">ssi</span> <span class="pre">/home/html/foo.txt</span> <span class="pre">%}</span></tt> would work, but <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">ssi</span> <span class="pre">/etc/passwd</span> <span class="pre">%}</span></tt> wouldn't.</p> </div> <div class="section" id="s-append-slash"> <span id="s-std:setting-APPEND_SLASH"></span><span id="append-slash"></span><span id="std:setting-APPEND_SLASH"></span><h3>APPEND_SLASH<a class="headerlink" href="#append-slash" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">True</span></tt></p> <p>When set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, if the request URL does not match any of the patterns in the URLconf and it doesn't end in a slash, an HTTP redirect is issued to the same URL with a slash appended. Note that the redirect may cause any data submitted in a POST request to be lost.</p> <p>The <a class="reference internal" href="#std:setting-APPEND_SLASH"><tt class="xref std std-setting docutils literal"><span class="pre">APPEND_SLASH</span></tt></a> setting is only used if <a class="reference internal" href="middleware.html#django.middleware.common.CommonMiddleware" title="django.middleware.common.CommonMiddleware"><tt class="xref py py-class docutils literal"><span class="pre">CommonMiddleware</span></tt></a> is installed (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>). See also <a class="reference internal" href="#std:setting-PREPEND_WWW"><tt class="xref std std-setting docutils literal"><span class="pre">PREPEND_WWW</span></tt></a>.</p> </div> <div class="section" id="s-authentication-backends"> <span id="s-std:setting-AUTHENTICATION_BACKENDS"></span><span id="authentication-backends"></span><span id="std:setting-AUTHENTICATION_BACKENDS"></span><h3>AUTHENTICATION_BACKENDS<a class="headerlink" href="#authentication-backends" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">('django.contrib.auth.backends.ModelBackend',)</span></tt></p> <p>A tuple of authentication backend classes (as strings) to use when attempting to authenticate a user. See the <a class="reference internal" href="authbackends.html"><em>authentication backends documentation</em></a> for details.</p> </div> <div class="section" id="s-auth-profile-module"> <span id="s-std:setting-AUTH_PROFILE_MODULE"></span><span id="auth-profile-module"></span><span id="std:setting-AUTH_PROFILE_MODULE"></span><h3>AUTH_PROFILE_MODULE<a class="headerlink" href="#auth-profile-module" title="Permalink to this headline">¶</a></h3> <p>Default: Not defined</p> <p>The site-specific user profile model used by this site. See <a class="reference internal" href="../topics/auth.html#auth-profiles"><em>Storing additional information about users</em></a>.</p> </div> <div class="section" id="s-caches"> <span id="s-std:setting-CACHES"></span><span id="caches"></span><span id="std:setting-CACHES"></span><h3>CACHES<a class="headerlink" href="#caches" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.3:</span> <a class="reference internal" href="../releases/1.3.html"><em>Please, see the release notes</em></a></div> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">{</span> <span class="s">'default'</span><span class="p">:</span> <span class="p">{</span> <span class="s">'BACKEND'</span><span class="p">:</span> <span class="s">'django.core.cache.backends.locmem.LocMemCache'</span><span class="p">,</span> <span class="p">}</span> <span class="p">}</span> </pre></div> </div> <p>A dictionary containing the settings for all caches to be used with Django. It is a nested dictionary whose contents maps cache aliases to a dictionary containing the options for an individual cache.</p> <p>The <a class="reference internal" href="#std:setting-CACHES"><tt class="xref std std-setting docutils literal"><span class="pre">CACHES</span></tt></a> setting must configure a <tt class="docutils literal"><span class="pre">default</span></tt> cache; any number of additional caches may also be specified. If you are using a cache backend other than the local memory cache, or you need to define multiple caches, other options will be required. The following cache options are available.</p> <div class="section" id="s-backend"> <span id="s-std:setting-CACHES-BACKEND"></span><span id="backend"></span><span id="std:setting-CACHES-BACKEND"></span><h4>BACKEND<a class="headerlink" href="#backend" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The cache backend to use. The built-in cache backends are:</p> <ul class="simple"> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.db.DatabaseCache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.dummy.DummyCache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.filebased.FileBasedCache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.locmem.LocMemCache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.memcached.MemcachedCache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.core.cache.backends.memcached.PyLibMCCache'</span></tt></li> </ul> <p>You can use a cache backend that doesn't ship with Django by setting <tt class="xref std std-setting docutils literal"><span class="pre">BACKEND</span></tt> to a fully-qualified path of a cache backend class (i.e. <tt class="docutils literal"><span class="pre">mypackage.backends.whatever.WhateverCache</span></tt>). Writing a whole new cache backend from scratch is left as an exercise to the reader; see the other backends for examples.</p> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">Prior to Django 1.3, you could use a URI based version of the backend name to reference the built-in cache backends (e.g., you could use <tt class="docutils literal"><span class="pre">'db://tablename'</span></tt> to refer to the database backend). This format has been deprecated, and will be removed in Django 1.5.</p> </div> </div> <div class="section" id="s-key-function"> <span id="s-std:setting-CACHES-KEY_FUNCTION"></span><span id="key-function"></span><span id="std:setting-CACHES-KEY_FUNCTION"></span><h4>KEY_FUNCTION<a class="headerlink" href="#key-function" title="Permalink to this headline">¶</a></h4> <p>A string containing a dotted path to a function that defines how to compose a prefix, version and key into a final cache key. The default implementation is equivalent to the function:</p> <div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">make_key</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">key_prefix</span><span class="p">,</span> <span class="n">version</span><span class="p">):</span> <span class="k">return</span> <span class="s">':'</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">key_prefix</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">version</span><span class="p">),</span> <span class="n">smart_str</span><span class="p">(</span><span class="n">key</span><span class="p">)])</span> </pre></div> </div> <p>You may use any key function you want, as long as it has the same argument signature.</p> <p>See the <a class="reference internal" href="../topics/cache.html#cache-key-transformation"><em>cache documentation</em></a> for more information.</p> </div> <div class="section" id="s-key-prefix"> <span id="s-std:setting-CACHES-KEY_PREFIX"></span><span id="key-prefix"></span><span id="std:setting-CACHES-KEY_PREFIX"></span><h4>KEY_PREFIX<a class="headerlink" href="#key-prefix" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>A string that will be automatically included (prepended by default) to all cache keys used by the Django server.</p> <p>See the <a class="reference internal" href="../topics/cache.html#cache-key-prefixing"><em>cache documentation</em></a> for more information.</p> </div> <div class="section" id="s-location"> <span id="s-std:setting-CACHES-LOCATION"></span><span id="location"></span><span id="std:setting-CACHES-LOCATION"></span><h4>LOCATION<a class="headerlink" href="#location" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The location of the cache to use. This might be the directory for a file system cache, a host and port for a memcache server, or simply an identifying name for a local memory cache. e.g.:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">CACHES</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'default'</span><span class="p">:</span> <span class="p">{</span> <span class="s">'BACKEND'</span><span class="p">:</span> <span class="s">'django.core.cache.backends.filebased.FileBasedCache'</span><span class="p">,</span> <span class="s">'LOCATION'</span><span class="p">:</span> <span class="s">'/var/tmp/django_cache'</span><span class="p">,</span> <span class="p">}</span> <span class="p">}</span> </pre></div> </div> </div> <div class="section" id="s-options"> <span id="s-std:setting-CACHES-OPTIONS"></span><span id="options"></span><span id="std:setting-CACHES-OPTIONS"></span><h4>OPTIONS<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h4> <p>Default: None</p> <p>Extra parameters to pass to the cache backend. Available parameters vary depending on your cache backend.</p> <p>Some information on available parameters can be found in the <a class="reference internal" href="../topics/cache.html"><em>Cache Backends</em></a> documentation. For more information, consult your backend module's own documentation.</p> </div> <div class="section" id="s-timeout"> <span id="s-std:setting-CACHES-TIMEOUT"></span><span id="timeout"></span><span id="std:setting-CACHES-TIMEOUT"></span><h4>TIMEOUT<a class="headerlink" href="#timeout" title="Permalink to this headline">¶</a></h4> <p>Default: 300</p> <p>The number of seconds before a cache entry is considered stale.</p> </div> <div class="section" id="s-version"> <span id="s-std:setting-CACHES-VERSION"></span><span id="version"></span><span id="std:setting-CACHES-VERSION"></span><h4>VERSION<a class="headerlink" href="#version" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">1</span></tt></p> <p>The default version number for cache keys generated by the Django server.</p> <p>See the <a class="reference internal" href="../topics/cache.html#cache-versioning"><em>cache documentation</em></a> for more information.</p> </div> </div> <div class="section" id="s-cache-middleware-alias"> <span id="s-std:setting-CACHE_MIDDLEWARE_ALIAS"></span><span id="cache-middleware-alias"></span><span id="std:setting-CACHE_MIDDLEWARE_ALIAS"></span><h3>CACHE_MIDDLEWARE_ALIAS<a class="headerlink" href="#cache-middleware-alias" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">default</span></tt></p> <p>The cache connection to use for the cache middleware.</p> </div> <div class="section" id="s-cache-middleware-anonymous-only"> <span id="s-std:setting-CACHE_MIDDLEWARE_ANONYMOUS_ONLY"></span><span id="cache-middleware-anonymous-only"></span><span id="std:setting-CACHE_MIDDLEWARE_ANONYMOUS_ONLY"></span><h3>CACHE_MIDDLEWARE_ANONYMOUS_ONLY<a class="headerlink" href="#cache-middleware-anonymous-only" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>If the value of this setting is <tt class="xref docutils literal"><span class="pre">True</span></tt>, only anonymous requests (i.e., not those made by a logged-in user) will be cached. Otherwise, the middleware caches every page that doesn't have GET or POST parameters.</p> <p>If you set the value of this setting to <tt class="xref docutils literal"><span class="pre">True</span></tt>, you should make sure you've activated <tt class="docutils literal"><span class="pre">AuthenticationMiddleware</span></tt>.</p> <p>See <a class="reference internal" href="../topics/cache.html"><em>Django's cache framework</em></a>.</p> </div> <div class="section" id="s-cache-middleware-key-prefix"> <span id="s-std:setting-CACHE_MIDDLEWARE_KEY_PREFIX"></span><span id="cache-middleware-key-prefix"></span><span id="std:setting-CACHE_MIDDLEWARE_KEY_PREFIX"></span><h3>CACHE_MIDDLEWARE_KEY_PREFIX<a class="headerlink" href="#cache-middleware-key-prefix" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The cache key prefix that the cache middleware should use.</p> <p>See <a class="reference internal" href="../topics/cache.html"><em>Django's cache framework</em></a>.</p> </div> <div class="section" id="s-cache-middleware-seconds"> <span id="s-std:setting-CACHE_MIDDLEWARE_SECONDS"></span><span id="cache-middleware-seconds"></span><span id="std:setting-CACHE_MIDDLEWARE_SECONDS"></span><h3>CACHE_MIDDLEWARE_SECONDS<a class="headerlink" href="#cache-middleware-seconds" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">600</span></tt></p> <p>The default number of seconds to cache a page when the caching middleware or <tt class="docutils literal"><span class="pre">cache_page()</span></tt> decorator is used.</p> <p>See <a class="reference internal" href="../topics/cache.html"><em>Django's cache framework</em></a>.</p> </div> <div class="section" id="s-csrf-cookie-domain"> <span id="s-std:setting-CSRF_COOKIE_DOMAIN"></span><span id="csrf-cookie-domain"></span><span id="std:setting-CSRF_COOKIE_DOMAIN"></span><h3>CSRF_COOKIE_DOMAIN<a class="headerlink" href="#csrf-cookie-domain" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The domain to be used when setting the CSRF cookie. This can be useful for allowing cross-subdomain requests to be exluded from the normal cross site request forgery protection. It should be set to a string such as <tt class="docutils literal"><span class="pre">".lawrence.com"</span></tt> to allow a POST request from a form on one subdomain to be accepted by accepted by a view served from another subdomain.</p> </div> <div class="section" id="s-csrf-cookie-name"> <span id="s-std:setting-CSRF_COOKIE_NAME"></span><span id="csrf-cookie-name"></span><span id="std:setting-CSRF_COOKIE_NAME"></span><h3>CSRF_COOKIE_NAME<a class="headerlink" href="#csrf-cookie-name" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'csrftoken'</span></tt></p> <p>The name of the cookie to use for the CSRF authentication token. This can be whatever you want. See <a class="reference internal" href="contrib/csrf.html"><em>Cross Site Request Forgery protection</em></a>.</p> </div> <div class="section" id="s-csrf-failure-view"> <span id="s-std:setting-CSRF_FAILURE_VIEW"></span><span id="csrf-failure-view"></span><span id="std:setting-CSRF_FAILURE_VIEW"></span><h3>CSRF_FAILURE_VIEW<a class="headerlink" href="#csrf-failure-view" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'django.views.csrf.csrf_failure'</span></tt></p> <p>A dotted path to the view function to be used when an incoming request is rejected by the CSRF protection. The function should have this signature:</p> <div class="highlight-python"><pre>def csrf_failure(request, reason="")</pre> </div> <p>where <tt class="docutils literal"><span class="pre">reason</span></tt> is a short message (intended for developers or logging, not for end users) indicating the reason the request was rejected. See <a class="reference internal" href="contrib/csrf.html"><em>Cross Site Request Forgery protection</em></a>.</p> </div> <div class="section" id="s-databases"> <span id="s-std:setting-DATABASES"></span><span id="databases"></span><span id="std:setting-DATABASES"></span><h3>DATABASES<a class="headerlink" href="#databases" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">{}</span></tt> (Empty dictionary)</p> <p>A dictionary containing the settings for all databases to be used with Django. It is a nested dictionary whose contents maps database aliases to a dictionary containing the options for an individual database.</p> <p>The <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a> setting must configure a <tt class="docutils literal"><span class="pre">default</span></tt> database; any number of additional databases may also be specified.</p> <p>The simplest possible settings file is for a single-database setup using SQLite. This can be configured using the following:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">DATABASES</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'default'</span><span class="p">:</span> <span class="p">{</span> <span class="s">'ENGINE'</span><span class="p">:</span> <span class="s">'django.db.backends.sqlite3'</span><span class="p">,</span> <span class="s">'NAME'</span><span class="p">:</span> <span class="s">'mydatabase'</span> <span class="p">}</span> <span class="p">}</span> </pre></div> </div> <p>For other database backends, or more complex SQLite configurations, other options will be required. The following inner options are available.</p> <div class="section" id="s-engine"> <span id="s-std:setting-DATABASE-ENGINE"></span><span id="engine"></span><span id="std:setting-DATABASE-ENGINE"></span><h4>ENGINE<a class="headerlink" href="#engine" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The database backend to use. The built-in database backends are:</p> <ul class="simple"> <li><tt class="docutils literal"><span class="pre">'django.db.backends.postgresql_psycopg2'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.db.backends.postgresql'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.db.backends.mysql'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.db.backends.sqlite3'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.db.backends.oracle'</span></tt></li> </ul> <p>You can use a database backend that doesn't ship with Django by setting <tt class="docutils literal"><span class="pre">ENGINE</span></tt> to a fully-qualified path (i.e. <tt class="docutils literal"><span class="pre">mypackage.backends.whatever</span></tt>). Writing a whole new database backend from scratch is left as an exercise to the reader; see the other backends for examples.</p> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">Prior to Django 1.2, you could use a short version of the backend name to reference the built-in database backends (e.g., you could use <tt class="docutils literal"><span class="pre">'sqlite3'</span></tt> to refer to the SQLite backend). This format has been deprecated, and will be removed in Django 1.4.</p> </div> </div> <div class="section" id="s-host"> <span id="s-std:setting-HOST"></span><span id="host"></span><span id="std:setting-HOST"></span><h4>HOST<a class="headerlink" href="#host" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Which host to use when connecting to the database. An empty string means localhost. Not used with SQLite.</p> <p>If this value starts with a forward slash (<tt class="docutils literal"><span class="pre">'/'</span></tt>) and you're using MySQL, MySQL will connect via a Unix socket to the specified socket. For example:</p> <div class="highlight-python"><pre>"HOST": '/var/run/mysql'</pre> </div> <p>If you're using MySQL and this value <em>doesn't</em> start with a forward slash, then this value is assumed to be the host.</p> <p>If you're using PostgreSQL, an empty string means to use a Unix domain socket for the connection, rather than a network connection to localhost. If you explicitly need to use a TCP/IP connection on the local machine with PostgreSQL, specify <tt class="docutils literal"><span class="pre">localhost</span></tt> here.</p> </div> <div class="section" id="s-name"> <span id="s-std:setting-NAME"></span><span id="name"></span><span id="std:setting-NAME"></span><h4>NAME<a class="headerlink" href="#name" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The name of the database to use. For SQLite, it's the full path to the database file. When specifying the path, always use forward slashes, even on Windows (e.g. <tt class="docutils literal"><span class="pre">C:/homes/user/mysite/sqlite3.db</span></tt>).</p> </div> <div class="section" id="s-std:setting-OPTIONS"> <span id="s-id1"></span><span id="std:setting-OPTIONS"></span><span id="id1"></span><h4>OPTIONS<a class="headerlink" href="#std:setting-OPTIONS" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">{}</span></tt> (Empty dictionary)</p> <p>Extra parameters to use when connecting to the database. Available parameters vary depending on your database backend.</p> <p>Some information on available parameters can be found in the <a class="reference internal" href="databases.html"><em>Database Backends</em></a> documentation. For more information, consult your backend module's own documentation.</p> </div> <div class="section" id="s-password"> <span id="s-std:setting-PASSWORD"></span><span id="password"></span><span id="std:setting-PASSWORD"></span><h4>PASSWORD<a class="headerlink" href="#password" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The password to use when connecting to the database. Not used with SQLite.</p> </div> <div class="section" id="s-port"> <span id="s-std:setting-PORT"></span><span id="port"></span><span id="std:setting-PORT"></span><h4>PORT<a class="headerlink" href="#port" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The port to use when connecting to the database. An empty string means the default port. Not used with SQLite.</p> </div> <div class="section" id="s-user"> <span id="s-std:setting-USER"></span><span id="user"></span><span id="std:setting-USER"></span><h4>USER<a class="headerlink" href="#user" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The username to use when connecting to the database. Not used with SQLite.</p> </div> <div class="section" id="s-test-charset"> <span id="s-std:setting-TEST_CHARSET"></span><span id="test-charset"></span><span id="std:setting-TEST_CHARSET"></span><h4>TEST_CHARSET<a class="headerlink" href="#test-charset" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The character set encoding used to create the test database. The value of this string is passed directly through to the database, so its format is backend-specific.</p> <p>Supported for the <a class="reference external" href="http://www.postgresql.org/docs/8.2/static/multibyte.html">PostgreSQL</a> (<tt class="docutils literal"><span class="pre">postgresql</span></tt>, <tt class="docutils literal"><span class="pre">postgresql_psycopg2</span></tt>) and <a class="reference external" href="http://dev.mysql.com/doc/refman/5.0/en/charset-database.html">MySQL</a> (<tt class="docutils literal"><span class="pre">mysql</span></tt>) backends.</p> </div> <div class="section" id="s-test-collation"> <span id="s-std:setting-TEST_COLLATION"></span><span id="test-collation"></span><span id="std:setting-TEST_COLLATION"></span><h4>TEST_COLLATION<a class="headerlink" href="#test-collation" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The collation order to use when creating the test database. This value is passed directly to the backend, so its format is backend-specific.</p> <p>Only supported for the <tt class="docutils literal"><span class="pre">mysql</span></tt> backend (see the <a class="reference external" href="http://dev.mysql.com/doc/refman/5.0/en/charset-database.html">MySQL manual</a> for details).</p> </div> <div class="section" id="s-test-dependencies"> <span id="s-std:setting-TEST_DEPENDENCIES"></span><span id="test-dependencies"></span><span id="std:setting-TEST_DEPENDENCIES"></span><h4>TEST_DEPENDENCIES<a class="headerlink" href="#test-dependencies" title="Permalink to this headline">¶</a></h4> <div class="versionadded"> <span class="title">New in Django 1.3:</span> <a class="reference internal" href="../releases/1.3.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">['default']</span></tt>, for all databases other than <tt class="docutils literal"><span class="pre">default</span></tt>, which has no dependencies.</p> <p>The creation-order dependencies of the database. See the documentation on <a class="reference internal" href="../topics/testing.html#topics-testing-creation-dependencies"><em>controlling the creation order of test databases</em></a> for details.</p> </div> <div class="section" id="s-test-mirror"> <span id="s-std:setting-TEST_MIRROR"></span><span id="test-mirror"></span><span id="std:setting-TEST_MIRROR"></span><h4>TEST_MIRROR<a class="headerlink" href="#test-mirror" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The alias of the database that this database should mirror during testing.</p> <p>This setting exists to allow for testing of master/slave configurations of multiple databases. See the documentation on <a class="reference internal" href="../topics/testing.html#topics-testing-masterslave"><em>testing master/slave configurations</em></a> for details.</p> </div> <div class="section" id="s-test-name"> <span id="s-std:setting-TEST_NAME"></span><span id="test-name"></span><span id="std:setting-TEST_NAME"></span><h4>TEST_NAME<a class="headerlink" href="#test-name" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The name of database to use when running the test suite.</p> <p>If the default value (<tt class="xref docutils literal"><span class="pre">None</span></tt>) is used with the SQLite database engine, the tests will use a memory resident database. For all other database engines the test database will use the name <tt class="docutils literal"><span class="pre">'test_'</span> <span class="pre">+</span> <span class="pre">DATABASE_NAME</span></tt>.</p> <p>See <a class="reference internal" href="../topics/testing.html"><em>Testing Django applications</em></a>.</p> </div> <div class="section" id="s-test-user"> <span id="s-std:setting-TEST_USER"></span><span id="test-user"></span><span id="std:setting-TEST_USER"></span><h4>TEST_USER<a class="headerlink" href="#test-user" title="Permalink to this headline">¶</a></h4> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>This is an Oracle-specific setting.</p> <p>The username to use when connecting to the Oracle database that will be used when running tests.</p> </div> </div> <div class="section" id="s-database-routers"> <span id="s-std:setting-DATABASE_ROUTERS"></span><span id="database-routers"></span><span id="std:setting-DATABASE_ROUTERS"></span><h3>DATABASE_ROUTERS<a class="headerlink" href="#database-routers" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">[]</span></tt> (Empty list)</p> <p>The list of routers that will be used to determine which database to use when performing a database queries.</p> <p>See the documentation on <a class="reference internal" href="../topics/db/multi-db.html#topics-db-multi-db-routing"><em>automatic database routing in multi database configurations</em></a>.</p> </div> <div class="section" id="s-date-format"> <span id="s-std:setting-DATE_FORMAT"></span><span id="date-format"></span><span id="std:setting-DATE_FORMAT"></span><h3>DATE_FORMAT<a class="headerlink" href="#date-format" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'N</span> <span class="pre">j,</span> <span class="pre">Y'</span></tt> (e.g. <tt class="docutils literal"><span class="pre">Feb.</span> <span class="pre">4,</span> <span class="pre">2003</span></tt>)</p> <p>The default formatting to use for displaying date fields in any part of the system. Note that if <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, then the locale-dictated format has higher precedence and will be applied instead. See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> This setting can now be overriden by setting <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> to <tt class="xref docutils literal"><span class="pre">True</span></tt>.</div> <p>See also <a class="reference internal" href="#std:setting-DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-TIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-SHORT_DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATE_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-date-input-formats"> <span id="s-std:setting-DATE_INPUT_FORMATS"></span><span id="date-input-formats"></span><span id="std:setting-DATE_INPUT_FORMATS"></span><h3>DATE_INPUT_FORMATS<a class="headerlink" href="#date-input-formats" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">'%Y-%m-</span><span class="si">%d</span><span class="s">'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%Y'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%y'</span><span class="p">,</span> <span class="s">'%b </span><span class="si">%d</span><span class="s"> %Y'</span><span class="p">,</span> <span class="s">'%b </span><span class="si">%d</span><span class="s">, %Y'</span><span class="p">,</span> <span class="s">'</span><span class="si">%d</span><span class="s"> %b %Y'</span><span class="p">,</span> <span class="s">'</span><span class="si">%d</span><span class="s"> %b, %Y'</span><span class="p">,</span> <span class="s">'%B </span><span class="si">%d</span><span class="s"> %Y'</span><span class="p">,</span> <span class="s">'%B </span><span class="si">%d</span><span class="s">, %Y'</span><span class="p">,</span> <span class="s">'</span><span class="si">%d</span><span class="s"> %B %Y'</span><span class="p">,</span> <span class="s">'</span><span class="si">%d</span><span class="s"> %B, %Y'</span><span class="p">)</span> </pre></div> </div> <p>A tuple of formats that will be accepted when inputting data on a date field. Formats will be tried in order, using the first valid. Note that these format strings are specified in Python's <a class="reference external" href="http://docs.python.org/library/datetime.html#strftime-strptime-behavior">datetime</a> module syntax, that is different from the one used by Django for formatting dates to be displayed.</p> <p>See also <a class="reference internal" href="#std:setting-DATETIME_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_INPUT_FORMATS</span></tt></a> and <a class="reference internal" href="#std:setting-TIME_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_INPUT_FORMATS</span></tt></a>.</p> </div> <div class="section" id="s-datetime-format"> <span id="s-std:setting-DATETIME_FORMAT"></span><span id="datetime-format"></span><span id="std:setting-DATETIME_FORMAT"></span><h3>DATETIME_FORMAT<a class="headerlink" href="#datetime-format" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'N</span> <span class="pre">j,</span> <span class="pre">Y,</span> <span class="pre">P'</span></tt> (e.g. <tt class="docutils literal"><span class="pre">Feb.</span> <span class="pre">4,</span> <span class="pre">2003,</span> <span class="pre">4</span> <span class="pre">p.m.</span></tt>)</p> <p>The default formatting to use for displaying datetime fields in any part of the system. Note that if <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, then the locale-dictated format has higher precedence and will be applied instead. See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> This setting can now be overriden by setting <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> to <tt class="xref docutils literal"><span class="pre">True</span></tt>.</div> <p>See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-TIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-SHORT_DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATETIME_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-datetime-input-formats"> <span id="s-std:setting-DATETIME_INPUT_FORMATS"></span><span id="datetime-input-formats"></span><span id="std:setting-DATETIME_INPUT_FORMATS"></span><h3>DATETIME_INPUT_FORMATS<a class="headerlink" href="#datetime-input-formats" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">'%Y-%m-</span><span class="si">%d</span><span class="s"> %H:%M:%S'</span><span class="p">,</span> <span class="s">'%Y-%m-</span><span class="si">%d</span><span class="s"> %H:%M'</span><span class="p">,</span> <span class="s">'%Y-%m-</span><span class="si">%d</span><span class="s">'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%Y %H:%M:%S'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%Y %H:%M'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%Y'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%y %H:%M:%S'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%y %H:%M'</span><span class="p">,</span> <span class="s">'%m/</span><span class="si">%d</span><span class="s">/%y'</span><span class="p">)</span> </pre></div> </div> <p>A tuple of formats that will be accepted when inputting data on a datetime field. Formats will be tried in order, using the first valid. Note that these format strings are specified in Python's <a class="reference external" href="http://docs.python.org/library/datetime.html#strftime-strptime-behavior">datetime</a> module syntax, that is different from the one used by Django for formatting dates to be displayed.</p> <p>See also <a class="reference internal" href="#std:setting-DATE_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_INPUT_FORMATS</span></tt></a> and <a class="reference internal" href="#std:setting-TIME_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_INPUT_FORMATS</span></tt></a>.</p> </div> <div class="section" id="s-debug"> <span id="s-std:setting-DEBUG"></span><span id="debug"></span><span id="std:setting-DEBUG"></span><h3>DEBUG<a class="headerlink" href="#debug" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that turns on/off debug mode.</p> <p>If you define custom settings, <a class="reference external" href="http://code.djangoproject.com/browser/django/trunk/django/views/debug.py">django/views/debug.py</a> has a <tt class="docutils literal"><span class="pre">HIDDEN_SETTINGS</span></tt> regular expression which will hide from the DEBUG view anything that contains <tt class="docutils literal"><span class="pre">'SECRET'</span></tt>, <tt class="docutils literal"><span class="pre">'PASSWORD'</span></tt>, <tt class="docutils literal"><span class="pre">'PROFANITIES'</span></tt>, or <tt class="docutils literal"><span class="pre">'SIGNATURE'</span></tt>. This allows untrusted users to be able to give backtraces without seeing sensitive (or offensive) settings.</p> <p>Still, note that there are always going to be sections of your debug output that are inappropriate for public consumption. File paths, configuration options, and the like all give attackers extra information about your server.</p> <p>It is also important to remember that when running with <a class="reference internal" href="#std:setting-DEBUG"><tt class="xref std std-setting docutils literal"><span class="pre">DEBUG</span></tt></a> turned on, Django will remember every SQL query it executes. This is useful when you are debugging, but on a production server, it will rapidly consume memory.</p> <p>Never deploy a site into production with <a class="reference internal" href="#std:setting-DEBUG"><tt class="xref std std-setting docutils literal"><span class="pre">DEBUG</span></tt></a> turned on.</p> </div> <div class="section" id="s-debug-propagate-exceptions"> <span id="debug-propagate-exceptions"></span><h3>DEBUG_PROPAGATE_EXCEPTIONS<a class="headerlink" href="#debug-propagate-exceptions" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>If set to True, Django's normal exception handling of view functions will be suppressed, and exceptions will propagate upwards. This can be useful for some test setups, and should never be used on a live site.</p> </div> <div class="section" id="s-decimal-separator"> <span id="s-std:setting-DECIMAL_SEPARATOR"></span><span id="decimal-separator"></span><span id="std:setting-DECIMAL_SEPARATOR"></span><h3>DECIMAL_SEPARATOR<a class="headerlink" href="#decimal-separator" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'.'</span></tt> (Dot)</p> <p>Default decimal separator used when formatting decimal numbers.</p> </div> <div class="section" id="s-default-charset"> <span id="s-std:setting-DEFAULT_CHARSET"></span><span id="default-charset"></span><span id="std:setting-DEFAULT_CHARSET"></span><h3>DEFAULT_CHARSET<a class="headerlink" href="#default-charset" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'utf-8'</span></tt></p> <p>Default charset to use for all <tt class="docutils literal"><span class="pre">HttpResponse</span></tt> objects, if a MIME type isn't manually specified. Used with <a class="reference internal" href="#std:setting-DEFAULT_CONTENT_TYPE"><tt class="xref std std-setting docutils literal"><span class="pre">DEFAULT_CONTENT_TYPE</span></tt></a> to construct the <tt class="docutils literal"><span class="pre">Content-Type</span></tt> header.</p> </div> <div class="section" id="s-default-content-type"> <span id="s-std:setting-DEFAULT_CONTENT_TYPE"></span><span id="default-content-type"></span><span id="std:setting-DEFAULT_CONTENT_TYPE"></span><h3>DEFAULT_CONTENT_TYPE<a class="headerlink" href="#default-content-type" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'text/html'</span></tt></p> <p>Default content type to use for all <tt class="docutils literal"><span class="pre">HttpResponse</span></tt> objects, if a MIME type isn't manually specified. Used with <a class="reference internal" href="#std:setting-DEFAULT_CHARSET"><tt class="xref std std-setting docutils literal"><span class="pre">DEFAULT_CHARSET</span></tt></a> to construct the <tt class="docutils literal"><span class="pre">Content-Type</span></tt> header.</p> </div> <div class="section" id="s-default-file-storage"> <span id="s-std:setting-DEFAULT_FILE_STORAGE"></span><span id="default-file-storage"></span><span id="std:setting-DEFAULT_FILE_STORAGE"></span><h3>DEFAULT_FILE_STORAGE<a class="headerlink" href="#default-file-storage" title="Permalink to this headline">¶</a></h3> <p>Default: <a class="reference internal" href="files/storage.html#django.core.files.storage.FileSystemStorage" title="django.core.files.storage.FileSystemStorage"><tt class="xref py py-class docutils literal"><span class="pre">django.core.files.storage.FileSystemStorage</span></tt></a></p> <p>Default file storage class to be used for any file-related operations that don't specify a particular storage system. See <a class="reference internal" href="../topics/files.html"><em>Managing files</em></a>.</p> </div> <div class="section" id="s-default-from-email"> <span id="s-std:setting-DEFAULT_FROM_EMAIL"></span><span id="default-from-email"></span><span id="std:setting-DEFAULT_FROM_EMAIL"></span><h3>DEFAULT_FROM_EMAIL<a class="headerlink" href="#default-from-email" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'webmaster@localhost'</span></tt></p> <p>Default e-mail address to use for various automated correspondence from the site manager(s).</p> </div> <div class="section" id="s-default-index-tablespace"> <span id="s-std:setting-DEFAULT_INDEX_TABLESPACE"></span><span id="default-index-tablespace"></span><span id="std:setting-DEFAULT_INDEX_TABLESPACE"></span><h3>DEFAULT_INDEX_TABLESPACE<a class="headerlink" href="#default-index-tablespace" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Default tablespace to use for indexes on fields that don't specify one, if the backend supports it.</p> </div> <div class="section" id="s-default-tablespace"> <span id="s-std:setting-DEFAULT_TABLESPACE"></span><span id="default-tablespace"></span><span id="std:setting-DEFAULT_TABLESPACE"></span><h3>DEFAULT_TABLESPACE<a class="headerlink" href="#default-tablespace" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Default tablespace to use for models that don't specify one, if the backend supports it.</p> </div> <div class="section" id="s-disallowed-user-agents"> <span id="s-std:setting-DISALLOWED_USER_AGENTS"></span><span id="disallowed-user-agents"></span><span id="std:setting-DISALLOWED_USER_AGENTS"></span><h3>DISALLOWED_USER_AGENTS<a class="headerlink" href="#disallowed-user-agents" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>List of compiled regular expression objects representing User-Agent strings that are not allowed to visit any page, systemwide. Use this for bad robots/crawlers. This is only used if <tt class="docutils literal"><span class="pre">CommonMiddleware</span></tt> is installed (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>).</p> </div> <div class="section" id="s-email-backend"> <span id="s-std:setting-EMAIL_BACKEND"></span><span id="email-backend"></span><span id="std:setting-EMAIL_BACKEND"></span><h3>EMAIL_BACKEND<a class="headerlink" href="#email-backend" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'django.core.mail.backends.smtp.EmailBackend'</span></tt></p> <p>The backend to use for sending emails. For the list of available backends see <a class="reference internal" href="../topics/email.html"><em>Sending e-mail</em></a>.</p> </div> <div class="section" id="s-email-file-path"> <span id="s-std:setting-EMAIL_FILE_PATH"></span><span id="email-file-path"></span><span id="std:setting-EMAIL_FILE_PATH"></span><h3>EMAIL_FILE_PATH<a class="headerlink" href="#email-file-path" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: Not defined</p> <p>The directory used by the <tt class="docutils literal"><span class="pre">file</span></tt> email backend to store output files.</p> </div> <div class="section" id="s-email-host"> <span id="s-std:setting-EMAIL_HOST"></span><span id="email-host"></span><span id="std:setting-EMAIL_HOST"></span><h3>EMAIL_HOST<a class="headerlink" href="#email-host" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'localhost'</span></tt></p> <p>The host to use for sending e-mail.</p> <p>See also <a class="reference internal" href="#std:setting-EMAIL_PORT"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_PORT</span></tt></a>.</p> </div> <div class="section" id="s-email-host-password"> <span id="s-std:setting-EMAIL_HOST_PASSWORD"></span><span id="email-host-password"></span><span id="std:setting-EMAIL_HOST_PASSWORD"></span><h3>EMAIL_HOST_PASSWORD<a class="headerlink" href="#email-host-password" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Password to use for the SMTP server defined in <a class="reference internal" href="#std:setting-EMAIL_HOST"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST</span></tt></a>. This setting is used in conjunction with <a class="reference internal" href="#std:setting-EMAIL_HOST_USER"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST_USER</span></tt></a> when authenticating to the SMTP server. If either of these settings is empty, Django won't attempt authentication.</p> <p>See also <a class="reference internal" href="#std:setting-EMAIL_HOST_USER"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST_USER</span></tt></a>.</p> </div> <div class="section" id="s-email-host-user"> <span id="s-std:setting-EMAIL_HOST_USER"></span><span id="email-host-user"></span><span id="std:setting-EMAIL_HOST_USER"></span><h3>EMAIL_HOST_USER<a class="headerlink" href="#email-host-user" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Username to use for the SMTP server defined in <a class="reference internal" href="#std:setting-EMAIL_HOST"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST</span></tt></a>. If empty, Django won't attempt authentication.</p> <p>See also <a class="reference internal" href="#std:setting-EMAIL_HOST_PASSWORD"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST_PASSWORD</span></tt></a>.</p> </div> <div class="section" id="s-email-port"> <span id="s-std:setting-EMAIL_PORT"></span><span id="email-port"></span><span id="std:setting-EMAIL_PORT"></span><h3>EMAIL_PORT<a class="headerlink" href="#email-port" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">25</span></tt></p> <p>Port to use for the SMTP server defined in <a class="reference internal" href="#std:setting-EMAIL_HOST"><tt class="xref std std-setting docutils literal"><span class="pre">EMAIL_HOST</span></tt></a>.</p> </div> <div class="section" id="s-email-subject-prefix"> <span id="s-std:setting-EMAIL_SUBJECT_PREFIX"></span><span id="email-subject-prefix"></span><span id="std:setting-EMAIL_SUBJECT_PREFIX"></span><h3>EMAIL_SUBJECT_PREFIX<a class="headerlink" href="#email-subject-prefix" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'[Django]</span> <span class="pre">'</span></tt></p> <p>Subject-line prefix for e-mail messages sent with <tt class="docutils literal"><span class="pre">django.core.mail.mail_admins</span></tt> or <tt class="docutils literal"><span class="pre">django.core.mail.mail_managers</span></tt>. You'll probably want to include the trailing space.</p> </div> <div class="section" id="s-email-use-tls"> <span id="s-std:setting-EMAIL_USE_TLS"></span><span id="email-use-tls"></span><span id="std:setting-EMAIL_USE_TLS"></span><h3>EMAIL_USE_TLS<a class="headerlink" href="#email-use-tls" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to use a TLS (secure) connection when talking to the SMTP server.</p> </div> <div class="section" id="s-file-charset"> <span id="s-std:setting-FILE_CHARSET"></span><span id="file-charset"></span><span id="std:setting-FILE_CHARSET"></span><h3>FILE_CHARSET<a class="headerlink" href="#file-charset" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'utf-8'</span></tt></p> <p>The character encoding used to decode any files read from disk. This includes template files and initial SQL data files.</p> </div> <div class="section" id="s-file-upload-handlers"> <span id="s-std:setting-FILE_UPLOAD_HANDLERS"></span><span id="file-upload-handlers"></span><span id="std:setting-FILE_UPLOAD_HANDLERS"></span><h3>FILE_UPLOAD_HANDLERS<a class="headerlink" href="#file-upload-handlers" title="Permalink to this headline">¶</a></h3> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">"django.core.files.uploadhandler.MemoryFileUploadHandler"</span><span class="p">,</span> <span class="s">"django.core.files.uploadhandler.TemporaryFileUploadHandler"</span><span class="p">,)</span> </pre></div> </div> <p>A tuple of handlers to use for uploading. See <a class="reference internal" href="../topics/files.html"><em>Managing files</em></a> for details.</p> </div> <div class="section" id="s-file-upload-max-memory-size"> <span id="s-std:setting-FILE_UPLOAD_MAX_MEMORY_SIZE"></span><span id="file-upload-max-memory-size"></span><span id="std:setting-FILE_UPLOAD_MAX_MEMORY_SIZE"></span><h3>FILE_UPLOAD_MAX_MEMORY_SIZE<a class="headerlink" href="#file-upload-max-memory-size" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">2621440</span></tt> (i.e. 2.5 MB).</p> <p>The maximum size (in bytes) that an upload will be before it gets streamed to the file system. See <a class="reference internal" href="../topics/files.html"><em>Managing files</em></a> for details.</p> </div> <div class="section" id="s-file-upload-permissions"> <span id="s-std:setting-FILE_UPLOAD_PERMISSIONS"></span><span id="file-upload-permissions"></span><span id="std:setting-FILE_UPLOAD_PERMISSIONS"></span><h3>FILE_UPLOAD_PERMISSIONS<a class="headerlink" href="#file-upload-permissions" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The numeric mode (i.e. <tt class="docutils literal"><span class="pre">0644</span></tt>) to set newly uploaded files to. For more information about what these modes mean, see the <a class="reference external" href="http://docs.python.org/library/os.html#os.chmod">documentation for os.chmod</a></p> <p>If this isn't given or is <tt class="xref docutils literal"><span class="pre">None</span></tt>, you'll get operating-system dependent behavior. On most platforms, temporary files will have a mode of <tt class="docutils literal"><span class="pre">0600</span></tt>, and files saved from memory will be saved using the system's standard umask.</p> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p><strong>Always prefix the mode with a 0.</strong></p> <p class="last">If you're not familiar with file modes, please note that the leading <tt class="docutils literal"><span class="pre">0</span></tt> is very important: it indicates an octal number, which is the way that modes must be specified. If you try to use <tt class="docutils literal"><span class="pre">644</span></tt>, you'll get totally incorrect behavior.</p> </div> </div> <div class="section" id="s-file-upload-temp-dir"> <span id="s-std:setting-FILE_UPLOAD_TEMP_DIR"></span><span id="file-upload-temp-dir"></span><span id="std:setting-FILE_UPLOAD_TEMP_DIR"></span><h3>FILE_UPLOAD_TEMP_DIR<a class="headerlink" href="#file-upload-temp-dir" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The directory to store data temporarily while uploading files. If <tt class="xref docutils literal"><span class="pre">None</span></tt>, Django will use the standard temporary directory for the operating system. For example, this will default to '/tmp' on *nix-style operating systems.</p> <p>See <a class="reference internal" href="../topics/files.html"><em>Managing files</em></a> for details.</p> </div> <div class="section" id="s-first-day-of-week"> <span id="s-std:setting-FIRST_DAY_OF_WEEK"></span><span id="first-day-of-week"></span><span id="std:setting-FIRST_DAY_OF_WEEK"></span><h3>FIRST_DAY_OF_WEEK<a class="headerlink" href="#first-day-of-week" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">0</span></tt> (Sunday)</p> <p>Number representing the first day of the week. This is especially useful when displaying a calendar. This value is only used when not using format internationalization, or when a format cannot be found for the current locale.</p> <p>The value must be an integer from 0 to 6, where 0 means Sunday, 1 means Monday and so on.</p> </div> <div class="section" id="s-fixture-dirs"> <span id="s-std:setting-FIXTURE_DIRS"></span><span id="fixture-dirs"></span><span id="std:setting-FIXTURE_DIRS"></span><h3>FIXTURE_DIRS<a class="headerlink" href="#fixture-dirs" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>List of locations of the fixture data files, in search order. Note that these paths should use Unix-style forward slashes, even on Windows. See <a class="reference internal" href="../topics/testing.html"><em>Testing Django applications</em></a>.</p> </div> <div class="section" id="s-force-script-name"> <span id="force-script-name"></span><h3>FORCE_SCRIPT_NAME<a class="headerlink" href="#force-script-name" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>If not <tt class="xref docutils literal"><span class="pre">None</span></tt>, this will be used as the value of the <tt class="docutils literal"><span class="pre">SCRIPT_NAME</span></tt> environment variable in any HTTP request. This setting can be used to override the server-provided value of <tt class="docutils literal"><span class="pre">SCRIPT_NAME</span></tt>, which may be a rewritten version of the preferred value or not supplied at all.</p> </div> <div class="section" id="s-format-module-path"> <span id="s-std:setting-FORMAT_MODULE_PATH"></span><span id="format-module-path"></span><span id="std:setting-FORMAT_MODULE_PATH"></span><h3>FORMAT_MODULE_PATH<a class="headerlink" href="#format-module-path" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>A full Python path to a Python package that contains format definitions for project locales. If not <tt class="xref docutils literal"><span class="pre">None</span></tt>, Django will check for a <tt class="docutils literal"><span class="pre">formats.py</span></tt> file, under the directory named as the current locale, and will use the formats defined on this file.</p> <p>For example, if <a class="reference internal" href="#std:setting-FORMAT_MODULE_PATH"><tt class="xref std std-setting docutils literal"><span class="pre">FORMAT_MODULE_PATH</span></tt></a> is set to <tt class="docutils literal"><span class="pre">mysite.formats</span></tt>, and current language is <tt class="docutils literal"><span class="pre">en</span></tt> (English), Django will expect a directory tree like:</p> <div class="highlight-python"><pre>mysite/ formats/ __init__.py en/ __init__.py formats.py</pre> </div> <p>Available formats are <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-TIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-YEAR_MONTH_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">YEAR_MONTH_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-MONTH_DAY_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">MONTH_DAY_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-SHORT_DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATE_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-SHORT_DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATETIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-FIRST_DAY_OF_WEEK"><tt class="xref std std-setting docutils literal"><span class="pre">FIRST_DAY_OF_WEEK</span></tt></a>, <a class="reference internal" href="#std:setting-DECIMAL_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">DECIMAL_SEPARATOR</span></tt></a>, <a class="reference internal" href="#std:setting-THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">THOUSAND_SEPARATOR</span></tt></a> and <a class="reference internal" href="#std:setting-NUMBER_GROUPING"><tt class="xref std std-setting docutils literal"><span class="pre">NUMBER_GROUPING</span></tt></a>.</p> </div> <div class="section" id="s-ignorable-404-ends"> <span id="s-std:setting-IGNORABLE_404_ENDS"></span><span id="ignorable-404-ends"></span><span id="std:setting-IGNORABLE_404_ENDS"></span><h3>IGNORABLE_404_ENDS<a class="headerlink" href="#ignorable-404-ends" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">('mail.pl',</span> <span class="pre">'mailform.pl',</span> <span class="pre">'mail.cgi',</span> <span class="pre">'mailform.cgi',</span> <span class="pre">'favicon.ico',</span> <span class="pre">'.php')</span></tt></p> <p>See also <tt class="docutils literal"><span class="pre">IGNORABLE_404_STARTS</span></tt> and <tt class="docutils literal"><span class="pre">Error</span> <span class="pre">reporting</span> <span class="pre">via</span> <span class="pre">e-mail</span></tt>.</p> </div> <div class="section" id="s-ignorable-404-starts"> <span id="s-std:setting-IGNORABLE_404_STARTS"></span><span id="ignorable-404-starts"></span><span id="std:setting-IGNORABLE_404_STARTS"></span><h3>IGNORABLE_404_STARTS<a class="headerlink" href="#ignorable-404-starts" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">('/cgi-bin/',</span> <span class="pre">'/_vti_bin',</span> <span class="pre">'/_vti_inf')</span></tt></p> <p>A tuple of strings that specify beginnings of URLs that should be ignored by the 404 e-mailer. See <tt class="docutils literal"><span class="pre">SEND_BROKEN_LINK_EMAILS</span></tt>, <tt class="docutils literal"><span class="pre">IGNORABLE_404_ENDS</span></tt> and the <a class="reference internal" href="../howto/error-reporting.html"><em>Error reporting via e-mail</em></a>.</p> </div> <div class="section" id="s-installed-apps"> <span id="s-std:setting-INSTALLED_APPS"></span><span id="installed-apps"></span><span id="std:setting-INSTALLED_APPS"></span><h3>INSTALLED_APPS<a class="headerlink" href="#installed-apps" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple of strings designating all applications that are enabled in this Django installation. Each string should be a full Python path to a Python package that contains a Django application, as created by <a class="reference internal" href="django-admin.html#django-admin-startapp"><tt class="xref std std-djadmin docutils literal"><span class="pre">django-admin.py</span> <span class="pre">startapp</span></tt></a>.</p> <div class="admonition-app-names-must-be-unique admonition"> <p class="first admonition-title">App names must be unique</p> <p class="last">The application names (that is, the final dotted part of the path to the module containing <tt class="docutils literal"><span class="pre">models.py</span></tt>) defined in <a class="reference internal" href="#std:setting-INSTALLED_APPS"><tt class="xref std std-setting docutils literal"><span class="pre">INSTALLED_APPS</span></tt></a> <em>must</em> be unique. For example, you can't include both <tt class="docutils literal"><span class="pre">django.contrib.auth</span></tt> and <tt class="docutils literal"><span class="pre">myproject.auth</span></tt> in INSTALLED_APPS.</p> </div> </div> <div class="section" id="s-internal-ips"> <span id="s-std:setting-INTERNAL_IPS"></span><span id="internal-ips"></span><span id="std:setting-INTERNAL_IPS"></span><h3>INTERNAL_IPS<a class="headerlink" href="#internal-ips" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple of IP addresses, as strings, that:</p> <ul class="simple"> <li>See debug comments, when <a class="reference internal" href="#std:setting-DEBUG"><tt class="xref std std-setting docutils literal"><span class="pre">DEBUG</span></tt></a> is <tt class="xref docutils literal"><span class="pre">True</span></tt></li> <li>Receive X headers if the <tt class="docutils literal"><span class="pre">XViewMiddleware</span></tt> is installed (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>)</li> </ul> </div> <div class="section" id="s-language-code"> <span id="s-std:setting-LANGUAGE_CODE"></span><span id="language-code"></span><span id="std:setting-LANGUAGE_CODE"></span><h3>LANGUAGE_CODE<a class="headerlink" href="#language-code" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'en-us'</span></tt></p> <p>A string representing the language code for this installation. This should be in standard <a class="reference internal" href="../topics/i18n/index.html#term-language-code"><em class="xref std std-term">language format</em></a>. For example, U.S. English is <tt class="docutils literal"><span class="pre">"en-us"</span></tt>. See <a class="reference internal" href="../topics/i18n/index.html"><em>Internationalization and localization</em></a>.</p> </div> <div class="section" id="s-language-cookie-name"> <span id="s-std:setting-LANGUAGE_COOKIE_NAME"></span><span id="language-cookie-name"></span><span id="std:setting-LANGUAGE_COOKIE_NAME"></span><h3>LANGUAGE_COOKIE_NAME<a class="headerlink" href="#language-cookie-name" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'django_language'</span></tt></p> <p>The name of the cookie to use for the language cookie. This can be whatever you want (but should be different from <a class="reference internal" href="#std:setting-SESSION_COOKIE_NAME"><tt class="xref std std-setting docutils literal"><span class="pre">SESSION_COOKIE_NAME</span></tt></a>). See <a class="reference internal" href="../topics/i18n/index.html"><em>Internationalization and localization</em></a>.</p> </div> <div class="section" id="s-languages"> <span id="s-std:setting-LANGUAGES"></span><span id="languages"></span><span id="std:setting-LANGUAGES"></span><h3>LANGUAGES<a class="headerlink" href="#languages" title="Permalink to this headline">¶</a></h3> <p>Default: 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 <tt class="docutils literal"><span class="pre">django/conf/global_settings.py</span></tt> (or view the <a class="reference external" href="http://code.djangoproject.com/browser/django/trunk/django/conf/global_settings.py">online source</a>).</p> <p>The list is a tuple of two-tuples in the format <tt class="docutils literal"><span class="pre">(language</span> <span class="pre">code,</span> <span class="pre">language</span> <span class="pre">name)</span></tt>, the <tt class="docutils literal"><span class="pre">language</span> <span class="pre">code</span></tt> part should be a <a class="reference internal" href="../topics/i18n/index.html#term-language-code"><em class="xref std std-term">language name</em></a> -- for example, <tt class="docutils literal"><span class="pre">('ja',</span> <span class="pre">'Japanese')</span></tt>. This specifies which languages are available for language selection. See <a class="reference internal" href="../topics/i18n/index.html"><em>Internationalization and localization</em></a>.</p> <p>Generally, the default value should suffice. Only set this setting if you want to restrict language selection to a subset of the Django-provided languages.</p> <p>If you define a custom <a class="reference internal" href="#std:setting-LANGUAGES"><tt class="xref std std-setting docutils literal"><span class="pre">LANGUAGES</span></tt></a> setting, it's OK to mark the languages as translation strings (as in the default value referred to above) -- but use a "dummy" <tt class="docutils literal"><span class="pre">gettext()</span></tt> function, not the one in <tt class="docutils literal"><span class="pre">django.utils.translation</span></tt>. You should <em>never</em> import <tt class="docutils literal"><span class="pre">django.utils.translation</span></tt> from within your settings file, because that module in itself depends on the settings, and that would cause a circular import.</p> <p>The solution is to use a "dummy" <tt class="docutils literal"><span class="pre">gettext()</span></tt> function. Here's a sample settings file:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">gettext</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span> <span class="n">LANGUAGES</span> <span class="o">=</span> <span class="p">(</span> <span class="p">(</span><span class="s">'de'</span><span class="p">,</span> <span class="n">gettext</span><span class="p">(</span><span class="s">'German'</span><span class="p">)),</span> <span class="p">(</span><span class="s">'en'</span><span class="p">,</span> <span class="n">gettext</span><span class="p">(</span><span class="s">'English'</span><span class="p">)),</span> <span class="p">)</span> </pre></div> </div> <p>With this arrangement, <tt class="docutils literal"><span class="pre">django-admin.py</span> <span class="pre">makemessages</span></tt> will still find and mark these strings for translation, but the translation won't happen at runtime -- so you'll have to remember to wrap the languages in the <em>real</em> <tt class="docutils literal"><span class="pre">gettext()</span></tt> in any code that uses <a class="reference internal" href="#std:setting-LANGUAGES"><tt class="xref std std-setting docutils literal"><span class="pre">LANGUAGES</span></tt></a> at runtime.</p> </div> <div class="section" id="s-locale-paths"> <span id="s-std:setting-LOCALE_PATHS"></span><span id="locale-paths"></span><span id="std:setting-LOCALE_PATHS"></span><h3>LOCALE_PATHS<a class="headerlink" href="#locale-paths" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple of directories where Django looks for translation files. See <a class="reference internal" href="../howto/i18n.html#using-translations-in-your-own-projects"><em>Using internationalization in your own projects</em></a>.</p> <p>Example:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">LOCALE_PATHS</span> <span class="o">=</span> <span class="p">(</span> <span class="s">'/home/www/project/common_files/locale'</span><span class="p">,</span> <span class="s">'/var/local/translations/locale'</span> <span class="p">)</span> </pre></div> </div> <p>Note that in the paths you add to the value of this setting, if you have the typical <tt class="docutils literal"><span class="pre">/path/to/locale/xx/LC_MESSAGES</span></tt> hierarchy, you should use the path to the <tt class="docutils literal"><span class="pre">locale</span></tt> directory (i.e. <tt class="docutils literal"><span class="pre">'/path/to/locale'</span></tt>).</p> </div> <div class="section" id="s-logging"> <span id="s-std:setting-LOGGING"></span><span id="logging"></span><span id="std:setting-LOGGING"></span><h3>LOGGING<a class="headerlink" href="#logging" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.3:</span> <a class="reference internal" href="../releases/1.3.html"><em>Please, see the release notes</em></a></div> <p>Default: A logging configuration dictionary.</p> <p>A data structure containing configuration information. The contents of this data structure will be passed as the argument to the configuration method described in <a class="reference internal" href="#std:setting-LOGGING_CONFIG"><tt class="xref std std-setting docutils literal"><span class="pre">LOGGING_CONFIG</span></tt></a>.</p> <p>The default logging configuration passes HTTP 500 server errors to an email log handler; all other log messages are given to a NullHandler.</p> </div> <div class="section" id="s-logging-config"> <span id="s-std:setting-LOGGING_CONFIG"></span><span id="logging-config"></span><span id="std:setting-LOGGING_CONFIG"></span><h3>LOGGING_CONFIG<a class="headerlink" href="#logging-config" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.3:</span> <a class="reference internal" href="../releases/1.3.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'django.utils.log.dictConfig'</span></tt></p> <p>A path to a callable that will be used to configure logging in the Django project. Points at a instance of Python's <a class="reference external" href="http://docs.python.org/library/logging.config.html#configuration-dictionary-schema">dictConfig</a> configuration method by default.</p> <p>If you set <a class="reference internal" href="#std:setting-LOGGING_CONFIG"><tt class="xref std std-setting docutils literal"><span class="pre">LOGGING_CONFIG</span></tt></a> to <tt class="xref docutils literal"><span class="pre">None</span></tt>, the logging configuration process will be skipped.</p> </div> <div class="section" id="s-login-redirect-url"> <span id="s-std:setting-LOGIN_REDIRECT_URL"></span><span id="login-redirect-url"></span><span id="std:setting-LOGIN_REDIRECT_URL"></span><h3>LOGIN_REDIRECT_URL<a class="headerlink" href="#login-redirect-url" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'/accounts/profile/'</span></tt></p> <p>The URL where requests are redirected after login when the <tt class="docutils literal"><span class="pre">contrib.auth.login</span></tt> view gets no <tt class="docutils literal"><span class="pre">next</span></tt> parameter.</p> <p>This is used by the <a class="reference internal" href="../topics/auth.html#django.contrib.auth.decorators.login_required" title="django.contrib.auth.decorators.login_required"><tt class="xref py py-func docutils literal"><span class="pre">login_required()</span></tt></a> decorator, for example.</p> </div> <div class="section" id="s-login-url"> <span id="s-std:setting-LOGIN_URL"></span><span id="login-url"></span><span id="std:setting-LOGIN_URL"></span><h3>LOGIN_URL<a class="headerlink" href="#login-url" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'/accounts/login/'</span></tt></p> <p>The URL where requests are redirected for login, especially when using the <a class="reference internal" href="../topics/auth.html#django.contrib.auth.decorators.login_required" title="django.contrib.auth.decorators.login_required"><tt class="xref py py-func docutils literal"><span class="pre">login_required()</span></tt></a> decorator.</p> </div> <div class="section" id="s-logout-url"> <span id="s-std:setting-LOGOUT_URL"></span><span id="logout-url"></span><span id="std:setting-LOGOUT_URL"></span><h3>LOGOUT_URL<a class="headerlink" href="#logout-url" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'/accounts/logout/'</span></tt></p> <p>LOGIN_URL counterpart.</p> </div> <div class="section" id="s-managers"> <span id="s-std:setting-MANAGERS"></span><span id="managers"></span><span id="std:setting-MANAGERS"></span><h3>MANAGERS<a class="headerlink" href="#managers" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple in the same format as <a class="reference internal" href="#std:setting-ADMINS"><tt class="xref std std-setting docutils literal"><span class="pre">ADMINS</span></tt></a> that specifies who should get broken-link notifications when <tt class="docutils literal"><span class="pre">SEND_BROKEN_LINK_EMAILS=True</span></tt>.</p> </div> <div class="section" id="s-media-root"> <span id="s-std:setting-MEDIA_ROOT"></span><span id="media-root"></span><span id="std:setting-MEDIA_ROOT"></span><h3>MEDIA_ROOT<a class="headerlink" href="#media-root" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Absolute path to the directory that holds media for this installation, used for <a class="reference internal" href="../topics/files.html"><em>managing stored files</em></a>.</p> <p>Example: <tt class="docutils literal"><span class="pre">"/home/media/media.lawrence.com/"</span></tt></p> <p>See also <a class="reference internal" href="#std:setting-MEDIA_URL"><tt class="xref std std-setting docutils literal"><span class="pre">MEDIA_URL</span></tt></a>.</p> </div> <div class="section" id="s-media-url"> <span id="s-std:setting-MEDIA_URL"></span><span id="media-url"></span><span id="std:setting-MEDIA_URL"></span><h3>MEDIA_URL<a class="headerlink" href="#media-url" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>URL that handles the media served from <a class="reference internal" href="#std:setting-MEDIA_ROOT"><tt class="xref std std-setting docutils literal"><span class="pre">MEDIA_ROOT</span></tt></a>, used for <a class="reference internal" href="../topics/files.html"><em>managing stored files</em></a>.</p> <p>Example: <tt class="docutils literal"><span class="pre">"http://media.lawrence.com/"</span></tt></p> <div class="versionchanged"> <span class="title">Changed in Django 1.3:</span> It must end in a slash if set to a non-empty value.</div> </div> <div class="section" id="s-message-level"> <span id="message-level"></span><h3>MESSAGE_LEVEL<a class="headerlink" href="#message-level" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <cite>messages.INFO</cite></p> <p>Sets the minimum message level that will be recorded by the messages framework. See the <a class="reference internal" href="contrib/messages.html"><em>messages documentation</em></a> for more details.</p> </div> <div class="section" id="s-message-storage"> <span id="message-storage"></span><h3>MESSAGE_STORAGE<a class="headerlink" href="#message-storage" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">'django.contrib.messages.storage.user_messages.LegacyFallbackStorage'</span></tt></p> <p>Controls where Django stores message data. See the <a class="reference internal" href="contrib/messages.html"><em>messages documentation</em></a> for more details.</p> </div> <div class="section" id="s-message-tags"> <span id="message-tags"></span><h3>MESSAGE_TAGS<a class="headerlink" href="#message-tags" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">{</span><span class="n">messages</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">:</span> <span class="s">'debug'</span><span class="p">,</span> <span class="n">messages</span><span class="o">.</span><span class="n">INFO</span><span class="p">:</span> <span class="s">'info'</span><span class="p">,</span> <span class="n">messages</span><span class="o">.</span><span class="n">SUCCESS</span><span class="p">:</span> <span class="s">'success'</span><span class="p">,</span> <span class="n">messages</span><span class="o">.</span><span class="n">WARNING</span><span class="p">:</span> <span class="s">'warning'</span><span class="p">,</span> <span class="n">messages</span><span class="o">.</span><span class="n">ERROR</span><span class="p">:</span> <span class="s">'error'</span><span class="p">,}</span> </pre></div> </div> <p>Sets the mapping of message levels to message tags. See the <a class="reference internal" href="contrib/messages.html"><em>messages documentation</em></a> for more details.</p> </div> <div class="section" id="s-middleware-classes"> <span id="s-std:setting-MIDDLEWARE_CLASSES"></span><span id="middleware-classes"></span><span id="std:setting-MIDDLEWARE_CLASSES"></span><h3>MIDDLEWARE_CLASSES<a class="headerlink" href="#middleware-classes" title="Permalink to this headline">¶</a></h3> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">'django.middleware.common.CommonMiddleware'</span><span class="p">,</span> <span class="s">'django.contrib.sessions.middleware.SessionMiddleware'</span><span class="p">,</span> <span class="s">'django.middleware.csrf.CsrfViewMiddleware'</span><span class="p">,</span> <span class="s">'django.contrib.auth.middleware.AuthenticationMiddleware'</span><span class="p">,</span> <span class="s">'django.contrib.messages.middleware.MessageMiddleware'</span><span class="p">,)</span> </pre></div> </div> <p>A tuple of middleware classes to use. See <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> <tt class="docutils literal"><span class="pre">'django.contrib.messages.middleware.MessageMiddleware'</span></tt> was added to the default. For more information, see the <a class="reference internal" href="contrib/messages.html"><em>messages documentation</em></a>.</div> </div> <div class="section" id="s-month-day-format"> <span id="s-std:setting-MONTH_DAY_FORMAT"></span><span id="month-day-format"></span><span id="std:setting-MONTH_DAY_FORMAT"></span><h3>MONTH_DAY_FORMAT<a class="headerlink" href="#month-day-format" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'F</span> <span class="pre">j'</span></tt></p> <p>The default formatting to use for date fields on Django admin change-list pages -- and, possibly, by other parts of the system -- in cases when only the month and day are displayed.</p> <p>For example, when a Django admin change-list page is being filtered by a date drilldown, the header for a given day displays the day and month. Different locales have different formats. For example, U.S. English would say "January 1," whereas Spanish might say "1 Enero."</p> <p>See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>. See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-TIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-YEAR_MONTH_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">YEAR_MONTH_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-number-grouping"> <span id="s-std:setting-NUMBER_GROUPING"></span><span id="number-grouping"></span><span id="std:setting-NUMBER_GROUPING"></span><h3>NUMBER_GROUPING<a class="headerlink" href="#number-grouping" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">0</span></tt></p> <p>Number of digits grouped together on the integer part of a number. Common use is to display a thousand separator. If this setting is <tt class="docutils literal"><span class="pre">0</span></tt>, then, no grouping will be applied to the number. If this setting is greater than <tt class="docutils literal"><span class="pre">0</span></tt> then the setting <a class="reference internal" href="#std:setting-THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">THOUSAND_SEPARATOR</span></tt></a> will be used as the separator between those groups.</p> <p>See also <a class="reference internal" href="#std:setting-THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">THOUSAND_SEPARATOR</span></tt></a> and <a class="reference internal" href="#std:setting-USE_THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">USE_THOUSAND_SEPARATOR</span></tt></a>.</p> </div> <div class="section" id="s-password-reset-timeout-days"> <span id="s-std:setting-PASSWORD_RESET_TIMEOUT_DAYS"></span><span id="password-reset-timeout-days"></span><span id="std:setting-PASSWORD_RESET_TIMEOUT_DAYS"></span><h3>PASSWORD_RESET_TIMEOUT_DAYS<a class="headerlink" href="#password-reset-timeout-days" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">3</span></tt></p> <p>The number of days a password reset link is valid for. Used by the <a class="reference internal" href="../topics/auth.html#module-django.contrib.auth" title="django.contrib.auth: Django's authentication framework."><tt class="xref py py-mod docutils literal"><span class="pre">django.contrib.auth</span></tt></a> password reset mechanism.</p> </div> <div class="section" id="s-prepend-www"> <span id="s-std:setting-PREPEND_WWW"></span><span id="prepend-www"></span><span id="std:setting-PREPEND_WWW"></span><h3>PREPEND_WWW<a class="headerlink" href="#prepend-www" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to prepend the "www." subdomain to URLs that don't have it. This is only used if <a class="reference internal" href="middleware.html#django.middleware.common.CommonMiddleware" title="django.middleware.common.CommonMiddleware"><tt class="xref py py-class docutils literal"><span class="pre">CommonMiddleware</span></tt></a> is installed (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>). See also <a class="reference internal" href="#std:setting-APPEND_SLASH"><tt class="xref std std-setting docutils literal"><span class="pre">APPEND_SLASH</span></tt></a>.</p> </div> <div class="section" id="s-profanities-list"> <span id="s-std:setting-PROFANITIES_LIST"></span><span id="profanities-list"></span><span id="std:setting-PROFANITIES_LIST"></span><h3>PROFANITIES_LIST<a class="headerlink" href="#profanities-list" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>A tuple of profanities, as strings, that will trigger a validation error when the <tt class="docutils literal"><span class="pre">hasNoProfanities</span></tt> validator is called.</p> </div> <div class="section" id="s-restructuredtext-filter-settings"> <span id="s-std:setting-RESTRUCTUREDTEXT_FILTER_SETTINGS"></span><span id="restructuredtext-filter-settings"></span><span id="std:setting-RESTRUCTUREDTEXT_FILTER_SETTINGS"></span><h3>RESTRUCTUREDTEXT_FILTER_SETTINGS<a class="headerlink" href="#restructuredtext-filter-settings" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">{}</span></tt></p> <p>A dictionary containing settings for the <tt class="docutils literal"><span class="pre">restructuredtext</span></tt> markup filter from the <a class="reference internal" href="contrib/markup.html"><em>django.contrib.markup application</em></a>. They override the default writer settings. See the Docutils restructuredtext <a class="reference external" href="http://docutils.sourceforge.net/docs/user/config.html#html4css1-writer">writer settings docs</a> for details.</p> </div> <div class="section" id="s-root-urlconf"> <span id="s-std:setting-ROOT_URLCONF"></span><span id="root-urlconf"></span><span id="std:setting-ROOT_URLCONF"></span><h3>ROOT_URLCONF<a class="headerlink" href="#root-urlconf" title="Permalink to this headline">¶</a></h3> <p>Default: Not defined</p> <p>A string representing the full Python import path to your root URLconf. For example: <tt class="docutils literal"><span class="pre">"mydjangoapps.urls"</span></tt>. Can be overridden on a per-request basis by setting the attribute <tt class="docutils literal"><span class="pre">urlconf</span></tt> on the incoming <tt class="docutils literal"><span class="pre">HttpRequest</span></tt> object. See <a class="reference internal" href="../topics/http/urls.html#how-django-processes-a-request"><em>How Django processes a request</em></a> for details.</p> </div> <div class="section" id="s-secret-key"> <span id="s-std:setting-SECRET_KEY"></span><span id="secret-key"></span><span id="std:setting-SECRET_KEY"></span><h3>SECRET_KEY<a class="headerlink" href="#secret-key" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>A secret key for this particular Django installation. Used to provide a seed in secret-key hashing algorithms. Set this to a random string -- the longer, the better. <tt class="docutils literal"><span class="pre">django-admin.py</span> <span class="pre">startproject</span></tt> creates one automatically.</p> </div> <div class="section" id="s-send-broken-link-emails"> <span id="s-std:setting-SEND_BROKEN_LINK_EMAILS"></span><span id="send-broken-link-emails"></span><span id="std:setting-SEND_BROKEN_LINK_EMAILS"></span><h3>SEND_BROKEN_LINK_EMAILS<a class="headerlink" href="#send-broken-link-emails" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to send an e-mail to the <a class="reference internal" href="#std:setting-MANAGERS"><tt class="xref std std-setting docutils literal"><span class="pre">MANAGERS</span></tt></a> each time somebody visits a Django-powered page that is 404ed with a non-empty referer (i.e., a broken link). This is only used if <tt class="docutils literal"><span class="pre">CommonMiddleware</span></tt> is installed (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>. See also <a class="reference internal" href="#std:setting-IGNORABLE_404_STARTS"><tt class="xref std std-setting docutils literal"><span class="pre">IGNORABLE_404_STARTS</span></tt></a>, <a class="reference internal" href="#std:setting-IGNORABLE_404_ENDS"><tt class="xref std std-setting docutils literal"><span class="pre">IGNORABLE_404_ENDS</span></tt></a> and <a class="reference internal" href="../howto/error-reporting.html"><em>Error reporting via e-mail</em></a>.</p> </div> <div class="section" id="s-serialization-modules"> <span id="s-std:setting-SERIALIZATION_MODULES"></span><span id="serialization-modules"></span><span id="std:setting-SERIALIZATION_MODULES"></span><h3>SERIALIZATION_MODULES<a class="headerlink" href="#serialization-modules" title="Permalink to this headline">¶</a></h3> <p>Default: Not defined.</p> <p>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:</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">SERIALIZATION_MODULES</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'yaml'</span> <span class="p">:</span> <span class="s">'path.to.yaml_serializer'</span> <span class="p">}</span> </pre></div> </div> </div> <div class="section" id="s-server-email"> <span id="s-std:setting-SERVER_EMAIL"></span><span id="server-email"></span><span id="std:setting-SERVER_EMAIL"></span><h3>SERVER_EMAIL<a class="headerlink" href="#server-email" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'root@localhost'</span></tt></p> <p>The e-mail address that error messages come from, such as those sent to <a class="reference internal" href="#std:setting-ADMINS"><tt class="xref std std-setting docutils literal"><span class="pre">ADMINS</span></tt></a> and <a class="reference internal" href="#std:setting-MANAGERS"><tt class="xref std std-setting docutils literal"><span class="pre">MANAGERS</span></tt></a>.</p> </div> <div class="section" id="s-session-cookie-age"> <span id="s-std:setting-SESSION_COOKIE_AGE"></span><span id="session-cookie-age"></span><span id="std:setting-SESSION_COOKIE_AGE"></span><h3>SESSION_COOKIE_AGE<a class="headerlink" href="#session-cookie-age" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">1209600</span></tt> (2 weeks, in seconds)</p> <p>The age of session cookies, in seconds. See <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-cookie-domain"> <span id="s-std:setting-SESSION_COOKIE_DOMAIN"></span><span id="session-cookie-domain"></span><span id="std:setting-SESSION_COOKIE_DOMAIN"></span><h3>SESSION_COOKIE_DOMAIN<a class="headerlink" href="#session-cookie-domain" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>The domain to use for session cookies. Set this to a string such as <tt class="docutils literal"><span class="pre">".lawrence.com"</span></tt> for cross-domain cookies, or use <tt class="xref docutils literal"><span class="pre">None</span></tt> for a standard domain cookie. See the <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-cookie-httponly"> <span id="s-std:setting-SESSION_COOKIE_HTTPONLY"></span><span id="session-cookie-httponly"></span><span id="std:setting-SESSION_COOKIE_HTTPONLY"></span><h3>SESSION_COOKIE_HTTPONLY<a class="headerlink" href="#session-cookie-httponly" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to use HTTPOnly flag on the session cookie. If this is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, client-side JavaScript will not to be able to access the session cookie.</p> <p><a class="reference external" href="http://www.owasp.org/index.php/HTTPOnly">HTTPOnly</a> is a flag included in a Set-Cookie HTTP response header. It is not part of the RFC2109 standard for cookies, and it isn't honored consistently by all browsers. However, when it is honored, it can be a useful way to mitigate the risk of client side script accessing the protected cookie data.</p> </div> <div class="section" id="s-session-cookie-name"> <span id="s-std:setting-SESSION_COOKIE_NAME"></span><span id="session-cookie-name"></span><span id="std:setting-SESSION_COOKIE_NAME"></span><h3>SESSION_COOKIE_NAME<a class="headerlink" href="#session-cookie-name" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'sessionid'</span></tt></p> <p>The name of the cookie to use for sessions. This can be whatever you want (but should be different from <a class="reference internal" href="#std:setting-LANGUAGE_COOKIE_NAME"><tt class="xref std std-setting docutils literal"><span class="pre">LANGUAGE_COOKIE_NAME</span></tt></a>). See the <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-cookie-path"> <span id="s-std:setting-SESSION_COOKIE_PATH"></span><span id="session-cookie-path"></span><span id="std:setting-SESSION_COOKIE_PATH"></span><h3>SESSION_COOKIE_PATH<a class="headerlink" href="#session-cookie-path" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'/'</span></tt></p> <p>The path set on the session cookie. This should either match the URL path of your Django installation or be parent of that path.</p> <p>This is useful if you have multiple Django instances running under the same hostname. They can use different cookie paths, and each instance will only see its own session cookie.</p> </div> <div class="section" id="s-session-cookie-secure"> <span id="s-std:setting-SESSION_COOKIE_SECURE"></span><span id="session-cookie-secure"></span><span id="std:setting-SESSION_COOKIE_SECURE"></span><h3>SESSION_COOKIE_SECURE<a class="headerlink" href="#session-cookie-secure" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to use a secure cookie for the session cookie. If this is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, the cookie will be marked as "secure," which means browsers may ensure that the cookie is only sent under an HTTPS connection. See the <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-engine"> <span id="s-std:setting-SESSION_ENGINE"></span><span id="session-engine"></span><span id="std:setting-SESSION_ENGINE"></span><h3>SESSION_ENGINE<a class="headerlink" href="#session-engine" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">django.contrib.sessions.backends.db</span></tt></p> <p>Controls where Django stores session data. Valid values are:</p> <ul class="simple"> <li><tt class="docutils literal"><span class="pre">'django.contrib.sessions.backends.db'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.contrib.sessions.backends.file'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.contrib.sessions.backends.cache'</span></tt></li> <li><tt class="docutils literal"><span class="pre">'django.contrib.sessions.backends.cached_db'</span></tt></li> </ul> <p>See <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-expire-at-browser-close"> <span id="s-std:setting-SESSION_EXPIRE_AT_BROWSER_CLOSE"></span><span id="session-expire-at-browser-close"></span><span id="std:setting-SESSION_EXPIRE_AT_BROWSER_CLOSE"></span><h3>SESSION_EXPIRE_AT_BROWSER_CLOSE<a class="headerlink" href="#session-expire-at-browser-close" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to expire the session when the user closes his or her browser. See the <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-session-file-path"> <span id="s-std:setting-SESSION_FILE_PATH"></span><span id="session-file-path"></span><span id="std:setting-SESSION_FILE_PATH"></span><h3>SESSION_FILE_PATH<a class="headerlink" href="#session-file-path" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>If you're using file-based session storage, this sets the directory in which Django will store session data. See <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>. When the default value (<tt class="xref docutils literal"><span class="pre">None</span></tt>) is used, Django will use the standard temporary directory for the system.</p> </div> <div class="section" id="s-session-save-every-request"> <span id="s-std:setting-SESSION_SAVE_EVERY_REQUEST"></span><span id="session-save-every-request"></span><span id="std:setting-SESSION_SAVE_EVERY_REQUEST"></span><h3>SESSION_SAVE_EVERY_REQUEST<a class="headerlink" href="#session-save-every-request" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>Whether to save the session data on every request. See <a class="reference internal" href="../topics/http/sessions.html"><em>How to use sessions</em></a>.</p> </div> <div class="section" id="s-short-date-format"> <span id="s-std:setting-SHORT_DATE_FORMAT"></span><span id="short-date-format"></span><span id="std:setting-SHORT_DATE_FORMAT"></span><h3>SHORT_DATE_FORMAT<a class="headerlink" href="#short-date-format" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">m/d/Y</span></tt> (e.g. <tt class="docutils literal"><span class="pre">12/31/2003</span></tt>)</p> <p>An available formatting that can be used for displaying date fields on templates. Note that if <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, then the corresponding locale-dictated format has higher precedence and will be applied. See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>.</p> <p>See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-SHORT_DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATETIME_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-short-datetime-format"> <span id="s-std:setting-SHORT_DATETIME_FORMAT"></span><span id="short-datetime-format"></span><span id="std:setting-SHORT_DATETIME_FORMAT"></span><h3>SHORT_DATETIME_FORMAT<a class="headerlink" href="#short-datetime-format" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">m/d/Y</span> <span class="pre">P</span></tt> (e.g. <tt class="docutils literal"><span class="pre">12/31/2003</span> <span class="pre">4</span> <span class="pre">p.m.</span></tt>)</p> <p>An available formatting that can be used for displaying datetime fields on templates. Note that if <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, then the corresponding locale-dictated format has higher precedence and will be applied. See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>.</p> <p>See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-SHORT_DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">SHORT_DATETIME_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-site-id"> <span id="s-std:setting-SITE_ID"></span><span id="site-id"></span><span id="std:setting-SITE_ID"></span><h3>SITE_ID<a class="headerlink" href="#site-id" title="Permalink to this headline">¶</a></h3> <p>Default: Not defined</p> <p>The ID, as an integer, of the current site in the <tt class="docutils literal"><span class="pre">django_site</span></tt> database table. This is used so that application data can hook into specific site(s) and a single database can manage content for multiple sites.</p> <p>See <a class="reference internal" href="contrib/sites.html"><em>The "sites" framework</em></a>.</p> </div> <div class="section" id="s-static-root"> <span id="s-std:setting-STATIC_ROOT"></span><span id="static-root"></span><span id="std:setting-STATIC_ROOT"></span><h3>STATIC_ROOT<a class="headerlink" href="#static-root" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>The absolute path to the directory where <a class="reference internal" href="contrib/staticfiles.html#django-admin-collectstatic"><tt class="xref std std-djadmin docutils literal"><span class="pre">collectstatic</span></tt></a> will collect static files for deployment.</p> <p>Example: <tt class="docutils literal"><span class="pre">"/home/example.com/static/"</span></tt></p> <p>If the <a class="reference internal" href="contrib/staticfiles.html"><em>staticfiles</em></a> contrib app is enabled (default) the <a class="reference internal" href="contrib/staticfiles.html#django-admin-collectstatic"><tt class="xref std std-djadmin docutils literal"><span class="pre">collectstatic</span></tt></a> management command will collect static files into this directory. See the howto on <a class="reference internal" href="../howto/static-files.html"><em>managing static files</em></a> for more details about usage.</p> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p class="last">This should be an (initially empty) destination directory for collecting your static files from their permanent locations into one directory for ease of deployment; it is <strong>not</strong> a place to store your static files permanently. You should do that in directories that will be found by <a class="reference internal" href="contrib/staticfiles.html"><em>staticfiles</em></a>'s <a class="reference internal" href="contrib/staticfiles.html#std:setting-STATICFILES_FINDERS"><tt class="xref std std-setting docutils literal"><span class="pre">finders</span></tt></a>, which by default, are <tt class="docutils literal"><span class="pre">'static/'</span></tt> app sub-directories and any directories you include in <a class="reference internal" href="contrib/staticfiles.html#std:setting-STATICFILES_DIRS"><tt class="xref std std-setting docutils literal"><span class="pre">STATICFILES_DIRS</span></tt></a>).</p> </div> <p>See <a class="reference internal" href="contrib/staticfiles.html"><em>staticfiles reference</em></a> and <a class="reference internal" href="#std:setting-STATIC_URL"><tt class="xref std std-setting docutils literal"><span class="pre">STATIC_URL</span></tt></a>.</p> </div> <div class="section" id="s-static-url"> <span id="s-std:setting-STATIC_URL"></span><span id="static-url"></span><span id="std:setting-STATIC_URL"></span><h3>STATIC_URL<a class="headerlink" href="#static-url" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">None</span></tt></p> <p>URL to use when referring to static files located in <a class="reference internal" href="#std:setting-STATIC_ROOT"><tt class="xref std std-setting docutils literal"><span class="pre">STATIC_ROOT</span></tt></a>.</p> <p>Example: <tt class="docutils literal"><span class="pre">"/site_media/static/"</span></tt> or <tt class="docutils literal"><span class="pre">"http://static.example.com/"</span></tt></p> <p>If not <tt class="xref docutils literal"><span class="pre">None</span></tt>, this will be used as the base path for <a class="reference internal" href="../topics/forms/media.html#form-media-paths"><em>media definitions</em></a> and the <a class="reference internal" href="contrib/staticfiles.html"><em>staticfiles app</em></a>.</p> <p>It must end in a slash if set to a non-empty value.</p> <p>See <a class="reference internal" href="#std:setting-STATIC_ROOT"><tt class="xref std std-setting docutils literal"><span class="pre">STATIC_ROOT</span></tt></a>.</p> </div> <div class="section" id="s-template-context-processors"> <span id="s-std:setting-TEMPLATE_CONTEXT_PROCESSORS"></span><span id="template-context-processors"></span><span id="std:setting-TEMPLATE_CONTEXT_PROCESSORS"></span><h3>TEMPLATE_CONTEXT_PROCESSORS<a class="headerlink" href="#template-context-processors" title="Permalink to this headline">¶</a></h3> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">"django.contrib.auth.context_processors.auth"</span><span class="p">,</span> <span class="s">"django.core.context_processors.debug"</span><span class="p">,</span> <span class="s">"django.core.context_processors.i18n"</span><span class="p">,</span> <span class="s">"django.core.context_processors.media"</span><span class="p">,</span> <span class="s">"django.core.context_processors.static"</span><span class="p">,</span> <span class="s">"django.contrib.messages.context_processors.messages"</span><span class="p">)</span> </pre></div> </div> <p>A tuple of callables that are used to populate the context in <tt class="docutils literal"><span class="pre">RequestContext</span></tt>. These callables take a request object as their argument and return a dictionary of items to be merged into the context.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> <tt class="docutils literal"><span class="pre">django.contrib.messages.context_processors.messages</span></tt> was added to the default. For more information, see the <a class="reference internal" href="contrib/messages.html"><em>messages documentation</em></a>.</div> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> The auth context processor was moved in this release from its old location <tt class="docutils literal"><span class="pre">django.core.context_processors.auth</span></tt> to <tt class="docutils literal"><span class="pre">django.contrib.auth.context_processors.auth</span></tt>.</div> <div class="versionadded"> <span class="title">New in Django 1.3:</span> The <tt class="docutils literal"><span class="pre">django.core.context_processors.static</span></tt> context processor was added in this release.</div> </div> <div class="section" id="s-template-debug"> <span id="s-std:setting-TEMPLATE_DEBUG"></span><span id="template-debug"></span><span id="std:setting-TEMPLATE_DEBUG"></span><h3>TEMPLATE_DEBUG<a class="headerlink" href="#template-debug" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that turns on/off template debug mode. If this is <tt class="xref docutils literal"><span class="pre">True</span></tt>, the fancy error page will display a detailed report for any <tt class="docutils literal"><span class="pre">TemplateSyntaxError</span></tt>. This report contains the relevant snippet of the template, with the appropriate line highlighted.</p> <p>Note that Django only displays fancy error pages if <a class="reference internal" href="#std:setting-DEBUG"><tt class="xref std std-setting docutils literal"><span class="pre">DEBUG</span></tt></a> is <tt class="xref docutils literal"><span class="pre">True</span></tt>, so you'll want to set that to take advantage of this setting.</p> <p>See also <a class="reference internal" href="#std:setting-DEBUG"><tt class="xref std std-setting docutils literal"><span class="pre">DEBUG</span></tt></a>.</p> </div> <div class="section" id="s-template-dirs"> <span id="s-std:setting-TEMPLATE_DIRS"></span><span id="template-dirs"></span><span id="std:setting-TEMPLATE_DIRS"></span><h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">()</span></tt> (Empty tuple)</p> <p>List of locations of the template source files, in search order. Note that these paths should use Unix-style forward slashes, even on Windows.</p> <p>See <a class="reference internal" href="../topics/templates.html"><em>The Django template language</em></a>.</p> </div> <div class="section" id="s-template-loaders"> <span id="s-std:setting-TEMPLATE_LOADERS"></span><span id="template-loaders"></span><span id="std:setting-TEMPLATE_LOADERS"></span><h3>TEMPLATE_LOADERS<a class="headerlink" href="#template-loaders" title="Permalink to this headline">¶</a></h3> <p>Default:</p> <div class="highlight-python"><div class="highlight"><pre><span class="p">(</span><span class="s">'django.template.loaders.filesystem.Loader'</span><span class="p">,</span> <span class="s">'django.template.loaders.app_directories.Loader'</span><span class="p">)</span> </pre></div> </div> <p>A tuple of template loader classes, specified as strings. Each <tt class="docutils literal"><span class="pre">Loader</span></tt> class knows how to import templates from a particular source. Optionally, a tuple can be used instead of a string. The first item in the tuple should be the <tt class="docutils literal"><span class="pre">Loader</span></tt>'s module, subsequent items are passed to the <tt class="docutils literal"><span class="pre">Loader</span></tt> during initialization. See <a class="reference internal" href="templates/api.html"><em>The Django template language: For Python programmers</em></a>.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> The class-based API for template loaders was introduced in Django 1.2 although the <a class="reference internal" href="#std:setting-TEMPLATE_LOADERS"><tt class="xref std std-setting docutils literal"><span class="pre">TEMPLATE_LOADERS</span></tt></a> setting will accept strings that specify function-based loaders until compatibility with them is completely removed in Django 1.4.</div> </div> <div class="section" id="s-template-string-if-invalid"> <span id="s-std:setting-TEMPLATE_STRING_IF_INVALID"></span><span id="template-string-if-invalid"></span><span id="std:setting-TEMPLATE_STRING_IF_INVALID"></span><h3>TEMPLATE_STRING_IF_INVALID<a class="headerlink" href="#template-string-if-invalid" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">''</span></tt> (Empty string)</p> <p>Output, as a string, that the template system should use for invalid (e.g. misspelled) variables. See <a class="reference internal" href="templates/api.html#invalid-template-variables"><em>How invalid variables are handled</em></a>..</p> </div> <div class="section" id="s-test-runner"> <span id="s-std:setting-TEST_RUNNER"></span><span id="test-runner"></span><span id="std:setting-TEST_RUNNER"></span><h3>TEST_RUNNER<a class="headerlink" href="#test-runner" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'django.test.simple.DjangoTestSuiteRunner'</span></tt></p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> Prior to 1.2, test runners were a function, not a class.</div> <p>The name of the class to use for starting the test suite. See <a class="reference internal" href="../topics/testing.html"><em>Testing Django applications</em></a>.</p> </div> <div class="section" id="s-thousand-separator"> <span id="s-std:setting-THOUSAND_SEPARATOR"></span><span id="thousand-separator"></span><span id="std:setting-THOUSAND_SEPARATOR"></span><h3>THOUSAND_SEPARATOR<a class="headerlink" href="#thousand-separator" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">,</span></tt> (Comma)</p> <p>Default thousand separator used when formatting numbers. This setting is used only when <a class="reference internal" href="#std:setting-NUMBER_GROUPING"><tt class="xref std std-setting docutils literal"><span class="pre">NUMBER_GROUPING</span></tt></a> and <a class="reference internal" href="#std:setting-USE_THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">USE_THOUSAND_SEPARATOR</span></tt></a> are set.</p> <p>See also <a class="reference internal" href="#std:setting-NUMBER_GROUPING"><tt class="xref std std-setting docutils literal"><span class="pre">NUMBER_GROUPING</span></tt></a>, <a class="reference internal" href="#std:setting-DECIMAL_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">DECIMAL_SEPARATOR</span></tt></a> and <a class="reference internal" href="#std:setting-USE_THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">USE_THOUSAND_SEPARATOR</span></tt></a>.</p> </div> <div class="section" id="s-time-format"> <span id="s-std:setting-TIME_FORMAT"></span><span id="time-format"></span><span id="std:setting-TIME_FORMAT"></span><h3>TIME_FORMAT<a class="headerlink" href="#time-format" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'P'</span></tt> (e.g. <tt class="docutils literal"><span class="pre">4</span> <span class="pre">p.m.</span></tt>)</p> <p>The default formatting to use for displaying time fields in any part of the system. Note that if <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, then the locale-dictated format has higher precedence and will be applied instead. See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>.</p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> This setting can now be overriden by setting <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> to <tt class="xref docutils literal"><span class="pre">True</span></tt>.</div> <p>See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_FORMAT</span></tt></a>.</p> </div> <div class="section" id="s-time-input-formats"> <span id="s-std:setting-TIME_INPUT_FORMATS"></span><span id="time-input-formats"></span><span id="std:setting-TIME_INPUT_FORMATS"></span><h3>TIME_INPUT_FORMATS<a class="headerlink" href="#time-input-formats" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="docutils literal"><span class="pre">('%H:%M:%S',</span> <span class="pre">'%H:%M')</span></tt></p> <p>A tuple of formats that will be accepted when inputting data on a time field. Formats will be tried in order, using the first valid. Note that these format strings are specified in Python's <a class="reference external" href="http://docs.python.org/library/datetime.html#strftime-strptime-behavior">datetime</a> module syntax, that is different from the one used by Django for formatting dates to be displayed.</p> <p>See also <a class="reference internal" href="#std:setting-DATE_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_INPUT_FORMATS</span></tt></a> and <a class="reference internal" href="#std:setting-DATETIME_INPUT_FORMATS"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_INPUT_FORMATS</span></tt></a>.</p> </div> <div class="section" id="s-time-zone"> <span id="s-std:setting-TIME_ZONE"></span><span id="time-zone"></span><span id="std:setting-TIME_ZONE"></span><h3>TIME_ZONE<a class="headerlink" href="#time-zone" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'America/Chicago'</span></tt></p> <div class="versionchanged"> <span class="title">Changed in Django 1.2:</span> <tt class="xref docutils literal"><span class="pre">None</span></tt> was added as an allowed value.</div> <p>A string representing the time zone for this installation, or <tt class="xref docutils literal"><span class="pre">None</span></tt>. <a class="reference external" href="http://www.postgresql.org/docs/8.1/static/datetime-keywords.html#DATETIME-TIMEZONE-SET-TABLE">See available choices</a>. (Note that list of available choices lists more than one on the same line; you'll want to use just one of the choices for a given time zone. For instance, one line says <tt class="docutils literal"><span class="pre">'Europe/London</span> <span class="pre">GB</span> <span class="pre">GB-Eire'</span></tt>, but you should use the first bit of that -- <tt class="docutils literal"><span class="pre">'Europe/London'</span></tt> -- as your <a class="reference internal" href="#std:setting-TIME_ZONE"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_ZONE</span></tt></a> setting.)</p> <p>Note that this is the time zone to which Django will convert all dates/times -- not necessarily the timezone of the server. For example, one server may serve multiple Django-powered sites, each with a separate time-zone setting.</p> <p>Normally, Django sets the <tt class="docutils literal"><span class="pre">os.environ['TZ']</span></tt> variable to the time zone you specify in the <a class="reference internal" href="#std:setting-TIME_ZONE"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_ZONE</span></tt></a> setting. Thus, all your views and models will automatically operate in the correct time zone. However, Django won't set the <tt class="docutils literal"><span class="pre">TZ</span></tt> environment variable under the following conditions:</p> <ul class="simple"> <li>If you're using the manual configuration option as described in <a class="reference internal" href="../topics/settings.html#settings-without-django-settings-module"><em>manually configuring settings</em></a>, or</li> <li>If you specify <tt class="docutils literal"><span class="pre">TIME_ZONE</span> <span class="pre">=</span> <span class="pre">None</span></tt>. This will cause Django to fall back to using the system timezone.</li> </ul> <p>If Django doesn't set the <tt class="docutils literal"><span class="pre">TZ</span></tt> environment variable, it's up to you to ensure your processes are running in the correct environment.</p> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">Django cannot reliably use alternate time zones in a Windows environment. If you're running Django on Windows, this variable must be set to match the system timezone.</p> </div> </div> <div class="section" id="s-use-etags"> <span id="s-std:setting-USE_ETAGS"></span><span id="use-etags"></span><span id="std:setting-USE_ETAGS"></span><h3>USE_ETAGS<a class="headerlink" href="#use-etags" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that specifies whether to output the "Etag" header. This saves bandwidth but slows down performance. This is used by the <tt class="docutils literal"><span class="pre">CommonMiddleware</span></tt> (see <a class="reference internal" href="../topics/http/middleware.html"><em>Middleware</em></a>) and in the``Cache Framework`` (see <a class="reference internal" href="../topics/cache.html"><em>Django's cache framework</em></a>).</p> </div> <div class="section" id="s-use-i18n"> <span id="s-std:setting-USE_I18N"></span><span id="use-i18n"></span><span id="std:setting-USE_I18N"></span><h3>USE_I18N<a class="headerlink" href="#use-i18n" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="xref docutils literal"><span class="pre">True</span></tt></p> <p>A boolean that specifies whether Django's internationalization system should be enabled. This provides an easy way to turn it off, for performance. If this is set to <tt class="xref docutils literal"><span class="pre">False</span></tt>, Django will make some optimizations so as not to load the internationalization machinery.</p> <p>See also <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a></p> </div> <div class="section" id="s-use-l10n"> <span id="s-std:setting-USE_L10N"></span><span id="use-l10n"></span><span id="std:setting-USE_L10N"></span><h3>USE_L10N<a class="headerlink" href="#use-l10n" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that specifies if data will be localized by default or not. If this is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, e.g. Django will display numbers and dates using the format of the current locale.</p> <p>See also <a class="reference internal" href="#std:setting-USE_I18N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_I18N</span></tt></a> and <a class="reference internal" href="#std:setting-LANGUAGE_CODE"><tt class="xref std std-setting docutils literal"><span class="pre">LANGUAGE_CODE</span></tt></a></p> </div> <div class="section" id="s-use-thousand-separator"> <span id="s-std:setting-USE_THOUSAND_SEPARATOR"></span><span id="use-thousand-separator"></span><span id="std:setting-USE_THOUSAND_SEPARATOR"></span><h3>USE_THOUSAND_SEPARATOR<a class="headerlink" href="#use-thousand-separator" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.2:</span> <a class="reference internal" href="../releases/1.2.html"><em>Please, see the release notes</em></a></div> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that specifies wheter to display numbers using a thousand separator. If this is set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, Django will use values from <a class="reference internal" href="#std:setting-THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">THOUSAND_SEPARATOR</span></tt></a> and <a class="reference internal" href="#std:setting-NUMBER_GROUPING"><tt class="xref std std-setting docutils literal"><span class="pre">NUMBER_GROUPING</span></tt></a> from current locale, to format the number. <a class="reference internal" href="#std:setting-USE_L10N"><tt class="xref std std-setting docutils literal"><span class="pre">USE_L10N</span></tt></a> must be set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, in order to format numbers.</p> <p>See also <a class="reference internal" href="#std:setting-THOUSAND_SEPARATOR"><tt class="xref std std-setting docutils literal"><span class="pre">THOUSAND_SEPARATOR</span></tt></a> and <a class="reference internal" href="#std:setting-NUMBER_GROUPING"><tt class="xref std std-setting docutils literal"><span class="pre">NUMBER_GROUPING</span></tt></a>.</p> </div> <div class="section" id="s-use-x-forwarded-host"> <span id="s-std:setting-USE_X_FORWARDED_HOST"></span><span id="use-x-forwarded-host"></span><span id="std:setting-USE_X_FORWARDED_HOST"></span><h3>USE_X_FORWARDED_HOST<a class="headerlink" href="#use-x-forwarded-host" title="Permalink to this headline">¶</a></h3> <div class="versionadded"> <span class="title">New in Django 1.3.1:</span> <tt class="xref doc docutils literal"><span class="pre">Please,</span> <span class="pre">see</span> <span class="pre">the</span> <span class="pre">release</span> <span class="pre">notes</span></tt></div> <p>Default: <tt class="xref docutils literal"><span class="pre">False</span></tt></p> <p>A boolean that specifies whether to use the X-Forwarded-Host header in preference to the Host header. This should only be enabled if a proxy which sets this header is in use.</p> </div> <div class="section" id="s-year-month-format"> <span id="s-std:setting-YEAR_MONTH_FORMAT"></span><span id="year-month-format"></span><span id="std:setting-YEAR_MONTH_FORMAT"></span><h3>YEAR_MONTH_FORMAT<a class="headerlink" href="#year-month-format" title="Permalink to this headline">¶</a></h3> <p>Default: <tt class="docutils literal"><span class="pre">'F</span> <span class="pre">Y'</span></tt></p> <p>The default formatting to use for date fields on Django admin change-list pages -- and, possibly, by other parts of the system -- in cases when only the year and month are displayed.</p> <p>For example, when a Django admin change-list page is being filtered by a date drilldown, the header for a given month displays the month and the year. Different locales have different formats. For example, U.S. English would say "January 2006," whereas another locale might say "2006/January."</p> <p>See <a class="reference internal" href="templates/builtins.html#std:templatefilter-date"><tt class="xref std std-tfilter docutils literal"><span class="pre">allowed</span> <span class="pre">date</span> <span class="pre">format</span> <span class="pre">strings</span></tt></a>. See also <a class="reference internal" href="#std:setting-DATE_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATE_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-DATETIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">DATETIME_FORMAT</span></tt></a>, <a class="reference internal" href="#std:setting-TIME_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">TIME_FORMAT</span></tt></a> and <a class="reference internal" href="#std:setting-MONTH_DAY_FORMAT"><tt class="xref std std-setting docutils literal"><span class="pre">MONTH_DAY_FORMAT</span></tt></a>.</p> </div> </div> <div class="section" id="s-deprecated-settings"> <span id="deprecated-settings"></span><h2><a class="toc-backref" href="#id5">Deprecated settings</a><a class="headerlink" href="#deprecated-settings" title="Permalink to this headline">¶</a></h2> <div class="section" id="s-cache-backend"> <span id="s-std:setting-CACHE_BACKEND"></span><span id="cache-backend"></span><span id="std:setting-CACHE_BACKEND"></span><h3>CACHE_BACKEND<a class="headerlink" href="#cache-backend" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.3:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-CACHES-BACKEND"><tt class="xref std std-setting docutils literal"><span class="pre">BACKEND</span></tt></a> in <a class="reference internal" href="#std:setting-CACHES"><tt class="xref std std-setting docutils literal"><span class="pre">CACHES</span></tt></a>.</div> </div> <div class="section" id="s-database-engine"> <span id="s-std:setting-DATABASE_ENGINE"></span><span id="database-engine"></span><span id="std:setting-DATABASE_ENGINE"></span><h3>DATABASE_ENGINE<a class="headerlink" href="#database-engine" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <tt class="xref std std-setting docutils literal"><span class="pre">ENGINE</span></tt> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-host"> <span id="s-std:setting-DATABASE_HOST"></span><span id="database-host"></span><span id="std:setting-DATABASE_HOST"></span><h3>DATABASE_HOST<a class="headerlink" href="#database-host" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-HOST"><tt class="xref std std-setting docutils literal"><span class="pre">HOST</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-name"> <span id="s-std:setting-DATABASE_NAME"></span><span id="database-name"></span><span id="std:setting-DATABASE_NAME"></span><h3>DATABASE_NAME<a class="headerlink" href="#database-name" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-NAME"><tt class="xref std std-setting docutils literal"><span class="pre">NAME</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-options"> <span id="s-std:setting-DATABASE_OPTIONS"></span><span id="database-options"></span><span id="std:setting-DATABASE_OPTIONS"></span><h3>DATABASE_OPTIONS<a class="headerlink" href="#database-options" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-OPTIONS"><tt class="xref std std-setting docutils literal"><span class="pre">OPTIONS</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-password"> <span id="s-std:setting-DATABASE_PASSWORD"></span><span id="database-password"></span><span id="std:setting-DATABASE_PASSWORD"></span><h3>DATABASE_PASSWORD<a class="headerlink" href="#database-password" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-PASSWORD"><tt class="xref std std-setting docutils literal"><span class="pre">PASSWORD</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-port"> <span id="s-std:setting-DATABASE_PORT"></span><span id="database-port"></span><span id="std:setting-DATABASE_PORT"></span><h3>DATABASE_PORT<a class="headerlink" href="#database-port" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-PORT"><tt class="xref std std-setting docutils literal"><span class="pre">PORT</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-database-user"> <span id="s-std:setting-DATABASE_USER"></span><span id="database-user"></span><span id="std:setting-DATABASE_USER"></span><h3>DATABASE_USER<a class="headerlink" href="#database-user" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-USER"><tt class="xref std std-setting docutils literal"><span class="pre">USER</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-test-database-charset"> <span id="s-std:setting-TEST_DATABASE_CHARSET"></span><span id="test-database-charset"></span><span id="std:setting-TEST_DATABASE_CHARSET"></span><h3>TEST_DATABASE_CHARSET<a class="headerlink" href="#test-database-charset" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-TEST_CHARSET"><tt class="xref std std-setting docutils literal"><span class="pre">TEST_CHARSET</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-test-database-collation"> <span id="s-std:setting-TEST_DATABASE_COLLATION"></span><span id="test-database-collation"></span><span id="std:setting-TEST_DATABASE_COLLATION"></span><h3>TEST_DATABASE_COLLATION<a class="headerlink" href="#test-database-collation" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-TEST_COLLATION"><tt class="xref std std-setting docutils literal"><span class="pre">TEST_COLLATION</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-test-database-name"> <span id="s-std:setting-TEST_DATABASE_NAME"></span><span id="test-database-name"></span><span id="std:setting-TEST_DATABASE_NAME"></span><h3>TEST_DATABASE_NAME<a class="headerlink" href="#test-database-name" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.2:</span> This setting has been replaced by <a class="reference internal" href="#std:setting-TEST_NAME"><tt class="xref std std-setting docutils literal"><span class="pre">TEST_NAME</span></tt></a> in <a class="reference internal" href="#std:setting-DATABASES"><tt class="xref std std-setting docutils literal"><span class="pre">DATABASES</span></tt></a>.</div> </div> <div class="section" id="s-url-validator-user-agent"> <span id="url-validator-user-agent"></span><h3>URL_VALIDATOR_USER_AGENT<a class="headerlink" href="#url-validator-user-agent" title="Permalink to this headline">¶</a></h3> <div class="deprecated"> <span class="title">Deprecated in Django 1.3.1:</span> This setting has been removed due to intractable performance and security problems.</div> <p>Default: <tt class="docutils literal"><span class="pre">Django/<version></span> <span class="pre">(http://www.djangoproject.com/)</span></tt></p> <p>The string to use as the <tt class="docutils literal"><span class="pre">User-Agent</span></tt> header when checking to see if URLs exist (see the <tt class="docutils literal"><span class="pre">verify_exists</span></tt> option on <a class="reference internal" href="models/fields.html#django.db.models.URLField" title="django.db.models.URLField"><tt class="xref py py-class docutils literal"><span class="pre">URLField</span></tt></a>). This setting was deprecated in 1.3.1 along with <tt class="docutils literal"><span class="pre">verify_exists</span></tt> and will be removed in 1.4.</p> </div> </div> </div> </div> </div> </div> <div class="yui-b" id="sidebar"> <div class="sphinxsidebar"> <div class="sphinxsidebarwrapper"> <h3><a href="../contents.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">Settings</a><ul> <li><a class="reference internal" href="#available-settings">Available settings</a><ul> <li><a class="reference internal" href="#absolute-url-overrides">ABSOLUTE_URL_OVERRIDES</a></li> <li><a class="reference internal" href="#admin-for">ADMIN_FOR</a></li> <li><a class="reference internal" href="#admin-media-prefix">ADMIN_MEDIA_PREFIX</a></li> <li><a class="reference internal" href="#admins">ADMINS</a></li> <li><a class="reference internal" href="#allowed-include-roots">ALLOWED_INCLUDE_ROOTS</a></li> <li><a class="reference internal" href="#append-slash">APPEND_SLASH</a></li> <li><a class="reference internal" href="#authentication-backends">AUTHENTICATION_BACKENDS</a></li> <li><a class="reference internal" href="#auth-profile-module">AUTH_PROFILE_MODULE</a></li> <li><a class="reference internal" href="#caches">CACHES</a><ul> <li><a class="reference internal" href="#backend">BACKEND</a></li> <li><a class="reference internal" href="#key-function">KEY_FUNCTION</a></li> <li><a class="reference internal" href="#key-prefix">KEY_PREFIX</a></li> <li><a class="reference internal" href="#location">LOCATION</a></li> <li><a class="reference internal" href="#options">OPTIONS</a></li> <li><a class="reference internal" href="#timeout">TIMEOUT</a></li> <li><a class="reference internal" href="#version">VERSION</a></li> </ul> </li> <li><a class="reference internal" href="#cache-middleware-alias">CACHE_MIDDLEWARE_ALIAS</a></li> <li><a class="reference internal" href="#cache-middleware-anonymous-only">CACHE_MIDDLEWARE_ANONYMOUS_ONLY</a></li> <li><a class="reference internal" href="#cache-middleware-key-prefix">CACHE_MIDDLEWARE_KEY_PREFIX</a></li> <li><a class="reference internal" href="#cache-middleware-seconds">CACHE_MIDDLEWARE_SECONDS</a></li> <li><a class="reference internal" href="#csrf-cookie-domain">CSRF_COOKIE_DOMAIN</a></li> <li><a class="reference internal" href="#csrf-cookie-name">CSRF_COOKIE_NAME</a></li> <li><a class="reference internal" href="#csrf-failure-view">CSRF_FAILURE_VIEW</a></li> <li><a class="reference internal" href="#databases">DATABASES</a><ul> <li><a class="reference internal" href="#engine">ENGINE</a></li> <li><a class="reference internal" href="#host">HOST</a></li> <li><a class="reference internal" href="#name">NAME</a></li> <li><a class="reference internal" href="#std:setting-OPTIONS">OPTIONS</a></li> <li><a class="reference internal" href="#password">PASSWORD</a></li> <li><a class="reference internal" href="#port">PORT</a></li> <li><a class="reference internal" href="#user">USER</a></li> <li><a class="reference internal" href="#test-charset">TEST_CHARSET</a></li> <li><a class="reference internal" href="#test-collation">TEST_COLLATION</a></li> <li><a class="reference internal" href="#test-dependencies">TEST_DEPENDENCIES</a></li> <li><a class="reference internal" href="#test-mirror">TEST_MIRROR</a></li> <li><a class="reference internal" href="#test-name">TEST_NAME</a></li> <li><a class="reference internal" href="#test-user">TEST_USER</a></li> </ul> </li> <li><a class="reference internal" href="#database-routers">DATABASE_ROUTERS</a></li> <li><a class="reference internal" href="#date-format">DATE_FORMAT</a></li> <li><a class="reference internal" href="#date-input-formats">DATE_INPUT_FORMATS</a></li> <li><a class="reference internal" href="#datetime-format">DATETIME_FORMAT</a></li> <li><a class="reference internal" href="#datetime-input-formats">DATETIME_INPUT_FORMATS</a></li> <li><a class="reference internal" href="#debug">DEBUG</a></li> <li><a class="reference internal" href="#debug-propagate-exceptions">DEBUG_PROPAGATE_EXCEPTIONS</a></li> <li><a class="reference internal" href="#decimal-separator">DECIMAL_SEPARATOR</a></li> <li><a class="reference internal" href="#default-charset">DEFAULT_CHARSET</a></li> <li><a class="reference internal" href="#default-content-type">DEFAULT_CONTENT_TYPE</a></li> <li><a class="reference internal" href="#default-file-storage">DEFAULT_FILE_STORAGE</a></li> <li><a class="reference internal" href="#default-from-email">DEFAULT_FROM_EMAIL</a></li> <li><a class="reference internal" href="#default-index-tablespace">DEFAULT_INDEX_TABLESPACE</a></li> <li><a class="reference internal" href="#default-tablespace">DEFAULT_TABLESPACE</a></li> <li><a class="reference internal" href="#disallowed-user-agents">DISALLOWED_USER_AGENTS</a></li> <li><a class="reference internal" href="#email-backend">EMAIL_BACKEND</a></li> <li><a class="reference internal" href="#email-file-path">EMAIL_FILE_PATH</a></li> <li><a class="reference internal" href="#email-host">EMAIL_HOST</a></li> <li><a class="reference internal" href="#email-host-password">EMAIL_HOST_PASSWORD</a></li> <li><a class="reference internal" href="#email-host-user">EMAIL_HOST_USER</a></li> <li><a class="reference internal" href="#email-port">EMAIL_PORT</a></li> <li><a class="reference internal" href="#email-subject-prefix">EMAIL_SUBJECT_PREFIX</a></li> <li><a class="reference internal" href="#email-use-tls">EMAIL_USE_TLS</a></li> <li><a class="reference internal" href="#file-charset">FILE_CHARSET</a></li> <li><a class="reference internal" href="#file-upload-handlers">FILE_UPLOAD_HANDLERS</a></li> <li><a class="reference internal" href="#file-upload-max-memory-size">FILE_UPLOAD_MAX_MEMORY_SIZE</a></li> <li><a class="reference internal" href="#file-upload-permissions">FILE_UPLOAD_PERMISSIONS</a></li> <li><a class="reference internal" href="#file-upload-temp-dir">FILE_UPLOAD_TEMP_DIR</a></li> <li><a class="reference internal" href="#first-day-of-week">FIRST_DAY_OF_WEEK</a></li> <li><a class="reference internal" href="#fixture-dirs">FIXTURE_DIRS</a></li> <li><a class="reference internal" href="#force-script-name">FORCE_SCRIPT_NAME</a></li> <li><a class="reference internal" href="#format-module-path">FORMAT_MODULE_PATH</a></li> <li><a class="reference internal" href="#ignorable-404-ends">IGNORABLE_404_ENDS</a></li> <li><a class="reference internal" href="#ignorable-404-starts">IGNORABLE_404_STARTS</a></li> <li><a class="reference internal" href="#installed-apps">INSTALLED_APPS</a></li> <li><a class="reference internal" href="#internal-ips">INTERNAL_IPS</a></li> <li><a class="reference internal" href="#language-code">LANGUAGE_CODE</a></li> <li><a class="reference internal" href="#language-cookie-name">LANGUAGE_COOKIE_NAME</a></li> <li><a class="reference internal" href="#languages">LANGUAGES</a></li> <li><a class="reference internal" href="#locale-paths">LOCALE_PATHS</a></li> <li><a class="reference internal" href="#logging">LOGGING</a></li> <li><a class="reference internal" href="#logging-config">LOGGING_CONFIG</a></li> <li><a class="reference internal" href="#login-redirect-url">LOGIN_REDIRECT_URL</a></li> <li><a class="reference internal" href="#login-url">LOGIN_URL</a></li> <li><a class="reference internal" href="#logout-url">LOGOUT_URL</a></li> <li><a class="reference internal" href="#managers">MANAGERS</a></li> <li><a class="reference internal" href="#media-root">MEDIA_ROOT</a></li> <li><a class="reference internal" href="#media-url">MEDIA_URL</a></li> <li><a class="reference internal" href="#message-level">MESSAGE_LEVEL</a></li> <li><a class="reference internal" href="#message-storage">MESSAGE_STORAGE</a></li> <li><a class="reference internal" href="#message-tags">MESSAGE_TAGS</a></li> <li><a class="reference internal" href="#middleware-classes">MIDDLEWARE_CLASSES</a></li> <li><a class="reference internal" href="#month-day-format">MONTH_DAY_FORMAT</a></li> <li><a class="reference internal" href="#number-grouping">NUMBER_GROUPING</a></li> <li><a class="reference internal" href="#password-reset-timeout-days">PASSWORD_RESET_TIMEOUT_DAYS</a></li> <li><a class="reference internal" href="#prepend-www">PREPEND_WWW</a></li> <li><a class="reference internal" href="#profanities-list">PROFANITIES_LIST</a></li> <li><a class="reference internal" href="#restructuredtext-filter-settings">RESTRUCTUREDTEXT_FILTER_SETTINGS</a></li> <li><a class="reference internal" href="#root-urlconf">ROOT_URLCONF</a></li> <li><a class="reference internal" href="#secret-key">SECRET_KEY</a></li> <li><a class="reference internal" href="#send-broken-link-emails">SEND_BROKEN_LINK_EMAILS</a></li> <li><a class="reference internal" href="#serialization-modules">SERIALIZATION_MODULES</a></li> <li><a class="reference internal" href="#server-email">SERVER_EMAIL</a></li> <li><a class="reference internal" href="#session-cookie-age">SESSION_COOKIE_AGE</a></li> <li><a class="reference internal" href="#session-cookie-domain">SESSION_COOKIE_DOMAIN</a></li> <li><a class="reference internal" href="#session-cookie-httponly">SESSION_COOKIE_HTTPONLY</a></li> <li><a class="reference internal" href="#session-cookie-name">SESSION_COOKIE_NAME</a></li> <li><a class="reference internal" href="#session-cookie-path">SESSION_COOKIE_PATH</a></li> <li><a class="reference internal" href="#session-cookie-secure">SESSION_COOKIE_SECURE</a></li> <li><a class="reference internal" href="#session-engine">SESSION_ENGINE</a></li> <li><a class="reference internal" href="#session-expire-at-browser-close">SESSION_EXPIRE_AT_BROWSER_CLOSE</a></li> <li><a class="reference internal" href="#session-file-path">SESSION_FILE_PATH</a></li> <li><a class="reference internal" href="#session-save-every-request">SESSION_SAVE_EVERY_REQUEST</a></li> <li><a class="reference internal" href="#short-date-format">SHORT_DATE_FORMAT</a></li> <li><a class="reference internal" href="#short-datetime-format">SHORT_DATETIME_FORMAT</a></li> <li><a class="reference internal" href="#site-id">SITE_ID</a></li> <li><a class="reference internal" href="#static-root">STATIC_ROOT</a></li> <li><a class="reference internal" href="#static-url">STATIC_URL</a></li> <li><a class="reference internal" href="#template-context-processors">TEMPLATE_CONTEXT_PROCESSORS</a></li> <li><a class="reference internal" href="#template-debug">TEMPLATE_DEBUG</a></li> <li><a class="reference internal" href="#template-dirs">TEMPLATE_DIRS</a></li> <li><a class="reference internal" href="#template-loaders">TEMPLATE_LOADERS</a></li> <li><a class="reference internal" href="#template-string-if-invalid">TEMPLATE_STRING_IF_INVALID</a></li> <li><a class="reference internal" href="#test-runner">TEST_RUNNER</a></li> <li><a class="reference internal" href="#thousand-separator">THOUSAND_SEPARATOR</a></li> <li><a class="reference internal" href="#time-format">TIME_FORMAT</a></li> <li><a class="reference internal" href="#time-input-formats">TIME_INPUT_FORMATS</a></li> <li><a class="reference internal" href="#time-zone">TIME_ZONE</a></li> <li><a class="reference internal" href="#use-etags">USE_ETAGS</a></li> <li><a class="reference internal" href="#use-i18n">USE_I18N</a></li> <li><a class="reference internal" href="#use-l10n">USE_L10N</a></li> <li><a class="reference internal" href="#use-thousand-separator">USE_THOUSAND_SEPARATOR</a></li> <li><a class="reference internal" href="#use-x-forwarded-host">USE_X_FORWARDED_HOST</a></li> <li><a class="reference internal" href="#year-month-format">YEAR_MONTH_FORMAT</a></li> </ul> </li> <li><a class="reference internal" href="#deprecated-settings">Deprecated settings</a><ul> <li><a class="reference internal" href="#cache-backend">CACHE_BACKEND</a></li> <li><a class="reference internal" href="#database-engine">DATABASE_ENGINE</a></li> <li><a class="reference internal" href="#database-host">DATABASE_HOST</a></li> <li><a class="reference internal" href="#database-name">DATABASE_NAME</a></li> <li><a class="reference internal" href="#database-options">DATABASE_OPTIONS</a></li> <li><a class="reference internal" href="#database-password">DATABASE_PASSWORD</a></li> <li><a class="reference internal" href="#database-port">DATABASE_PORT</a></li> <li><a class="reference internal" href="#database-user">DATABASE_USER</a></li> <li><a class="reference internal" href="#test-database-charset">TEST_DATABASE_CHARSET</a></li> <li><a class="reference internal" href="#test-database-collation">TEST_DATABASE_COLLATION</a></li> <li><a class="reference internal" href="#test-database-name">TEST_DATABASE_NAME</a></li> <li><a class="reference internal" href="#url-validator-user-agent">URL_VALIDATOR_USER_AGENT</a></li> </ul> </li> </ul> </li> </ul> <h3>Browse</h3> <ul> <li>Prev: <a href="template-response.html">TemplateResponse and SimpleTemplateResponse</a></li> <li>Next: <a href="signals.html">Signals</a></li> </ul> <h3>You are here:</h3> <ul> <li> <a href="../index.html">Django v1.3.1 documentation</a> <ul><li><a href="index.html">API Reference</a> <ul><li>Settings</li></ul> </li></ul> </li> </ul> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/ref/settings.txt" rel="nofollow">Show Source</a></li> </ul> <div id="searchbox" style="display: none"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <input type="text" name="q" size="18" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <h3>Last update:</h3> <p class="topless">Sep 10, 2011</p> </div> </div> <div id="ft"> <div class="nav"> « <a href="template-response.html" title="TemplateResponse and SimpleTemplateResponse">previous</a> | <a href="index.html" title="API Reference" accesskey="U">up</a> | <a href="signals.html" title="Signals">next</a> »</div> </div> </div> <div class="clearer"></div> </div> </body> </html>