CBMVULA
CBMVULA
Start a project

WOOCOMMERCE PLUGIN / PROTOTYPE

Fast search, local index, no cloud.

Prototype Prototype with a documented release path. It is not currently available for download, production deployment, or general integration.

Commerce Discovery Search replaces heavy, cloud-dependent search plugins with a lightweight, self-hosted solution that builds and queries a local index directly inside WordPress. Instant predictive results — up to 8 product suggestions with images, price, and availability — using a debounced overlay sheet. Desktop and mobile overlay variants are in scope; staged WordPress/WooCommerce/Safari validation remains required before release.

HOW IT WORKS

Search that stays on your server.

01 / Local Index

Zero-Downtime Shadow Indexing

Versioned database tables with shadow rebuilds, validation, and atomic activation. Product updates sync automatically via Action Scheduler.

  • Custom tables (cds_documents, cds_tokens, cds_generations)
  • Retained-generation rollback
  • WP-Cron fallback
02 / Overlay

Instant Predictive Results

Full-width top sheet on desktop; full-screen sheet on mobile with 16px+ inputs to prevent iOS zoom. 180ms debounce, 3-character threshold.

  • Up to 8 product suggestions with image, price, and stock
  • Up to 4 category and tag suggestions
  • WAI-ARIA combobox semantics
03 / Ranking

Multi-Tier Match Pipeline

Exact SKU → exact title → title prefix → token prefix → bounded typo matching. Polish diacritic folding with original display spelling preserved.

  • Levenshtein-bounded typo tolerance
  • Featured/relevance and name ascending sorts
  • WP-CLI management (reindex, status, flush)
04 / Fallback

Server-Rendered Search Route

Dedicated /product-search/ endpoint with noindex, follow for accessibility and JavaScript-off scenarios.

  • Works without JavaScript
  • Shared hooks with Commerce Discovery Filters
  • PHP 8.1+, WordPress 6.7+, WooCommerce 9.8+

CURRENT LIMITATIONS

What this version does not do yet.

These are known constraints documented in the project's limitation file. They represent honest boundaries of the current 0.1.0-alpha release.

Catalog size+

Candidate retrieval is capped at 500 products. Stores with larger catalogs require benchmarking or a future engine adapter.

Single language+

The default index stores one language per product. Parallel multilingual indexing is not supported in this version.

No search analytics+

No dashboard reporting of popular queries, zero-result terms, or click-through rates.

No RTL support+

Interface layout assumes left-to-right scripts only.

No multisite+

Current 0.1 scope is single-site.

NEXT STEP

Interested in this plugin for your store?

If you’d like to discuss a future fit, get in touch.

Discuss a future fit