Skip to content

Commit

Permalink
Merge pull request #257 from petroleyum/patch-1
Browse files Browse the repository at this point in the history
Edit for clarity in filters.txt
  • Loading branch information
Carlton Gibson committed Jul 1, 2015
2 parents 17176bf + 0d61b5f commit 1228bee
Showing 1 changed file with 8 additions and 3 deletions.
11 changes: 8 additions & 3 deletions docs/ref/filters.txt
Original file line number Diff line number Diff line change
Expand Up @@ -70,10 +70,15 @@ some predefined strings could be used as input of a boolean filter::
``MultipleChoiceFilter``
~~~~~~~~~~~~~~~~~~~~~~~~

The same as ``ChoiceFilter`` except the user can select multiple items
and it selects the OR or AND(using ``conjoined=True``) of all the choices.
The same as ``ChoiceFilter`` except the user can select multiple choices
and the filter will form the OR of these choices by default to match items.
The filter will form the AND of the selected choices when the ``conjoined=True``
argument is passed to this class.

Advanced Use: Depending on your application logic, when all or no choices are
Multiple choices are represented in the query string by reusing the same key with
different values (e.g. ''?status=Regular&status=Admin'').

Advanced Use: Depending on your application logic, when all or no choices are
selected, filtering may be a noop. In this case you may wish to avoid the
filtering overhead, particularly of the `distinct` call.

Expand Down

0 comments on commit 1228bee

Please sign in to comment.