Fixed #20294 -- Documented context processors in TemplateResponseMixin.

This commit is contained in:
Zbigniew Siciarz 2013-05-18 12:32:48 +02:00 committed by Florian Apolloner
parent 8fd44b2551
commit 0b0741602b
1 changed files with 11 additions and 0 deletions

View File

@ -60,6 +60,17 @@ TemplateResponseMixin
altered later (e.g. in altered later (e.g. in
:ref:`template response middleware <template-response-middleware>`). :ref:`template response middleware <template-response-middleware>`).
.. admonition:: Context processors
``TemplateResponse`` uses :class:`~django.template.RequestContext`
which means that callables defined in
:setting:`TEMPLATE_CONTEXT_PROCESSORS` may overwrite template
variables defined in your views. For example, if you subclass
:class:`DetailView <django.views.generic.detail.DetailView>` and
set ``context_object_name`` to ``user``, the
``django.contrib.auth.context_processors.auth`` context processor
will happily overwrite your variable with current user.
If you need custom template loading or custom context object If you need custom template loading or custom context object
instantiation, create a ``TemplateResponse`` subclass and assign it to instantiation, create a ``TemplateResponse`` subclass and assign it to
``response_class``. ``response_class``.