PHPackages humanmade/query-filter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. humanmade/query-filter ActiveWordpress-plugin[Utility & Helpers](/categories/utility) humanmade/query-filter ====================== Query Loop Block filters 0.2.4(2mo ago)1187.7k↑63.6%29[11 issues](https://github.com/humanmade/query-filter/issues)[9 PRs](https://github.com/humanmade/query-filter/pulls)GPL-2.0-or-laterPHP Since Sep 6Pushed 1mo ago21 watchersCompare [ Source](https://github.com/humanmade/query-filter)[ Packagist](https://packagist.org/packages/humanmade/query-filter)[ RSS](/packages/humanmade-query-filter/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (20)Used By (0) Query Loop Filters ================== [](#query-loop-filters) [![image](https://private-user-images.githubusercontent.com/494927/372935172-85358de8-0929-47fe-85f5-b53a59fb522e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ2ODA4NDAsIm5iZiI6MTc3NDY4MDU0MCwicGF0aCI6Ii80OTQ5MjcvMzcyOTM1MTcyLTg1MzU4ZGU4LTA5MjktNDdmZS04NWY1LWI1M2E1OWZiNTIyZS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMyOFQwNjQ5MDBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wMGU4ZTAyZjMyMzYwZjMxODQzNmEzZDkzNGZjMzEyZGE3Njg0YTUzZjA4NTBkYTNkOGQyNGY2MDM3NTc3OTUxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.ferRimcY6wLW8WLZo77oKw85LoIjkHSLSLNLf2IOdrY)](https://private-user-images.githubusercontent.com/494927/372935172-85358de8-0929-47fe-85f5-b53a59fb522e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ2ODA4NDAsIm5iZiI6MTc3NDY4MDU0MCwicGF0aCI6Ii80OTQ5MjcvMzcyOTM1MTcyLTg1MzU4ZGU4LTA5MjktNDdmZS04NWY1LWI1M2E1OWZiNTIyZS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMyOFQwNjQ5MDBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wMGU4ZTAyZjMyMzYwZjMxODQzNmEzZDkzNGZjMzEyZGE3Njg0YTUzZjA4NTBkYTNkOGQyNGY2MDM3NTc3OTUxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.ferRimcY6wLW8WLZo77oKw85LoIjkHSLSLNLf2IOdrY) 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 ----- [](#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://private-user-images.githubusercontent.com/494927/372997532-e2f9b62d-91f7-4c22-87ac-078b4d031a60.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ2ODA4NDAsIm5iZiI6MTc3NDY4MDU0MCwicGF0aCI6Ii80OTQ5MjcvMzcyOTk3NTMyLWUyZjliNjJkLTkxZjctNGMyMi04N2FjLTA3OGI0ZDAzMWE2MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMyOFQwNjQ5MDBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT05YzA2MTRiYjJiZmZkOTY3ODIwN2RlOWI5NmMyMDM4OTNiMzZhNTY1N2QyMWQ1N2I1NTkwYTU0YTdlZTc3NjI5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.rMIZqrs8xXNEbRgH7b5wsE7I9eEHDEp2LGwBZXXRcUA)](https://private-user-images.githubusercontent.com/494927/372997532-e2f9b62d-91f7-4c22-87ac-078b4d031a60.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ2ODA4NDAsIm5iZiI6MTc3NDY4MDU0MCwicGF0aCI6Ii80OTQ5MjcvMzcyOTk3NTMyLWUyZjliNjJkLTkxZjctNGMyMi04N2FjLTA3OGI0ZDAzMWE2MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMyOFQwNjQ5MDBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT05YzA2MTRiYjJiZmZkOTY3ODIwN2RlOWI5NmMyMDM4OTNiMzZhNTY1N2QyMWQ1N2I1NTkwYTU0YTdlZTc3NjI5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.rMIZqrs8xXNEbRgH7b5wsE7I9eEHDEp2LGwBZXXRcUA) Installation ------------ [](#installation) ### Using Composer [](#using-composer) This plugin is available on packagist. `composer require humanmade/query-filter` ### Manually from Github. [](#manually-from-github) 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. ### Health Score 49 — FairBetter than 95% of packages Maintenance85 Actively maintained with recent releases Popularity44 Moderate usage in the ecosystem Community23 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 68.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~59 days Recently: every ~119 days Total 10 Last Release 83d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/77dbeefb7745010589603f2ffc6ff310d8f700b58e08d52af190744c43342526?d=identicon)[roborourke](/maintainers/roborourke) --- Top Contributors [![roborourke](https://avatars.githubusercontent.com/u/23417?v=4)](https://github.com/roborourke "roborourke (30 commits)")[![mattheu](https://avatars.githubusercontent.com/u/494927?v=4)](https://github.com/mattheu "mattheu (8 commits)")[![jeremyfelt](https://avatars.githubusercontent.com/u/286171?v=4)](https://github.com/jeremyfelt "jeremyfelt (3 commits)")[![altrugon](https://avatars.githubusercontent.com/u/398069?v=4)](https://github.com/altrugon "altrugon (1 commits)")[![jonathanpryer-seon](https://avatars.githubusercontent.com/u/183589407?v=4)](https://github.com/jonathanpryer-seon "jonathanpryer-seon (1 commits)")[![ocean90](https://avatars.githubusercontent.com/u/617637?v=4)](https://github.com/ocean90 "ocean90 (1 commits)") ### Embed Badge ![Health badge](/badges/humanmade-query-filter/health.svg) ``` [![Health](https://phpackages.com/badges/humanmade-query-filter/health.svg)](https://phpackages.com/packages/humanmade-query-filter) ``` ### Alternatives [rainlab/blog-plugin Blog plugin for October CMS 17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin Builder plugin for October CMS 17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format. 5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8 Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary A terminology markup extension with a Semantic MediaWiki back-end 1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite A lightweight Lottie Animations Extension for WordPress 374.3k](/packages/humanmade-lottie-lite) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)