WPVDB Smart Search

Demo search UI, REST adapter, and optional site search replacement for dense, sparse, and hybrid search over content indexed by wpvdb.

The plugin also includes an optional site search surface. When enabled in Smart Search settings, eligible front end ?s= main queries are answered with ranked semantic results from wpvdb-search, while unsupported queries fall through to WordPress search. Site search defaults to dense mode; sparse and hybrid remain available for sites that want keyword ranking or sparse plus dense ranking.

Requirements

Requirement	Version or notes
WordPress	6.9 or newer
PHP	8.3 or newer
wpvdb-search	Installed and configured

What this plugin owns

• The /smart-search/ public page.
• Optional semantic handling for WordPress ?s= search queries.
• The wpvdb-smart-search/v1 REST namespace.
• The React UI, browser assets, and REST adapter.
• Demo examples, placeholders, and UI copy.
• A WP-CLI prewarm command for example query embeddings.

Search execution lives in wpvdb-search.

Development

Install dependencies:

bun install
composer install

Build the browser assets:

bun run build

Run the local checks:

bun run lint
bun run test

The main branch maintenance workflow regenerates translation files and commits them when strings change.

Run the same command locally only when you want to preview language file changes:

bun run i18n

License

GPL-2.0-or-later. See LICENSE.