Browse Source

Fixed #20294 -- Documented context processors in TemplateResponseMixin.

Zbigniew Siciarz 12 years ago
parent
commit
0b0741602b
1 changed files with 11 additions and 0 deletions
  1. 11 0
      docs/ref/class-based-views/mixins-simple.txt

+ 11 - 0
docs/ref/class-based-views/mixins-simple.txt

@@ -60,6 +60,17 @@ TemplateResponseMixin
         altered later (e.g. in
         :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
         instantiation, create a ``TemplateResponse`` subclass and assign it to
         ``response_class``.