manifest / developer / wpvdb-playground-demo

WPVDB Playground Demo

WordPress Playground demo plugin and Blueprint for wpvdb

by Automattic, Ramon Corrales · github.com/rbcorrales/wpvdb-playground-demo · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/rbcorrales/wpvdb-playground-demo/archive/refs/heads/main.zip

Readme github.com/rbcorrales/wpvdb-playground-demo ↗

Demo packaging for running WPVDB inside WordPress Playground.

This plugin depends on WPVDB core runtime support. Core owns SQLite fallback behavior, Playground runtime guards, and the public hooks. This demo plugin includes sample content, precomputed vectors, a preset query UI, and public Blueprints.

Requirements

Requirement	Version or notes
WordPress	6.5 or newer
PHP	7.4 or newer
`wpvdb`	Runtime support branch with SQLite and Playground hooks
WordPress Playground	Public Blueprint or compatible custom host

Blueprints

Blueprint	Installs	Purpose
`playground/blueprint.json`	`wpvdb`, `wpvdb-playground-demo`	Main public demo. Loads sample content, precomputed vectors, and preset query buttons on the WPVDB dashboard.
`playground/blueprint-suite.json`	`wpvdb`, `wpvdb-playground-demo`, `wpvdb-search`, `wpvdb-smart-search`, `wpvdb-blocks`	Full plugin suite demo. Loads the companion search, smart search, and blocks plugins in the same Playground site so their admin and frontend surfaces can be inspected alongside the WPVDB demo.

The suite Blueprint verifies that the companion plugins load together. The WPVDB dashboard presets and Related Articles work without a key, while arbitrary typed Smart Search still depends on future offline search support for SQLite in Playground.

Launch links:

wpvdb-playground-demo.php Plugin bootstrap and dependency checks.

includes/ Demo hook registration and admin UI helpers.

assets/js/wpvdb-demo.js Vanilla JavaScript for preset query buttons and results rendering.

playground/ Blueprint, preloader, and generated demo vectors.

Development

Install dependencies:

composer install

Run the local checks:

composer lint

Local intent

The plugin is inert unless both WPVDB_PLAYGROUND_RUNTIME and WPVDB_DEMO_MODE are true. The Blueprints in this repo set those constants before activating plugins, install WPVDB before this demo plugin, and then preload the sample content and vectors.