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