Package django :: Package conf :: Module global_settings
[hide private]
[frames] | no frames]

Source Code for Module django.conf.global_settings

  1  # Default Django settings. Override these with settings in the module 
  2  # pointed-to by the DJANGO_SETTINGS_MODULE environment variable. 
  3   
  4  # This is defined here as a do-nothing function because we can't import 
  5  # django.utils.translation -- that module depends on the settings. 
  6  gettext_noop = lambda s: s 
  7   
  8  #################### 
  9  # CORE             # 
 10  #################### 
 11   
 12  DEBUG = False 
 13  TEMPLATE_DEBUG = False 
 14   
 15  # Whether to use the "Etag" header. This saves bandwidth but slows down performance. 
 16  USE_ETAGS = False 
 17   
 18  # People who get code error notifications. 
 19  # In the format (('Full Name', 'email@domain.com'), ('Full Name', 'anotheremail@domain.com')) 
 20  ADMINS = () 
 21   
 22  # Tuple of IP addresses, as strings, that: 
 23  #   * See debug comments, when DEBUG is true 
 24  #   * Receive x-headers 
 25  INTERNAL_IPS = () 
 26   
 27  # Local time zone for this installation. All choices can be found here: 
 28  # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name (although not all 
 29  # systems may support all possibilities). 
 30  TIME_ZONE = 'America/Chicago' 
 31   
 32  # Language code for this installation. All choices can be found here: 
 33  # http://www.i18nguy.com/unicode/language-identifiers.html 
 34  LANGUAGE_CODE = 'en-us' 
 35   
 36  # Languages we provide translations for, out of the box. The language name 
 37  # should be the utf-8 encoded local name for the language. 
 38  LANGUAGES = ( 
 39      ('ar', gettext_noop('Arabic')), 
 40      ('bn', gettext_noop('Bengali')), 
 41      ('bg', gettext_noop('Bulgarian')), 
 42      ('ca', gettext_noop('Catalan')), 
 43      ('cs', gettext_noop('Czech')), 
 44      ('cy', gettext_noop('Welsh')), 
 45      ('da', gettext_noop('Danish')), 
 46      ('de', gettext_noop('German')), 
 47      ('el', gettext_noop('Greek')), 
 48      ('en', gettext_noop('English')), 
 49      ('es', gettext_noop('Spanish')), 
 50      ('es-ar', gettext_noop('Argentinean Spanish')), 
 51      ('eu', gettext_noop('Basque')), 
 52      ('fa', gettext_noop('Persian')), 
 53      ('fi', gettext_noop('Finnish')), 
 54      ('fr', gettext_noop('French')), 
 55      ('ga', gettext_noop('Irish')), 
 56      ('gl', gettext_noop('Galician')), 
 57      ('hu', gettext_noop('Hungarian')), 
 58      ('he', gettext_noop('Hebrew')), 
 59      ('hr', gettext_noop('Croatian')), 
 60      ('is', gettext_noop('Icelandic')), 
 61      ('it', gettext_noop('Italian')), 
 62      ('ja', gettext_noop('Japanese')), 
 63      ('ka', gettext_noop('Georgian')), 
 64      ('ko', gettext_noop('Korean')), 
 65      ('km', gettext_noop('Khmer')), 
 66      ('kn', gettext_noop('Kannada')), 
 67      ('lv', gettext_noop('Latvian')), 
 68      ('mk', gettext_noop('Macedonian')), 
 69      ('nl', gettext_noop('Dutch')), 
 70      ('no', gettext_noop('Norwegian')), 
 71      ('pl', gettext_noop('Polish')), 
 72      ('pt', gettext_noop('Portugese')), 
 73      ('pt-br', gettext_noop('Brazilian Portuguese')), 
 74      ('ro', gettext_noop('Romanian')), 
 75      ('ru', gettext_noop('Russian')), 
 76      ('sk', gettext_noop('Slovak')), 
 77      ('sl', gettext_noop('Slovenian')), 
 78      ('sr', gettext_noop('Serbian')), 
 79      ('sv', gettext_noop('Swedish')), 
 80      ('ta', gettext_noop('Tamil')), 
 81      ('te', gettext_noop('Telugu')), 
 82      ('tr', gettext_noop('Turkish')), 
 83      ('uk', gettext_noop('Ukrainian')), 
 84      ('zh-cn', gettext_noop('Simplified Chinese')), 
 85      ('zh-tw', gettext_noop('Traditional Chinese')), 
 86  ) 
 87   
 88  # Languages using BiDi (right-to-left) layout 
 89  LANGUAGES_BIDI = ("he", "ar", "fa") 
 90   
 91  # If you set this to False, Django will make some optimizations so as not 
 92  # to load the internationalization machinery. 
 93  USE_I18N = True 
 94  LOCALE_PATHS = () 
 95  LANGUAGE_COOKIE_NAME = 'django_language' 
 96   
 97  # Not-necessarily-technical managers of the site. They get broken link 
 98  # notifications and other various e-mails. 
 99  MANAGERS = ADMINS 
