Ticket #1278: template_context_constants.2.patch

django/conf/global_settings.py

@@ -136 +136 @@
 # only parameter and returns a dictionary to add to the context.
 TEMPLATE_CONTEXT_PROCESSORS = (
     'django.core.context_processors.auth',
+    'django.core.context_processors.constants',
     'django.core.context_processors.debug',
     'django.core.context_processors.i18n',
 #    'django.core.context_processors.request',
 )
 
+# Constants to add to all template contexts.
+TEMPLATE_CONTEXT_CONSTANTS = {}
+
 # Output to use in template system for invalid (e.g. misspelled) variables.
 TEMPLATE_STRING_IF_INVALID = ''
 

django/conf/project_template/settings.py

@@ -56 +56 @@
 #     'django.template.loaders.eggs.load_template_source',
 )
 
+# Constants to add to all template contexts (dependant on the context
+# processor 'django.core.context_processors.constants').
+TEMPLATE_CONTEXT_CONSTANTS = {'media_url': MEDIA_URL}
+
 MIDDLEWARE_CLASSES = (
     'django.middleware.common.CommonMiddleware',
     'django.contrib.sessions.middleware.SessionMiddleware',

django/core/context_processors.py

@@ -20 +20 @@
         'perms': PermWrapper(request.user),
     }
 
+def constants(request):
+    return settings.TEMPLATE_CONTEXT_CONSTANTS
+
 def debug(request):
     "Returns context variables helpful for debugging."
     context_extras = {}

docs/settings.txt

@@ -717 +717 @@
 Default::
 
     ("django.core.context_processors.auth",
+    "django.core.context_processors.constants",
     "django.core.context_processors.debug",
     "django.core.context_processors.i18n")
 

docs/templates_python.txt

@@ -290 +290 @@
 ``TEMPLATE_CONTEXT_PROCESSORS`` is set to::
 
     ("django.core.context_processors.auth",
+    "django.core.context_processors.constants",
     "django.core.context_processors.debug",
     "django.core.context_processors.i18n")
 
@@ -371 +372 @@
       representing every SQL query that has happened so far during the request
       and how long it took. The list is in order by query.
 
+django.core.context_processors.constants
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If ``TEMPLATE_CONTEXT_PROCESSORS`` contains this processor, every
+``Context`` will contain variables defined in the ``TEMPLATE_CONTEXT_CONSTANTS``
+setting.
+
 django.core.context_processors.i18n
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~