Docs / Developers
WordPress plugin
Plugin version 0.2.0. Sideload the zip. A WordPress.org listing is not submitted yet.
What you get
- Pair one WordPress site to one EngageNudge site.
- Inject the browser SDK and serve a root-covering service worker.
- On publish, create a draft campaign and show Nudge Score in the editor.
- Disconnect locally without deleting subscribers.
The plugin never live-sends on publish.
Install
- Build or download the zip from the EngageNudge repo (
integrations/wordpress/dist/engagenudge-0.2.0.zip). - WordPress → Plugins → Add New → Upload Plugin → activate EngageNudge.
- EngageNudge → Integrations → Script → Generate pairing code.
- WordPress → Settings → EngageNudge → API URL, site id, pairing code → Pair site.
- If an existing root worker is detected, choose standalone or merge (
importScripts('/en-sw.js');). - Open a public page. Confirm the SDK and Install Doctor.
- Send a test Nudge from the dashboard.
Use https://api.engagenudge.com as the API URL. The WordPress origin must match the EngageNudge site origin.
Service worker
| Mode | Behavior |
|---|---|
| Standalone | Plugin serves /en-sw.js and /engagenudge-sw.js |
| Merge | You add importScripts('/en-sw.js'); to your worker |
Re-save permalinks if the worker 404s. Purge page cache and CDN after pairing.
Publish suggestions
Settings → EngageNudge → Publish suggestions (on by default). Publishing sends title, excerpt, featured image, and URL. The campaign is draft or cancelled, never sent. The editor metabox shows Nudge Score and Open in EngageNudge.
Disconnect
Plugin Disconnect clears local options only. Dashboard Disconnect WordPress revokes the credential.