From 2f9c4e2b6fab3ce08cfbebff79d758196250790c Mon Sep 17 00:00:00 2001 From: Vytis Banaitis Date: Thu, 5 May 2016 20:52:54 +0300 Subject: Fixed #19963 -- Added support for date_hierarchy across relations. --- docs/ref/checks.txt | 2 +- docs/ref/contrib/admin/index.txt | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) (limited to 'docs/ref') diff --git a/docs/ref/checks.txt b/docs/ref/checks.txt index 03bdba97db..ac96fbf412 100644 --- a/docs/ref/checks.txt +++ b/docs/ref/checks.txt @@ -393,7 +393,7 @@ with the admin site: which is not editable through the admin. * **admin.E126**: The value of ``search_fields`` must be a list or tuple. * **admin.E127**: The value of ``date_hierarchy`` refers to ````, - which is not an attribute of ````. + which does not refer to a Field. * **admin.E128**: The value of ``date_hierarchy`` must be a ``DateField`` or ``DateTimeField``. diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index ac696656c2..6984589ee2 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -213,10 +213,19 @@ subclass:: date_hierarchy = 'pub_date' + You can also specify a field on a related model using the ``__`` lookup, + for example:: + + date_hierarchy = 'author__pub_date' + This will intelligently populate itself based on available data, e.g. if all the dates are in one month, it'll show the day-level drill-down only. + .. versionchanged:: 1.11 + + The ability to reference fields on related models was added. + .. note:: ``date_hierarchy`` uses :meth:`QuerySet.datetimes() -- cgit v1.3