mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-03 18:38:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Fixed #19721 -- Allowed admin filters to customize the list separator.

Browse source
This commit is contained in:
Shreya Bamne 2021-12-08 15:24:55 +01:00 • committed by Carlton Gibson
parent 2b76f45749
commit 8a4e506760
5 changed files with 72 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

19
docs/ref/contrib/admin/filters.txt
View file

@ -176,6 +176,25 @@ allows to store::
('title', admin.EmptyFieldListFilter),
)
By defining a filter using the ``__in`` lookup, it is possible to filter for
any of a group of values. You need to override the ``expected_parameters``
method, and the specify the ``lookup_kwargs`` attribute with the appropriate
field name. By default, multiple values in the query string will be separated
with commas, but this can be customized via the ``list_separator`` attribute.
The following example shows such a filter using the vertical-pipe character as
the separator::
class FilterWithCustomSeparator(admin.FieldListFilter):
# custom list separator that should be used to separate values.
list_separator = '|'
def __init__(self, field, request, params, model, model_admin, field_path):
self.lookup_kwarg = '%s__in' % field_path
super().__init__(field, request, params, model, model_admin, field_path)
def expected_parameters(self):
return [self.lookup_kwarg]
.. note::
The :class:`~django.contrib.contenttypes.fields.GenericForeignKey` field is