Author: russellm Date: 2010-05-09 01:50:39 -0500 (Sun, 09 May 2010) New Revision: 13176
Modified: django/branches/releases/1.1.X/docs/ref/contrib/admin/index.txt Log: [1.1.X] Fixed #10712 -- Added documentation for the queryset() method on ModelAdmin. Thanks to mrts for the report, and timo for the patch. Backport of r13170 from trunk. Modified: django/branches/releases/1.1.X/docs/ref/contrib/admin/index.txt =================================================================== --- django/branches/releases/1.1.X/docs/ref/contrib/admin/index.txt 2010-05-09 06:50:06 UTC (rev 13175) +++ django/branches/releases/1.1.X/docs/ref/contrib/admin/index.txt 2010-05-09 06:50:39 UTC (rev 13176) @@ -823,6 +823,20 @@ This uses the ``HttpRequest`` instance to filter the ``Car`` foreign key field to only the cars owned by the ``User`` instance. +.. method:: ModelAdmin.queryset(self, request): + +The ``queryset`` method on a ``ModelAdmin`` returns a +:class:`~django.db.models.QuerySet` of all model instances that can be +edited by the admin site. One use case for overriding this method is +to show objects owned by the logged-in user:: + + class MyModelAdmin(admin.ModelAdmin): + def queryset(self, request): + qs = super(self, MyModelAdmin).queryset(request) + if request.user.is_superuser: + return qs + return qs.filter(author=request.user) + Other methods ~~~~~~~~~~~~~ -- You received this message because you are subscribed to the Google Groups "Django updates" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/django-updates?hl=en.
