summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorPavel Savchenko <asfaltboy@gmail.com>2019-01-21 16:13:42 +0100
committerTim Graham <timograham@gmail.com>2019-01-21 10:13:42 -0500
commit130192b12b63357a8f5ff448cd0edfa5a8094909 (patch)
tree7704da3ff1882d5795707156340062712ebbff4d /docs/ref
parentd15c61cabbe1c15068ffeb58c64035057f0c7d5c (diff)
Corrected GenericRelation's related_query_name manual lookup example.
And changed related_query_name to a singular noun.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/contrib/contenttypes.txt12
1 files changed, 6 insertions, 6 deletions
diff --git a/docs/ref/contrib/contenttypes.txt b/docs/ref/contrib/contenttypes.txt
index 8e6c7cab82..70eefe5117 100644
--- a/docs/ref/contrib/contenttypes.txt
+++ b/docs/ref/contrib/contenttypes.txt
@@ -394,21 +394,21 @@ be used to retrieve their associated ``TaggedItems``::
Defining :class:`~django.contrib.contenttypes.fields.GenericRelation` with
``related_query_name`` set allows querying from the related object::
- tags = GenericRelation(TaggedItem, related_query_name='bookmarks')
+ tags = GenericRelation(TaggedItem, related_query_name='bookmark')
This enables filtering, ordering, and other query operations on ``Bookmark``
from ``TaggedItem``::
>>> # Get all tags belonging to bookmarks containing `django` in the url
- >>> TaggedItem.objects.filter(bookmarks__url__contains='django')
+ >>> TaggedItem.objects.filter(bookmark__url__contains='django')
<QuerySet [<TaggedItem: django>, <TaggedItem: python>]>
-Of course, if you don't add the reverse relationship, you can do the
+Of course, if you don't add the ``related_query_name``, you can do the
same types of lookups manually::
- >>> b = Bookmark.objects.get(url='https://www.djangoproject.com/')
- >>> bookmark_type = ContentType.objects.get_for_model(b)
- >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id=b.id)
+ >>> bookmarks = Bookmark.objects.filter(url__contains='django')
+ >>> bookmark_type = ContentType.objects.get_for_model(Bookmark)
+ >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id__in=bookmarks)
<QuerySet [<TaggedItem: django>, <TaggedItem: python>]>
Just as :class:`~django.contrib.contenttypes.fields.GenericForeignKey`