Sign up

Realtime WordPress events. Zero polling.

WPSignal serves as a WebSocket relay for your WordPress site. In combination with the WordSocket plugin, you can trigger events for any WordPress action hook. Dispatch events from your PHP code to all browsers connected to your site.

Getting Started

<Simple />

Installation

Download:
WP CLI:
Terminal 
wp plugin install wordsocket --activate
Composer:
Terminal 
composer require wpackagist-plugin/wordsocket

<Capabilities />

Built for WordPress developers

  • WebSocket-first

    Persistent WebSocket connections with Server-Sent Events as automatic fallback. Keepalive pings every 20 seconds.

    WP SITE PUBLISH RELAY WPSignal CLIENT CLIENT CLIENT

  • HMAC-signed publishes

    Every event is signed with SHA-256 HMAC. Timestamp replay protection and per-site rate limiting built in.

    PAYLOAD TIMESTAMP replay guard · SITE_SECRET HMAC SHA-256 a3f7 9c1e b82d SIG

  • Blind relay encryption

    When using WordSocket, all events are AES-256-GCM encrypted before leaving WordPress. WPSignal only ever sees ciphertext.

    PLAINTEXT RAND·IV 12 bytes ENCRYPT·KEY AES·256 GCM dGhp c2lz dGVz CIPHER

  • Explorer

    Built-in admin page showing connection status, live event log, publish form, and token inspector for instant debugging.

    WP·ADMIN CONNECTED EXPLORER post.updated 14ms order.paid 6ms user.login 11ms comment.new 2ms PUBLISH events post.updated LIVE 1 client · 1 ch TOKEN site_id channels exp EVENTS post.updated order.paid user.login

Realtime collaborative editing
without HTTP polling

Real-time collaboration is coming to WordPress core, and it is available today through the Gutenberg plugin: a collaborative block editor built on Yjs.

The default transport is HTTP polling. WordSocket registers as a WebSocket-based Yjs sync provider, replacing polling with a persistent low-latency connection using the same relay your events already run on. Install Gutenberg, connect WordSocket, and co-edit instantly. No extra configuration required.

See the docs
PEER·A STEP·1 UPDATE YJS RELAY WPSignal STEP·2 UPDATE PEER·B

<Code />

Example

Readable, developer focused API

on any WordPress action hook using the fluent builder API. Add a condition, custom channel, or transform the payload: all optional.

Listen for events

The browser client auto-connects and dispatches native CustomEvents, listen with plain JavaScript or integrate with any frontend framework.

See the full guide
wp-content/plugins/{plugin}/plugin.php 
add_action('wpsignal_loaded', function () {
  WPS::trigger('order.status_changed')
    ->on('woocommerce_order_status_changed', 10, 3)
    ->channel('events')
    ->data(
      fn ($order_id, $old_status, $new_status) => [
        'order_id' => $order_id,
        'old_status' => $old_status,
        'new_status' => $new_status,
        'total' => $order->get_total(),
      ])
    ->register();
});
wp-content/plugins/{plugin}/src/main.js 
document.addEventListener('wpsignal:order.status_changed', (e) => {
  const { 
    order_id, 
    new_status, 
    total 
  } = e.detail.data;
  triggerFlashNotification(order_id, new_status, total);
});

<What's next />

On the roadmap

WPSignal is actively developed. Here's what's planned next.

  1. WordPress RTC Integration

    Complete

    WPSignal as a Tier 3 WebSocket sync provider for WordPress collaborative editing, powered by Yjs.

  2. WP Plugin Repository Submission

    Complete

    WordSocket is live on the WordPress.org plugin directory. Install it directly from WP Admin or via WP-CLI.

  3. ShopSocket WordPress Plugin Submission

    In progress

    ShopSocket is a WordPress plugin that adds realtime overview of shoppers on your WooCommerce store and inventory updates to your users.

  4. E2E Encryption

    Paused

    WPSignal currently supports blind-relay encryption, WPSignal only ever sees ciphertext. Soon E2E encryption will be supported.

  5. Hub and Spoke

    Planned

    One primary WordPress site dispatches events; connected child sites consume them. Cross-site event routing without duplication.

  6. Shared Worker (Connection Multiplexing)

    Planned

    Allow multiple single user connections to be multiplexed through a single shared worker.

Ready to go realtime?

Free during beta. No credit card required. Sign up, connect your site, and push your first event in minutes.

Get started free Getting started guide