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.2.0-alpha — Visual DNA lands

Drop an image, paste a URL, or eyedrop any color on screen — the catalog filters to products that match. Two matching modes: indexed per-product LAB with SQL ΔE76 ranking when the indexer has data, snap to nearest color term as a graceful fallback.

📦 Download v0.2.0-alpha · 📝 Release notes · 🎨 Wiki: Visual DNA · 🐛 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.2.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 in v0.3.


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

Clone this wiki locally