We have recently introduced an innovative /filter route, enabling more sophisticated filtering of the topics list. Significantly, this marks the initial step towards a unified topic filtering language for both search and filtering. Additionally, the dedicated route for topic list filtering enhances the customizability of the sidebar, as users can now incorporate links as custom section links within the sidebar.
How to turn it on
Enable the experimental_topics_filter
site settings in the admin interface.
How it works
The /filter has an input field which users can input a query string to filter through the list of topics.
As an example, category:documentation tag:how-to+email will filter for topics that are in the Documentation category tagged with both how-to and email.
Currently this is the list of filters that are supported:
status:open
topics that are not closed or archived
status:closed
topics that are closed
status:public
topics that are not read restricted (eg: belong to a secure category)
status:archived
topics that are archived
status:unlisted
topics that are not visible
status:listed
topics that are visible
status:deleted
topics
in:pinned
topics that are are pinned (either global or per category pins)
in:watching
stuff I am watching - supports (muted
,normal
,tracking
,watching_first_post
): allow for filtering down to stuff your are tracking, watching etc. - multiple values can be comma separated
in:bookmarked
stuff Iâve bookmarked
category:bug
topics in the bug category AND all subcategories
=category:bug
topics in the bug category excluding subcategories
category:documentation:admins
topics in the admins subcategory of documentation
category:bug,feature
topics in the bug or feature category including all subcategories
=category:bug,feature
topics in the bug or feature category excluding all subcategories
-category:bug,feature
excluding topics in the bug or feature category including all subcategories
-=category:bug,feature
excluding topics in the bug or feature category only excluding all subcategories
categories:
alias forcategory
tag:bug+feature
topics tagged both bug and feature
tag:bug,feature
topics tagged either bug or feature
-tag:bug+feature
excluding topics tagged bug and feature
-tag:bug,feature
excluding topics tagged bug or feature
tags:
alias fortag
tag_group:tag_group_name
topics tagged with any tags that are intag_group
-tag_group:tag_group_name
excluding topics tagged with any tag that is intag_group
created-by:@USERNAME
topics created by a specific user
posts-min:X
topics with X or more amount of posts
posts-max:X
topics with no more than max posts
posters-min:X
topics where at least X different users have posted
posters-max:X
topics where at most X different users have posted
likes-min:X
topics with X or more number of likes
likes-max:X
topics with no more than X number of likes
likes-op-min:X
topics with first post that has X or more number of likes
likes-op-max:X
topics with first post that has no more than X number of likes
views-min:X
topics with X or more number of views
views-max:X
topics with no more than X number of views
activity-before:YYYY-MM-DD
topics with latest bump before specified date
activity-after:YYYY-MM-DD
topicslatest bump after specified date
created-before:YYYY-MM-DD
created before specified date
created-after:YYYY-MM-DD
created after specified date
latest-post-before:YYYY-MM-DD
latest post created before specified date
latest-post-after:YYYY-MM-DD
latest post created after specified date
order:activity
order by bump date desc
order:latest-post
order by latest post creation desc
order:created
order by topic creation desc
order:views
order by topic views desc
order:likes
order by number of likes in the topic desc
order:likes-op
order by number of likes in the first post of each topic desc
order:posters
order by number of people who have posted desc
order:category
order by category name
order:ANY-asc
flip order on results so it is ascending
Feedback
We would love to find out from the community here if this feature will be valuable for your own community and would also like to know how youâre using it.
If there are any filters that you feel like will help you with your needs, do let us know as with with examples of what you are trying to do.
Finally, we want to highlight that this is a very early version of the feature and it is still considered experimental at this point. The user experience needs improvement and we are currently working on adding some sort of inline autocomplete or even an interface to allow users to build out a topics filtering query language without having to remember all the filters by heart.