https://github.com/humanmade/query-filter

Filter controls for the query loop block, using the interactivity API
https://github.com/humanmade/query-filter

Last synced: about 1 year ago
JSON representation

Filter controls for the query loop block, using the interactivity API

• Host: GitHub
• URL: https://github.com/humanmade/query-filter
• Owner: humanmade
• Created: 2024-09-06T15:12:30.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-05-22T10:43:18.000Z (about 1 year ago)
• Last Synced: 2025-06-28T16:12:00.422Z (about 1 year ago)
• Language: PHP
• Size: 104 KB
• Stars: 87
• Watchers: 22
• Forks: 16
• Open Issues: 12
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Query Loop Filters

![image](https://github.com/user-attachments/assets/85358de8-0929-47fe-85f5-b53a59fb522e)

This plugin allows you to easily add filters to any query loop block.

Provides 2 new blocks that can be added within a query loop block to allow filtering by either post type or a taxonomy. Also supports using the core search block to allow you to search.

Compatible with both the core query loop block and the [Advanced query loop plugin](https://wordpress.org/plugins/advanced-query-loop/) (In fact, in order to use post type filters, use of the Advanced Query Loop plugin is required). 

Easy to use and lightweight, built using the WordPress Interactivity API.

## Usage

* Add a query block. This can anyhere that the query block is supported e.g. page, template, or pattern.

* Add one of the filter blocks and configure as required:

    * Taxonomy filter. Select which taxonomy to to use, customise the label (and whether it's shown), and customise the text used when none is selected.

    * Post type filter. Customise the label (and whether it's shown), as well as the text used when no filter is applied.

    * Search block. No extra options.

 

![image](https://github.com/user-attachments/assets/e2f9b62d-91f7-4c22-87ac-078b4d031a60)

## Installation

1. Download the plugin from the [GitHub repository](https://github.com/humanmade/query-filter).

2. Upload the plugin to your site's `wp-content/plugins` directory.

3. Activate the plugin from the WordPress admin.