Fixed #11889: Documented the fact that context processors will overwrite pre-existing context variables of the same names.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@12669 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
James Bennett 2010-03-03 08:43:05 +00:00
parent 1f56ed7319
commit cdd95077a6
1 changed files with 7 additions and 0 deletions

View File

@ -335,6 +335,13 @@ variable to the context and a second processor adds a variable with the same
name, the second will override the first. The default processors are explained name, the second will override the first. The default processors are explained
below. below.
.. admonition:: When context processors are applied
When you use ``RequestContext``, the variables you supply directly
are added first, followed any variables supplied by context
processors. This means that a context processor may overwrite a
variable you've supplied, so take care to avoid variable names
which overlap with those supplied by your context processors.
Also, you can give ``RequestContext`` a list of additional processors, using the Also, you can give ``RequestContext`` a list of additional processors, using the
optional, third positional argument, ``processors``. In this example, the optional, third positional argument, ``processors``. In this example, the
``RequestContext`` instance gets a ``ip_address`` variable:: ``RequestContext`` instance gets a ``ip_address`` variable::