Skip to main content

WordPress Plugin

The direct-install WordPress plugin is the new preferred path for connecting a non-Woo WordPress site to Sequenzy without pasting API keys into WordPress. Instead of manually wiring custom code or relying on SMTP-only setup, the plugin starts a connection request inside WordPress and sends you straight to Sequenzy to sign in and choose the company that should own the site.

What the current beta includes

  • Direct-install plugin pairing
  • A first-class WordPress plugin beta card in Settings -> Integrations
  • A browser authorize page at /setup/wordpress
  • A dedicated installation token for each plugin install
  • Plugin heartbeat reporting so Sequenzy can track connection health
  • Automatic initial WordPress user sync after approval
  • WordPress user registration and profile-update delivery from the plugin
  • Optional comment opt-in delivery from the plugin
  • Local plugin diagnostics for recent failures
  • A simplified plugin admin flow built around connect, reconnect, disconnect, sync, and diagnostics
  • Repeatable zip packaging from the repo with bun run build:plugins

What is not included yet

  • Gutenberg form blocks and shortcode embeds
  • Automatic plugin updates
  • WordPress.org packaging and review assets
  • SMTP or WooCommerce behavior in this plugin
Those pieces are the next layer on top of the current backend and connect flow foundation.

How connection works

  1. You open the plugin in WordPress and click Connect to Sequenzy.
  2. The plugin sends site metadata to Sequenzy and gets back a direct authorize URL.
  3. Sequenzy opens a hosted page where you sign in if needed and choose which company should own the site.
  4. The plugin polls Sequenzy until the connection is complete.
  5. Sequenzy issues a dedicated installation token scoped to that WordPress integration.
This token is separate from normal Sequenzy API keys, so reconnecting or disconnecting the plugin does not affect other tools.

What Sequenzy tracks

After approval, Sequenzy stores:
  • the connected company
  • the WordPress site URL and site name
  • the plugin version
  • the WordPress version
  • the PHP version
  • the last heartbeat time
This makes it easier to see whether the plugin is connected, stale, or disconnected.

Why this direction

The plugin-first path avoids several problems with ad hoc WordPress integrations:
  • site owners do not need to paste Sequenzy API keys into WordPress
  • plugin installs get their own revocable credentials
  • Sequenzy gets an explicit installation identity for support and diagnostics
  • WordPress can become a clean subscriber and event source without custom theme edits

Current status

This is still a beta direct-install connector, not a finished marketplace-ready WordPress plugin release. The install/auth path, hosted authorize flow, heartbeat handling, automatic initial user sync, WordPress user event delivery, comment opt-in flow, and repeatable zip packaging are implemented in the repo plugin. Form embeds, automatic updates, and marketplace packaging are still pending.