Skip to content
Ryan Shepherd edited this page May 21, 2026 · 12 revisions

hooked on facets

Filtering, finally fun.

The modern facet-filter plugin for WordPress and WooCommerce.

Release Status PHP WordPress


Note

⚙️ v0.4.0-alpha — admin grows up

The facet editor goes from "scaffold that works if you know what you're doing" to a real CRUD experience: drag rows to reorder, duplicate or delete inline, and get caught at the door if your config has problems — red rings on invalid fields, ⚠ badge on the row, and the Save button switches to Fix N issues so you see it's a deliberate block.

📦 Download v0.4.0-alpha · 📝 Release notes · 🐛 Open an issue

Still pre-alpha — installable but the indexer is demo-grade and WooCommerce integration isn't bulletproofed. Kick the tires, file bugs, don't ship it to a production storefront yet.


what is this

hooked on facets (HOF) is a faceted-search plugin built for the WordPress of today, not the WordPress of 2014.

  • Vanilla JS public runtime. No framework on the storefront. Surgical updates, small payload, no jQuery.
  • ⚙️ React 18 admin SPA. Built on @wordpress/components so the admin feels native.
  • 🎨 CSS variables out of the box. Theme it without fighting !important.
  • 🛒 WooCommerce-first. Built around products, not bolted on.
  • 🪝 PSR-4, Composer, real namespaces. A codebase a human can read.
  • 🐳 Dev environment included. docker compose up, you're filtering.

who's this for

  • Store owners who want their customers to find things in under three clicks.
  • Developers tired of plugins that look like they were last touched in 2017.
  • Designers who need filters that don't break their layouts.

quick links

🚀 Getting Started Stand up your first facet in five minutes.
🧠 Core Concepts What's a facet, anyway?
🏗️ Architecture How HOF is built under the hood.
🗺️ Roadmap What's shipping, when.
⚖️ Comparison HOF vs FacetWP vs WP Grid Builder.
🤝 Contributing Bring your hooks.

current status

Warning

Pre-alpha — v0.4.0-alpha. Installable, but the indexer is demo-grade and WooCommerce integration isn't yet a first-class layer. See the Roadmap for what's shipped and what's coming next.


hooked on facets is open source. Built by @Shepdesign. PRs welcome.

Clone this wiki locally