Installing the plugin
Two ways to install: from the WordPress.org plugin directory once approval lands, or by uploading the zip from install.xpay.sh (works today).
From the install.xpay.sh zip
Download the zip
Visit install.xpay.sh/wordpress-publishers/latest.zip . The file is ~30 KB and downloads as agentic-storefront-for-publishers.zip. Some browsers may show a “this file may be unsafe” notice — that’s standard for any plugin zip, click Keep.
Open the upload form
In wp-admin, hover Plugins → click Add New Plugin → click Upload Plugin at the top of the page.
Upload
Click Choose File, pick the zip you just downloaded, then Install Now.
Activate
Click Activate Plugin. You’ll be redirected to Settings → Agentic Storefront.
Connect site
See Connecting your site.
Auto-updates work for zip installs. The plugin reads a manifest at install.xpay.sh/wordpress-publishers/manifest.json and offers updates through the normal WordPress Plugins → Updates flow.
System requirements
| Component | Minimum | Tested up to |
|---|---|---|
| WordPress | 6.2 | 7.0 |
| PHP | 7.4 | 8.3 |
| WooCommerce | not required | n/a |
SSL (https://) | required for the agent storefront endpoint | — |
The plugin is fully compatible with: classic themes, block themes (Gutenberg-native), the major ad networks (Mediavine, Raptive, Ezoic, AdThrive, MonetizeMore — recommendations are contextual editorial, not banner inventory), Yoast SEO / Rank Math / AIOSEO (the llms.txt and /.well-known/* emitters detect existing files and refuse to overwrite), and the WP Consent API.
What happens on activation
In order, the plugin:
- Registers the
[xpay_recs]shortcode and the Recommendations Gutenberg block. - Hooks
the_contentat priority 20 for the auto-inject path (default ON). - Hooks
wp_footerat priority 50 for the FAB + footer drawer script enqueue. - Schedules a one-time rewrite-rule flush so the
/.well-known/agent-storefront.jsonroute is reachable when the emitter is enabled. - Redirects you to Settings → Agentic Storefront.
The plugin does not contact xpay’s servers at activation. The first network call only happens when you click Connect site.
Verifying the install
After activation, check these in any order:
| Check | What you should see |
|---|---|
| Plugins list | ”Agentic Storefront for Publishers” with version 0.3.4+ and status “Active” |
| Settings → Agentic Storefront | A “Connect site” card (or already-connected status if you’ve signed in before) inside a sandboxed iframe |
curl https://yoursite.com/wp-json/asp/v1/status | HTTP 200 JSON with connected: false (until you connect) |
Plugin Check (wp plugin-check agentic-storefront-for-publishers) | Zero errors, zero warnings |
If the Plugin Check command isn’t installed:
wp plugin install plugin-check --activate
wp plugin-check agentic-storefront-for-publishersWhat’s next
→ Connecting your site (3-step handshake)