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.

Status PHP WordPress

Note

These pages are the original planning spec. Some details have diverged from the shipped code — most notably the frontend stack (the plugin uses React 18 for the admin SPA and a vanilla JS public runtime, not Preact + Signals) and the Roadmap, which understates what's actually been built. Follow-up commits will true these up; the live code is the source of truth.


what is this

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

  • Preact + Signals on the frontend. Surgical reactivity, ~4kb runtime, no jQuery.
  • 🎨 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. HOF is in active development. The plugin scaffold is being built now. Star the repo to get pinged when the first alpha drops.


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

Clone this wiki locally