100   
101  # Default content type and charset to use for all HttpResponse objects, if a 
102  # MIME type isn't manually specified. These are used to construct the 
103  # Content-Type header. 
104  DEFAULT_CONTENT_TYPE = 'text/html' 
105  DEFAULT_CHARSET = 'utf-8' 
106   
107  # Encoding of files read from disk (template and initial SQL files). 
108  FILE_CHARSET = 'utf-8' 
109   
110  # E-mail address that error messages come from. 
111  SERVER_EMAIL = 'root@localhost' 
112   
113  # Whether to send broken-link e-mails. 
114  SEND_BROKEN_LINK_EMAILS = False 
115   
116  # Database connection info. 
117  DATABASE_ENGINE = ''           # 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'. 
118  DATABASE_NAME = ''             # Or path to database file if using sqlite3. 
119  DATABASE_USER = ''             # Not used with sqlite3. 
120  DATABASE_PASSWORD = ''         # Not used with sqlite3. 
121  DATABASE_HOST = ''             # Set to empty string for localhost. Not used with sqlite3. 
122  DATABASE_PORT = ''             # Set to empty string for default. Not used with sqlite3. 
123  DATABASE_OPTIONS = {}          # Set to empty dictionary for default. 
124   
125  # Host for sending e-mail. 
126  EMAIL_HOST = 'localhost' 
127   
128  # Port for sending e-mail. 
129  EMAIL_PORT = 25 
130   
131  # Optional SMTP authentication information for EMAIL_HOST. 
132  EMAIL_HOST_USER = '' 
133  EMAIL_HOST_PASSWORD = '' 
134  EMAIL_USE_TLS = False 
135   
136  # List of strings representing installed apps. 
137  INSTALLED_APPS = () 
138   
139  # List of locations of the template source files, in search order. 
140  TEMPLATE_DIRS = () 
141   
142  # List of callables that know how to import templates from various sources. 
143  # See the comments in django/core/template/loader.py for interface 
144  # documentation. 
145  TEMPLATE_LOADERS = ( 
146      'django.template.loaders.filesystem.load_template_source', 
147      'django.template.loaders.app_directories.load_template_source', 
148  #     'django.template.loaders.eggs.load_template_source', 
149  ) 
150   
151  # List of processors used by RequestContext to populate the context. 
152  # Each one should be a callable that takes the request object as its 
153  # only parameter and returns a dictionary to add to the context. 
154  TEMPLATE_CONTEXT_PROCESSORS = ( 
155      'django.core.context_processors.auth', 
156      'django.core.context_processors.debug', 
157      'django.core.context_processors.i18n', 
158      'django.core.context_processors.media', 
159  #    'django.core.context_processors.request', 
160  ) 
161   
162  # Output to use in template system for invalid (e.g. misspelled) variables. 
163  TEMPLATE_STRING_IF_INVALID = '' 
164   
165  # URL prefix for admin media -- CSS, JavaScript and images. Make sure to use a 
166  # trailing slash. 
167  # Examples: "http://foo.com/media/", "/media/". 
168  ADMIN_MEDIA_PREFIX = '/media/' 
169   
170  # Default e-mail address to use for various automated correspondence from 
171  # the site managers. 
172  DEFAULT_FROM_EMAIL = 'webmaster@localhost' 
173   
174  # Subject-line prefix for email messages send with django.core.mail.mail_admins 
175  # or ...mail_managers.  Make sure to include the trailing space. 
176  EMAIL_SUBJECT_PREFIX = '[Django] ' 
177   
178  # Whether to append trailing slashes to URLs. 
179  APPEND_SLASH = True 
180   
181  # Whether to prepend the "www." subdomain to URLs that don't have it. 
182  PREPEND_WWW = False 
183   
184  # List of compiled regular expression objects representing User-Agent strings 
185  # that are not allowed to visit any page, systemwide. Use this for bad 
186  # robots/crawlers. Here are a few examples: 
187  #     import re 
188  #     DISALLOWED_USER_AGENTS = ( 
189  #         re.compile(r'^NaverBot.*'), 
190  #         re.compile(r'^EmailSiphon.*'), 
191  #         re.compile(r'^SiteSucker.*'), 
192  #         re.compile(r'^sohu-search') 
193  #     ) 
194  DISALLOWED_USER_AGENTS = () 
195   
196  ABSOLUTE_URL_OVERRIDES = {} 
197   
198  # Tuple of strings representing allowed prefixes for the {% ssi %} tag. 
199  # Example: ('/home/html', '/var/www') 
200  ALLOWED_INCLUDE_ROOTS = () 
201   
202  # If this is a admin settings module, this should be a list of 
203  # settings modules (in the format 'foo.bar.baz') for which this admin 
204  # is an admin. 
205  ADMIN_FOR = () 
206   
207  # 404s that may be ignored. 
208  IGNORABLE_404_STARTS = ('/cgi-bin/', '/_vti_bin', '/_vti_inf') 
209  IGNORABLE_404_ENDS = ('mail.pl', 'mailform.pl', 'mail.cgi', 'mailform.cgi', 'favicon.ico', '.php') 
210   
211  # A secret key for this particular Django installation. Used in secret-key 
212  # hashing algorithms. Set this in your settings, or Django will complain 
213  # loudly. 
214  SECRET_KEY = '' 
215   
216  # Path to the "jing" executable -- needed to validate XMLFields 
217  JING_PATH = "/usr/bin/jing" 
218   
219  # Absolute path to the directory that holds media. 
220  # Example: "/home/media/media.lawrence.com/" 
221  MEDIA_ROOT = '' 
222   
223  # URL that handles the media served from MEDIA_ROOT. 
224  # Example: "http://media.lawrence.com" 
225  MEDIA_URL = '' 
226   
227  # Default formatting for date objects. See all available format strings here: 
228  # http://www.djangoproject.com/documentation/templates/#now 
229  DATE_FORMAT = 'N j, Y' 
230   
231  # Default formatting for datetime objects. See all available format strings here: 
232  # http://www.djangoproject.com/documentation/templates/#now 
233  DATETIME_FORMAT = 'N j, Y, P' 
234   
235  # Default formatting for time objects. See all available format strings here: 
236  # http://www.djangoproject.com/documentation/templates/#now 
237  TIME_FORMAT = 'P' 
238   
239  # Default formatting for date objects when only the year and month are relevant. 
240  # See all available format strings here: 
241  # http://www.djangoproject.com/documentation/templates/#now 
242  YEAR_MONTH_FORMAT = 'F Y' 
243   
244  # Default formatting for date objects when only the month and day are relevant. 
245  # See all available format strings here: 
246  # http://www.djangoproject.com/documentation/templates/#now 
247  MONTH_DAY_FORMAT = 'F j' 
248   
249  # Do you want to manage transactions manually? 
250  # Hint: you really don't! 
251  TRANSACTIONS_MANAGED = False 
252   
253  # The User-Agent string to use when checking for URL validity through the 
254  # isExistingURL validator. 
255  from django import get_version 
256  URL_VALIDATOR_USER_AGENT = "Django/%s (http://www.djangoproject.com)" % get_version() 
257   
258  # The tablespaces to use for each model when not specified otherwise. 
259  DEFAULT_TABLESPACE = '' 
260  DEFAULT_INDEX_TABLESPACE = '' 
261   
262  ############## 
263  # MIDDLEWARE # 
264  ############## 
265   
266  # List of middleware classes to use.  Order is important; in the request phase, 
267  # this middleware classes will be applied in the order given, and in the 
268  # response phase the middleware will be applied in reverse order. 
269  MIDDLEWARE_CLASSES = ( 
270      'django.contrib.sessions.middleware.SessionMiddleware', 
271      'django.contrib.auth.middleware.AuthenticationMiddleware', 
272  #     'django.middleware.http.ConditionalGetMiddleware', 
273  #     'django.middleware.gzip.GZipMiddleware', 
274      'django.middleware.common.CommonMiddleware', 
275      'django.middleware.doc.XViewMiddleware', 
276  ) 
277   
278  ############ 
279  # SESSIONS # 
280  ############ 
281   
282  SESSION_COOKIE_NAME = 'sessionid'                       # Cookie name. This can be whatever you want. 
283  SESSION_COOKIE_AGE = 60 * 60 * 24 * 7 * 2               # Age of cookie, in seconds (default: 2 weeks). 
284  SESSION_COOKIE_DOMAIN = None                            # A string like ".lawrence.com", or None for standard domain cookie. 
285  SESSION_COOKIE_SECURE = False                           # Whether the session cookie should be secure (https:// only). 
286  SESSION_COOKIE_PATH = '/'                               # The path of the session cookie. 
287  SESSION_SAVE_EVERY_REQUEST = False                      # Whether to save the session data on every request. 
288  SESSION_EXPIRE_AT_BROWSER_CLOSE = False                 # Whether sessions expire when a user closes his browser. 
289  SESSION_ENGINE = 'django.contrib.sessions.backends.db'  # The module to store session data 
290  SESSION_FILE_PATH = None                                # Directory to store session files if using the file session module. If None, the backend will use a sensible default. 
291   
292  ######### 
293  # CACHE # 
294  ######### 
295   
296  # The cache backend to use.  See the docstring in django.core.cache for the 
297  # possible values. 
298  CACHE_BACKEND = 'locmem://' 
299  CACHE_MIDDLEWARE_KEY_PREFIX = '' 
300  CACHE_MIDDLEWARE_SECONDS = 600 
301   
302  #################### 
303  # COMMENTS         # 
304  #################### 
305   
306  COMMENTS_ALLOW_PROFANITIES = False 
307   
308  # The profanities that will trigger a validation error in the 
309  # 'hasNoProfanities' validator. All of these should be in lowercase. 
310  PROFANITIES_LIST = ('asshat', 'asshead', 'asshole', 'cunt', 'fuck', 'gook', 'nigger', 'shit') 
311   
312  # The group ID that designates which users are banned. 
313  # Set to None if you're not using it. 
314  COMMENTS_BANNED_USERS_GROUP = None 
315   
316  # The group ID that designates which users can moderate comments. 
317  # Set to None if you're not using it. 
318  COMMENTS_MODERATORS_GROUP = None 
319   
320  # The group ID that designates the users whose comments should be e-mailed to MANAGERS. 
321  # Set to None if you're not using it. 
322  COMMENTS_SKETCHY_USERS_GROUP = None 
323   
324  # The system will e-mail MANAGERS the first COMMENTS_FIRST_FEW comments by each 
325  # user. Set this to 0 if you want to disable it. 
326  COMMENTS_FIRST_FEW = 0 
327   
328  # A tuple of IP addresses that have been banned from participating in various 
329  # Django-powered features. 
330  BANNED_IPS = () 
331   
332  ################## 
333  # AUTHENTICATION # 
334  ################## 
335   
336  AUTHENTICATION_BACKENDS = ('django.contrib.auth.backends.ModelBackend',) 
337   
338  LOGIN_URL = '/accounts/login/' 
339   
340  LOGOUT_URL = '/accounts/logout/' 
341   
342  LOGIN_REDIRECT_URL = '/accounts/profile/' 
343   
344  ########### 
345  # TESTING # 
346  ########### 
347   
348  # The name of the method to use to invoke the test suite 
349  TEST_RUNNER = 'django.test.simple.run_tests' 
350   
351  # The name of the database to use for testing purposes. 
352  # If None, a name of 'test_' + DATABASE_NAME will be assumed 
353  TEST_DATABASE_NAME = None 
354   
355  # Strings used to set the character set and collation order for the test 
356  # database. These values are passed literally to the server, so they are 
357  # backend-dependent. If None, no special settings are sent (system defaults are 
358  # used). 
359  TEST_DATABASE_CHARSET = None 
360  TEST_DATABASE_COLLATION = None 
361   
362  ############ 
363  # FIXTURES # 
364  ############ 
365   
366  # The list of directories to search for fixtures 
367  FIXTURE_DIRS = () 
368