Django-1.2.1/django/conf/global_settings.py

   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 the framework should propagate raw exceptions rather than catching
  16 # them. This is useful under some testing siutations and should never be used
  17 # on a live site.
  18 DEBUG_PROPAGATE_EXCEPTIONS = False
  19
  20 # Whether to use the "Etag" header. This saves bandwidth but slows down performance.
  21 USE_ETAGS = False
  22
  23 # People who get code error notifications.
  24 # In the format (('Full Name', 'email@domain.com'), ('Full Name', 'anotheremail@domain.com'))
  25 ADMINS = ()
  26
  27 # Tuple of IP addresses, as strings, that:
  28 #   * See debug comments, when DEBUG is true
  29 #   * Receive x-headers
  30 INTERNAL_IPS = ()
  31
  32 # Local time zone for this installation. All choices can be found here:
  33 # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name (although not all
  34 # systems may support all possibilities).
  35 TIME_ZONE = 'America/Chicago'
  36
  37 # Language code for this installation. All choices can be found here:
  38 # http://www.i18nguy.com/unicode/language-identifiers.html
  39 LANGUAGE_CODE = 'en-us'
  40
  41 # Languages we provide translations for, out of the box. The language name
  42 # should be the utf-8 encoded local name for the language.
  43 LANGUAGES = (
  44     ('ar', gettext_noop('Arabic')),
  45     ('bg', gettext_noop('Bulgarian')),
  46     ('bn', gettext_noop('Bengali')),
  47     ('bs', gettext_noop('Bosnian')),
  48     ('ca', gettext_noop('Catalan')),
  49     ('cs', gettext_noop('Czech')),
  50     ('cy', gettext_noop('Welsh')),
  51     ('da', gettext_noop('Danish')),
  52     ('de', gettext_noop('German')),
  53     ('el', gettext_noop('Greek')),
  54     ('en', gettext_noop('English')),
  55     ('en-gb', gettext_noop('British English')),
  56     ('es', gettext_noop('Spanish')),
  57     ('es-ar', gettext_noop('Argentinean Spanish')),
  58     ('et', gettext_noop('Estonian')),
  59     ('eu', gettext_noop('Basque')),
  60     ('fa', gettext_noop('Persian')),
  61     ('fi', gettext_noop('Finnish')),
  62     ('fr', gettext_noop('French')),
  63     ('fy-nl', gettext_noop('Frisian')),
  64     ('ga', gettext_noop('Irish')),
  65     ('gl', gettext_noop('Galician')),
  66     ('he', gettext_noop('Hebrew')),
  67     ('hi', gettext_noop('Hindi')),
  68     ('hr', gettext_noop('Croatian')),
  69     ('hu', gettext_noop('Hungarian')),
  70     ('id', gettext_noop('Indonesian')),
  71     ('is', gettext_noop('Icelandic')),
  72     ('it', gettext_noop('Italian')),
  73     ('ja', gettext_noop('Japanese')),
  74     ('ka', gettext_noop('Georgian')),
  75     ('km', gettext_noop('Khmer')),
  76     ('kn', gettext_noop('Kannada')),
  77     ('ko', gettext_noop('Korean')),
  78     ('lt', gettext_noop('Lithuanian')),
  79     ('lv', gettext_noop('Latvian')),
  80     ('mk', gettext_noop('Macedonian')),
  81     ('mn', gettext_noop('Mongolian')),
  82     ('nl', gettext_noop('Dutch')),
  83     ('no', gettext_noop('Norwegian')),
  84     ('nb', gettext_noop('Norwegian Bokmal')),
  85     ('nn', gettext_noop('Norwegian Nynorsk')),
  86     ('pl', gettext_noop('Polish')),
  87     ('pt', gettext_noop('Portuguese')),
  88     ('pt-br', gettext_noop('Brazilian Portuguese')),
  89     ('ro', gettext_noop('Romanian')),
  90     ('ru', gettext_noop('Russian')),
  91     ('sk', gettext_noop('Slovak')),
  92     ('sl', gettext_noop('Slovenian')),
  93     ('sq', gettext_noop('Albanian')),
  94     ('sr', gettext_noop('Serbian')),
  95     ('sr-latn', gettext_noop('Serbian Latin')),
  96     ('sv', gettext_noop('Swedish')),
  97     ('ta', gettext_noop('Tamil')),
  98     ('te', gettext_noop('Telugu')),
  99     ('th', gettext_noop('Thai')),
 100     ('tr', gettext_noop('Turkish')),
 101     ('uk', gettext_noop('Ukrainian')),
 102     ('vi', gettext_noop('Vietnamese')),
 103     ('zh-cn', gettext_noop('Simplified Chinese')),
 104     ('zh-tw', gettext_noop('Traditional Chinese')),
 105 )
 106
 107 # Languages using BiDi (right-to-left) layout
 108 LANGUAGES_BIDI = ("he", "ar", "fa")
 109
 110 # If you set this to False, Django will make some optimizations so as not
 111 # to load the internationalization machinery.
 112 USE_I18N = True
 113 LOCALE_PATHS = ()
 114 LANGUAGE_COOKIE_NAME = 'django_language'
 115
 116 # If you set this to True, Django will format dates, numbers and calendars
 117 # according to user current locale
 118 USE_L10N = False
 119
 120 # Not-necessarily-technical managers of the site. They get broken link
 121 # notifications and other various e-mails.
 122 MANAGERS = ADMINS
 123
 124 # Default content type and charset to use for all HttpResponse objects, if a
 125 # MIME type isn't manually specified. These are used to construct the
 126 # Content-Type header.
 127 DEFAULT_CONTENT_TYPE = 'text/html'
 128 DEFAULT_CHARSET = 'utf-8'
 129
 130 # Encoding of files read from disk (template and initial SQL files).
 131 FILE_CHARSET = 'utf-8'
 132
 133 # E-mail address that error messages come from.
 134 SERVER_EMAIL = 'root@localhost'
 135
 136 # Whether to send broken-link e-mails.
 137 SEND_BROKEN_LINK_EMAILS = False
 138
 139 # Database connection info.
 140 # Legacy format
 141 DATABASE_ENGINE = ''           # 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
 142 DATABASE_NAME = ''             # Or path to database file if using sqlite3.
 143 DATABASE_USER = ''             # Not used with sqlite3.
 144 DATABASE_PASSWORD = ''         # Not used with sqlite3.
 145 DATABASE_HOST = ''             # Set to empty string for localhost. Not used with sqlite3.
 146 DATABASE_PORT = ''             # Set to empty string for default. Not used with sqlite3.
 147 DATABASE_OPTIONS = {}          # Set to empty dictionary for default.
 148
 149 # New format
 150 DATABASES = {
 151 }
 152
 153 # Classes used to implement db routing behaviour
 154 DATABASE_ROUTERS = []
 155
 156 # The email backend to use. For possible shortcuts see django.core.mail.
 157 # The default is to use the SMTP backend.
 158 # Third-party backends can be specified by providing a Python path
 159 # to a module that defines an EmailBackend class.
 160 EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
 161
 162 # Host for sending e-mail.
 163 EMAIL_HOST = 'localhost'
 164
 165 # Port for sending e-mail.
 166 EMAIL_PORT = 25
 167
 168 # Optional SMTP authentication information for EMAIL_HOST.
 169 EMAIL_HOST_USER = ''
 170 EMAIL_HOST_PASSWORD = ''
 171 EMAIL_USE_TLS = False
 172
 173 # List of strings representing installed apps.
 174 INSTALLED_APPS = ()
 175
 176 # List of locations of the template source files, in search order.
 177 TEMPLATE_DIRS = ()
 178
 179 # List of callables that know how to import templates from various sources.
 180 # See the comments in django/core/template/loader.py for interface
 181 # documentation.
 182 TEMPLATE_LOADERS = (
 183     'django.template.loaders.filesystem.Loader',
 184     'django.template.loaders.app_directories.Loader',
 185 #     'django.template.loaders.eggs.Loader',
 186 )
 187
 188 # List of processors used by RequestContext to populate the context.
 189 # Each one should be a callable that takes the request object as its
 190 # only parameter and returns a dictionary to add to the context.
 191 TEMPLATE_CONTEXT_PROCESSORS = (
 192     'django.contrib.auth.context_processors.auth',
 193     'django.core.context_processors.debug',
 194     'django.core.context_processors.i18n',
 195     'django.core.context_processors.media',
 196 #    'django.core.context_processors.request',
 197     'django.contrib.messages.context_processors.messages',
 198 )
 199
 200 # Output to use in template system for invalid (e.g. misspelled) variables.
 201 TEMPLATE_STRING_IF_INVALID = ''
 202
 203 # URL prefix for admin media -- CSS, JavaScript and images. Make sure to use a
 204 # trailing slash.
 205 # Examples: "http://foo.com/media/", "/media/".
 206 ADMIN_MEDIA_PREFIX = '/media/'
 207
 208 # Default e-mail address to use for various automated correspondence from
 209 # the site managers.
 210 DEFAULT_FROM_EMAIL = 'webmaster@localhost'
 211
 212 # Subject-line prefix for email messages send with django.core.mail.mail_admins
 213 # or ...mail_managers.  Make sure to include the trailing space.
 214 EMAIL_SUBJECT_PREFIX = '[Django] '
 215
 216 # Whether to append trailing slashes to URLs.
 217 APPEND_SLASH = True
 218
 219 # Whether to prepend the "www." subdomain to URLs that don't have it.
 220 PREPEND_WWW = False
 221
 222 # Override the server-derived value of SCRIPT_NAME
 223 FORCE_SCRIPT_NAME = None
 224
 225 # List of compiled regular expression objects representing User-Agent strings
 226 # that are not allowed to visit any page, systemwide. Use this for bad
 227 # robots/crawlers. Here are a few examples:
 228 #     import re
 229 #     DISALLOWED_USER_AGENTS = (
 230 #         re.compile(r'^NaverBot.*'),
 231 #         re.compile(r'^EmailSiphon.*'),
 232 #         re.compile(r'^SiteSucker.*'),
 233 #         re.compile(r'^sohu-search')
 234 #     )
 235 DISALLOWED_USER_AGENTS = ()
 236
 237 ABSOLUTE_URL_OVERRIDES = {}
 238
 239 # Tuple of strings representing allowed prefixes for the {% ssi %} tag.
 240 # Example: ('/home/html', '/var/www')
 241 ALLOWED_INCLUDE_ROOTS = ()
 242
 243 # If this is a admin settings module, this should be a list of
 244 # settings modules (in the format 'foo.bar.baz') for which this admin
 245 # is an admin.
 246 ADMIN_FOR = ()
 247
 248 # 404s that may be ignored.
 249 IGNORABLE_404_STARTS = ('/cgi-bin/', '/_vti_bin', '/_vti_inf')
 250 IGNORABLE_404_ENDS = ('mail.pl', 'mailform.pl', 'mail.cgi', 'mailform.cgi', 'favicon.ico', '.php')
 251
 252 # A secret key for this particular Django installation. Used in secret-key
 253 # hashing algorithms. Set this in your settings, or Django will complain
 254 # loudly.
 255 SECRET_KEY = ''
 256
 257 # Default file storage mechanism that holds media.
 258 DEFAULT_FILE_STORAGE = 'django.core.files.storage.FileSystemStorage'
 259
 260 # Absolute path to the directory that holds media.
 261 # Example: "/home/media/media.lawrence.com/"
 262 MEDIA_ROOT = ''
 263
 264 # URL that handles the media served from MEDIA_ROOT.
 265 # Example: "http://media.lawrence.com"
 266 MEDIA_URL = ''
 267
 268 # List of upload handler classes to be applied in order.
 269 FILE_UPLOAD_HANDLERS = (
 270     'django.core.files.uploadhandler.MemoryFileUploadHandler',
 271     'django.core.files.uploadhandler.TemporaryFileUploadHandler',
 272 )
 273
 274 # Maximum size, in bytes, of a request before it will be streamed to the
 275 # file system instead of into memory.
 276 FILE_UPLOAD_MAX_MEMORY_SIZE = 2621440 # i.e. 2.5 MB
 277
 278 # Directory in which upload streamed files will be temporarily saved. A value of
 279 # `None` will make Django use the operating system's default temporary directory
 280 # (i.e. "/tmp" on *nix systems).
 281 FILE_UPLOAD_TEMP_DIR = None
 282
 283 # The numeric mode to set newly-uploaded files to. The value should be a mode
 284 # you'd pass directly to os.chmod; see http://docs.python.org/lib/os-file-dir.html.
 285 FILE_UPLOAD_PERMISSIONS = None
 286
 287 # Python module path where user will place custom format definition.
 288 # The directory where this setting is pointing should contain subdirectories
 289 # named as the locales, containing a formats.py file
 290 # (i.e. "myproject.locale" for myproject/locale/en/formats.py etc. use)
 291 FORMAT_MODULE_PATH = None
 292
 293 # Default formatting for date objects. See all available format strings here:
 294 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 295 DATE_FORMAT = 'N j, Y'
 296
 297 # Default formatting for datetime objects. See all available format strings here:
 298 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 299 DATETIME_FORMAT = 'N j, Y, P'
 300
 301 # Default formatting for time objects. See all available format strings here:
 302 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 303 TIME_FORMAT = 'P'
 304
 305 # Default formatting for date objects when only the year and month are relevant.
 306 # See all available format strings here:
 307 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 308 YEAR_MONTH_FORMAT = 'F Y'
 309
 310 # Default formatting for date objects when only the month and day are relevant.
 311 # See all available format strings here:
 312 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 313 MONTH_DAY_FORMAT = 'F j'
 314
 315 # Default short formatting for date objects. See all available format strings here:
 316 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 317 SHORT_DATE_FORMAT = 'm/d/Y'
 318
 319 # Default short formatting for datetime objects.
 320 # See all available format strings here:
 321 # http://docs.djangoproject.com/en/dev/ref/templates/builtins/#now
 322 SHORT_DATETIME_FORMAT = 'm/d/Y P'
 323
 324 # Default formats to be used when parsing dates from input boxes, in order
 325 # See all available format string here:
 326 # http://docs.python.org/library/datetime.html#strftime-behavior
 327 # * Note that these format strings are different from the ones to display dates
 328 DATE_INPUT_FORMATS = (
 329     '%Y-%m-%d', '%m/%d/%Y', '%m/%d/%y', # '2006-10-25', '10/25/2006', '10/25/06'
 330     '%b %d %Y', '%b %d, %Y',            # 'Oct 25 2006', 'Oct 25, 2006'
 331     '%d %b %Y', '%d %b, %Y',            # '25 Oct 2006', '25 Oct, 2006'
 332     '%B %d %Y', '%B %d, %Y',            # 'October 25 2006', 'October 25, 2006'
 333     '%d %B %Y', '%d %B, %Y',            # '25 October 2006', '25 October, 2006'
 334 )
 335
 336 # Default formats to be used when parsing times from input boxes, in order
 337 # See all available format string here:
 338 # http://docs.python.org/library/datetime.html#strftime-behavior
 339 # * Note that these format strings are different from the ones to display dates
 340 TIME_INPUT_FORMATS = (
 341     '%H:%M:%S',     # '14:30:59'
 342     '%H:%M',        # '14:30'
 343 )
 344
 345 # Default formats to be used when parsing dates and times from input boxes,
 346 # in order
 347 # See all available format string here:
 348 # http://docs.python.org/library/datetime.html#strftime-behavior
 349 # * Note that these format strings are different from the ones to display dates
 350 DATETIME_INPUT_FORMATS = (
 351     '%Y-%m-%d %H:%M:%S',     # '2006-10-25 14:30:59'
 352     '%Y-%m-%d %H:%M',        # '2006-10-25 14:30'
 353     '%Y-%m-%d',              # '2006-10-25'
 354     '%m/%d/%Y %H:%M:%S',     # '10/25/2006 14:30:59'
 355     '%m/%d/%Y %H:%M',        # '10/25/2006 14:30'
 356     '%m/%d/%Y',              # '10/25/2006'
 357     '%m/%d/%y %H:%M:%S',     # '10/25/06 14:30:59'
 358     '%m/%d/%y %H:%M',        # '10/25/06 14:30'
 359     '%m/%d/%y',              # '10/25/06'
 360 )
 361
 362 # First day of week, to be used on calendars
 363 # 0 means Sunday, 1 means Monday...
 364 FIRST_DAY_OF_WEEK = 0
 365
 366 # Decimal separator symbol
 367 DECIMAL_SEPARATOR = '.'
 368
 369 # Boolean that sets whether to add thousand separator when formatting numbers
 370 USE_THOUSAND_SEPARATOR = False
 371
 372 # Number of digits that will be togheter, when spliting them by THOUSAND_SEPARATOR
 373 # 0 means no grouping, 3 means splitting by thousands...
 374 NUMBER_GROUPING = 0
 375
 376 # Thousand separator symbol
 377 THOUSAND_SEPARATOR = ','
 378
 379 # Do you want to manage transactions manually?
 380 # Hint: you really don't!
 381 TRANSACTIONS_MANAGED = False
 382
 383 # The User-Agent string to use when checking for URL validity through the
 384 # isExistingURL validator.
 385 from django import get_version
 386 URL_VALIDATOR_USER_AGENT = "Django/%s (http://www.djangoproject.com)" % get_version()
 387
 388 # The tablespaces to use for each model when not specified otherwise.
 389 DEFAULT_TABLESPACE = ''
 390 DEFAULT_INDEX_TABLESPACE = ''
 391
 392 ##############
 393 # MIDDLEWARE #
 394 ##############
 395
 396 # List of middleware classes to use.  Order is important; in the request phase,
 397 # this middleware classes will be applied in the order given, and in the
 398 # response phase the middleware will be applied in reverse order.
 399 MIDDLEWARE_CLASSES = (
 400     'django.middleware.common.CommonMiddleware',
 401     'django.contrib.sessions.middleware.SessionMiddleware',
 402     'django.middleware.csrf.CsrfViewMiddleware',
 403     'django.contrib.auth.middleware.AuthenticationMiddleware',
 404     'django.contrib.messages.middleware.MessageMiddleware',
 405 #     'django.middleware.http.ConditionalGetMiddleware',
 406 #     'django.middleware.gzip.GZipMiddleware',
 407 )
 408
 409 ############
 410 # SESSIONS #
 411 ############
 412
 413 SESSION_COOKIE_NAME = 'sessionid'                       # Cookie name. This can be whatever you want.
 414 SESSION_COOKIE_AGE = 60 * 60 * 24 * 7 * 2               # Age of cookie, in seconds (default: 2 weeks).
 415 SESSION_COOKIE_DOMAIN = None                            # A string like ".lawrence.com", or None for standard domain cookie.
 416 SESSION_COOKIE_SECURE = False                           # Whether the session cookie should be secure (https:// only).
 417 SESSION_COOKIE_PATH = '/'                               # The path of the session cookie.
 418 SESSION_SAVE_EVERY_REQUEST = False                      # Whether to save the session data on every request.
 419 SESSION_EXPIRE_AT_BROWSER_CLOSE = False                 # Whether a user's session cookie expires when the Web browser is closed.
 420 SESSION_ENGINE = 'django.contrib.sessions.backends.db'  # The module to store session data
 421 SESSION_FILE_PATH = None                                # Directory to store session files if using the file session module. If None, the backend will use a sensible default.
 422
 423 #########
 424 # CACHE #
 425 #########
 426
 427 # The cache backend to use.  See the docstring in django.core.cache for the
 428 # possible values.
 429 CACHE_BACKEND = 'locmem://'
 430 CACHE_MIDDLEWARE_KEY_PREFIX = ''
 431 CACHE_MIDDLEWARE_SECONDS = 600
 432
 433 ####################
 434 # COMMENTS         #
 435 ####################
 436
 437 COMMENTS_ALLOW_PROFANITIES = False
 438
 439 # The profanities that will trigger a validation error in the
 440 # 'hasNoProfanities' validator. All of these should be in lowercase.
 441 PROFANITIES_LIST = ('asshat', 'asshead', 'asshole', 'cunt', 'fuck', 'gook', 'nigger', 'shit')
 442
 443 # The group ID that designates which users are banned.
 444 # Set to None if you're not using it.
 445 COMMENTS_BANNED_USERS_GROUP = None
 446
 447 # The group ID that designates which users can moderate comments.
 448 # Set to None if you're not using it.
 449 COMMENTS_MODERATORS_GROUP = None
 450
 451 # The group ID that designates the users whose comments should be e-mailed to MANAGERS.
 452 # Set to None if you're not using it.
 453 COMMENTS_SKETCHY_USERS_GROUP = None
 454
 455 # The system will e-mail MANAGERS the first COMMENTS_FIRST_FEW comments by each
 456 # user. Set this to 0 if you want to disable it.
 457 COMMENTS_FIRST_FEW = 0
 458
 459 # A tuple of IP addresses that have been banned from participating in various
 460 # Django-powered features.
 461 BANNED_IPS = ()
 462
 463 ##################
 464 # AUTHENTICATION #
 465 ##################
 466
 467 AUTHENTICATION_BACKENDS = ('django.contrib.auth.backends.ModelBackend',)
 468
 469 LOGIN_URL = '/accounts/login/'
 470
 471 LOGOUT_URL = '/accounts/logout/'
 472
 473 LOGIN_REDIRECT_URL = '/accounts/profile/'
 474
 475 # The number of days a password reset link is valid for
 476 PASSWORD_RESET_TIMEOUT_DAYS = 3
 477
 478 ########
 479 # CSRF #
 480 ########
 481
 482 # Dotted path to callable to be used as view when a request is
 483 # rejected by the CSRF middleware.
 484 CSRF_FAILURE_VIEW = 'django.views.csrf.csrf_failure'
 485
 486 # Name and domain for CSRF cookie.
 487 CSRF_COOKIE_NAME = 'csrftoken'
 488 CSRF_COOKIE_DOMAIN = None
 489
 490 ############
 491 # MESSAGES #
 492 ############
 493
 494 # Class to use as messges backend
 495 MESSAGE_STORAGE = 'django.contrib.messages.storage.user_messages.LegacyFallbackStorage'
 496
 497 # Default values of MESSAGE_LEVEL and MESSAGE_TAGS are defined within
 498 # django.contrib.messages to avoid imports in this settings file.
 499
 500 ###########
 501 # TESTING #
 502 ###########
 503
 504 # The name of the class to use to run the test suite
 505 TEST_RUNNER = 'django.test.simple.DjangoTestSuiteRunner'
 506
 507 # The name of the database to use for testing purposes.
 508 # If None, a name of 'test_' + DATABASE_NAME will be assumed
 509 TEST_DATABASE_NAME = None
 510
 511 # Strings used to set the character set and collation order for the test
 512 # database. These values are passed literally to the server, so they are
 513 # backend-dependent. If None, no special settings are sent (system defaults are
 514 # used).
 515 TEST_DATABASE_CHARSET = None
 516 TEST_DATABASE_COLLATION = None
 517
 518 ############
 519 # FIXTURES #
 520 ############
 521
 522 # The list of directories to search for fixtures
 523 FIXTURE_DIRS = ()