Skip to content

Home

Jump to bottom
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.3.0-alpha — Visual DNA v3 (palette matching)

Each product now indexes a top-N color palette, not just one dominant color. A query for an accent color ranks the product carrying that accent ahead of products that don't have it at all — even if the accent isn't the product's dominant. Verified: a {gold} query returns the blue-with-gold-accent product first (ΔE=0.00) ahead of solid yellow (dE=17.44).

📦 Download v0.3.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.3.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.

hooked on facets · Filtering, finally fun. · GitHub · hookedonfacets.com

hooked on facets

Filtering, finally fun.

📖 docs

🧠 concepts

🎛️ facet types

🔧 develop

🗺️ project

⭐ Star on GitHub

Clone this wiki locally