Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

3.1 KB
Raw Blame

WordPress embed

The three.ws Agent plugin (integrations/wordpress/three-ws-agent/) embeds <agent-3d> as a Gutenberg block or a shortcode. No npm, no build step, no bundler: the editor script is plain ES5-safe JS against the wp.* globals WordPress already ships, and both entry points render through one shared PHP function so the block editor's preview is never a second, divergent implementation of the markup.

Installing

Copy or symlink integrations/wordpress/three-ws-agent/ into wp-content/plugins/, then activate three.ws Agent from Plugins. There is nothing to configure: a public agent, agent ID, or bare model URL renders with no API key.

Block

Search the block inserter for "three.ws Agent" (category: Embeds). The inspector panel exposes:

Attribute Purpose
On-chain URI agent://base/42. Takes priority over Agent ID and Model URL.
Agent ID Backend account ID or CAIP-10 ID. Used when On-chain URI is empty.
Chain ID Paired with a numeric Agent ID.
Model URL Bare GLB for an ad-hoc agent. Used when On-chain URI and Agent ID are both empty.
Background transparent, dark, or light.
Framing full or portrait.

Shortcode

For the classic editor, widgets, or theme templates:

[three_ws_agent src="agent://base/42" background="dark" framing="portrait"]

agent_id, chain_id, and model are also accepted, matching the block's attributes.

SRI pin

includes/pinned-release.php is generated from data/agent-3d-releases.json by npm run build:site-builder-embeds (the same step that pins the Framer and Webflow components). The render function enqueues the loader script with type="module", integrity, and crossorigin via a script_loader_tag filter, since core's enqueue API has no argument for ESM integrity pins. npm run check:site-builder-embeds (wired into npm run gate) fails the build if the plugin's pin drifts from the ledger.

Verification

Verified against a real local WordPress install in Docker (no mocks), using the official Plugin Check plugin from wordpress.org:

scripts/wordpress-plugin-check.sh

Reproduced output from a real run:

[plugin-check] WordPress version: 7.1.3
[plugin-check] activating three-ws-agent...
Success: Activated 1 of 1 plugins.
[plugin-check] installing the official Plugin Check plugin from wordpress.org...
Success: Installed 1 of 1 plugins.
[plugin-check] running wp plugin check three-ws-agent...
Success: Checks complete. No errors found.

The script also confirms the block and the shortcode both render a real <agent-3d> tag with the correct pinned script tag on a live page before tearing the containers down.

Submitting to the WordPress.org plugin directory

Submission (an upload under an owner-controlled WordPress.org account, and the review queue that follows it) is an owner action: see marketing/growth/submissions/site-builders.md.