summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2016-06-30 09:00:10 -0400
committerGitHub <noreply@github.com>2016-06-30 09:00:10 -0400
commitc9d0a0f7f47c8496a9d8b0cfda94e2ef118d9ab3 (patch)
tree579ff9f4318c3b5585d596298efe1d07d69b83fb /docs/ref
parentbaff4dd37dabfef1ff939513fa45124382b57bf8 (diff)
Fixed #26002 -- Explained ModelAdmin.get_search_results() example.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/contrib/admin/index.txt7
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt
index 60409c69d1..d588964a70 100644
--- a/docs/ref/contrib/admin/index.txt
+++ b/docs/ref/contrib/admin/index.txt
@@ -1398,7 +1398,7 @@ templates used by the :class:`ModelAdmin` views:
implemented by your search method may introduce duplicates into the results,
and return ``True`` in the second element of the return value.
- For example, to enable search by integer field, you could use::
+ For example, to search by ``name`` and ``age``, you could use::
class PersonAdmin(admin.ModelAdmin):
list_display = ('name', 'age')
@@ -1414,6 +1414,11 @@ templates used by the :class:`ModelAdmin` views:
queryset |= self.model.objects.filter(age=search_term_as_int)
return queryset, use_distinct
+ This implementation is more efficient than ``search_fields =
+ ('name', '=age')`` which results in a string comparison for the numeric
+ field, for example ``... OR UPPER("polls_choice"."votes"::text) = UPPER('4')``
+ on PostgreSQL.
+
.. method:: ModelAdmin.save_related(request, form, formsets, change)
The ``save_related`` method is given the ``HttpRequest``, the parent