The official Seekmodo Search plugin for WordPress 6.2 and up. One-click pairing, AI-grade search, and native WP_Query as the always-on fallback. WooCommerce vertical auto-activates when WC is installed — one zip, two verticals.
seekmodo-wordpress-v0.3.2.zip · released 2026-06-11
Prefer searching from WP-admin? The plugin is being prepared for the WordPress.org Plugin Directory. Updates already route through seekmodo.com via the plugin's Update URI header.
Every release is published with a SHA-256 sidecar and an ed25519 signature so you can confirm the zip wasn't altered in transit. Run this on macOS / Linux (or WSL / Git Bash on Windows):
curl -fLO https://seekmodo.com/plugins/seekmodo-wordpress-v0.3.2.zip curl -fLO https://seekmodo.com/plugins/seekmodo-wordpress-v0.3.2.zip.sha256 sha256sum -c seekmodo-wordpress-v0.3.2.zip.sha256 # expected: seekmodo-wordpress-v0.3.2.zip: OK
SHA-256: 889e2b332738d8a210c54445db7b305856b8e5541890d23a0c114d14268f3d0b
The signing key is published at /.well-known/release-signing-keys.json (current kid: seekmodo-2026-06-r2). The corresponding public key also ships inside the plugin under assets/release-signing-keys/ so future in-plugin signature verification has a vendored key to chain against.
sha256sum -c.wp-content/plugins/seekmodo-search/. Click Activate. The bootstrap creates the events table and seeds option defaults (MODE=off until you pair).Three lines from WP-CLI replicate the WP-admin pairing ritual for staging / fleet rollouts:
wp plugin install https://seekmodo.com/plugins/seekmodo-wordpress-v0.3.2.zip --activate wp seekmodo connect --tenant=<tenant_id> --secret=<shared_secret> wp seekmodo index --full wp option update seekmodo_wp_mode shadow
Once the WP.org listing is live, the install line becomes wp plugin install seekmodo --activate — the rest of the ritual is identical.
From v0.3.0, the bundled commerce vertical auto-activates when the plugin detects WooCommerce. Indexed fields include name, SKU, brand (auto-detected from WC Brands / Perfect Brands / YITH Brand), category breadcrumbs, on-sale flag, sale price, currency, and stock state — all mapped to the gateway's commerce Typesense schema. Variation-aware. Stock-aware. On-sale faceted. The same WC_Product_Query is kept permanently armed as a graceful fallback.
Want the WooCommerce-first walkthrough? See the WooCommerce page — same download, just framed for the commerce side.
Every released version is downloadable from the same cadence-stable URL pattern (/plugins/seekmodo-wordpress-v<X.Y.Z>.zip) so rolling back is a one-liner. Full per-release detail in the repo's CHANGELOG.md.
Critical fix: the "Connect to Seekmodo" pairing flow has been rebuilt on the canonical install_token + signed-JWT protocol that seekmodo.com actually implements. v0.3.0 / v0.3.1 sent legacy nonce / return_to query params that surfaced "This link is incomplete" on seekmodo.com — pairing through the browser was impossible. Mandatory upgrade for any site that hasn't paired yet.
Hot-fix: the "Connect to Seekmodo" button silently redirected operators to the WP admin homepage instead of seekmodo.com. wp_safe_redirect() rejected the off-site host without an allow-list. Superseded by v0.3.2 which fixes the deeper protocol mismatch the redirect was masking.
WooCommerce vertical realigned to the gateway's commerce schema — product indexing now actually works (was 400'ing every upsert). Schema-version auto-promotes a one-time full reindex on the commerce side; content vertical is undisturbed. Ships the self-service "Promote dev to production" admin card so merchants can flip their canonical from a dev site to production without an operator round-trip — the missing-link feature for shipping a connector dev-first and then graduating to www.
Signature-mismatch self-recovery. When the gateway refuses 3+ HMAC requests with `signature_mismatch` inside a 5-minute sliding window, the plugin now surfaces a yellow admin notice pointing at the Re-pair button. The notice clears itself the moment the next gateway call returns 2xx — closes the gap where a connector with a stale snapshot cache could 401 indefinitely after a secret rotation.
Release-signing rotated to stable kid `seekmodo-2026-06`. Vendored JWK now ships in the plugin so a future in-plugin signature check has a real key to verify against. No code changes — auto-upgrades transparently from 0.1.4.
WordPress.org Plugin Directory submission readiness. Plugin header `Update URI` routes update checks to seekmodo.com so we can ship hot-fixes faster than the w.org SVN cadence. `WporgUpdateClient` hooks `update_plugins_seekmodo.com` and the `plugins_api → plugin_information` modal. Plugin name shortened to "Seekmodo Search". Build pipeline now writes manifest entries with the same schema as the live `zen_cart` entry.
Per-tenant "Powered by Seekmodo" branding toggle. Defaults to off — partner / specific-deal sites can flip it on from admin.seekmodo.com without a code change. Themes can override via the `seekmodo_show_branding` filter.
AutoPromoter substate FSM wired end-to-end. The promised "set MODE=active + auto_promote=true and we'll bake into enforce automatically" flow now actually advances; both content and commerce swap-points consult the projected effective mode instead of the operator's headline mode.
Content indexer doc shape aligned with the gateway's Typesense `content` collection schema. Sprints 0-5 landed: scaffolding, gateway client + breaker, mode FSM + AutoPromoter + ShadowDiffLogger, content + commerce search swaps, events queue + click beacon + health widget, cutover-readiness CLI gate, WP.org submission package.
Initial pre-release. Sprint matrix documented in README.md.
Most install hiccups are clock skew (HMAC requires NTP- synced clocks) or outbound HTTPS being blocked at the host firewall. The troubleshooting guide walks both. If you're still stuck, drop us a line.