diff options
| author | Jacek Bzdak <jbzdak@gmail.com> | 2015-10-21 10:28:22 +0200 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2015-10-23 15:24:14 -0400 |
| commit | 488538e55e8f32c00f43f66367a63a4e6a56e1c6 (patch) | |
| tree | 12e737044d2c20f9ebdeed966f62cb790d462d89 /docs/ref/class-based-views | |
| parent | 2eab4acb3e523d296b3ed1e0374d2a40486e96cc (diff) | |
[1.9.x] Fixed #25397 -- Documented class-based view context variable clash with context processors.
Backport of 494b7986a3e5996d857b085f188a630d1504d9ca from master
Diffstat (limited to 'docs/ref/class-based-views')
| -rw-r--r-- | docs/ref/class-based-views/mixins-single-object.txt | 26 |
1 files changed, 20 insertions, 6 deletions
diff --git a/docs/ref/class-based-views/mixins-single-object.txt b/docs/ref/class-based-views/mixins-single-object.txt index 8296064c15..af9acbfaa7 100644 --- a/docs/ref/class-based-views/mixins-single-object.txt +++ b/docs/ref/class-based-views/mixins-single-object.txt @@ -106,20 +106,34 @@ SingleObjectMixin Returns context data for displaying the list of objects. - The base implementation of this method requires that the ``object`` + The base implementation of this method requires that the ``self.object`` attribute be set by the view (even if ``None``). Be sure to do this if you are using this mixin without one of the built-in views that does so. + It returns a dictionary with these contents: + + * ``object``: The object that this view is displaying + (``self.object``). + * ``context_object_name``: ``self.object`` will also be stored under + the name returned by :meth:`get_context_object_name`, which defaults + to the lowercased version of the model name. + + .. admonition:: Context variables override values from template context processors + + Any variables from :meth:`get_context_data` take precedence over + context variables from :ref:`context processors + <subclassing-context-requestcontext>`. For example, if your view + sets the :attr:`model` attribute to + :class:`~django.contrib.auth.models.User`, the default context + object name of ``user`` would override the ``user`` variable from + the :func:`django.contrib.auth.context_processors.auth` context + processor. Use :meth:`get_context_object_name` to avoid a clash. + .. method:: get_slug_field() Returns the name of a slug field to be used to look up by slug. By default this simply returns the value of :attr:`slug_field`. - **Context** - - * ``object``: The object that this view is displaying. If - ``context_object_name`` is specified, that variable will also be - set in the context, with the same value as ``object``. SingleObjectTemplateResponseMixin --------------------------------- |