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.6.0-alpha — customer-ready foundation

Four pieces of plumbing that close the gap between "cool demo" and "real customer can actually run a store on this": WP-CLI commands (wp hof reindex / status / facets), Date Range indexer (string-dates → Unix epoch via strtotime at index time), WooCommerce first-class integration (auto-detect + one-click add for product_cat / pa_* / _price / _stock_status), and background reindex via wp_cron chunking (100k+ catalogs no longer block PHP-FPM).

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

Still pre-alpha — but meaningfully closer to "shippable" with every release. Kick the tires, file bugs.


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.6.0-alpha. Installable; the indexer + WooCommerce integration just got real. 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