boxybird/pulsar

Pulsar integrates Server-Sent Events (SSE) into WordPress using Datastar, enabling real-time data streaming.

dev-main 2025-01-22 05:14 UTC

Requires

• php: >=8.2
• starfederation/datastar-php: dev-main

MIT

• Andrew Rhyand

• php
• plugin
• wordpress
• Server-Sent Events
• Datastar

README

Pulsar integrates Server-Sent Events (SSE) into WordPress using Datastar, enabling real-time data streaming.

Installation

cd wp-content/plugins
git clone https://github.com/boxybird/pulsar
cd pulsar
composer install

Location: /wp-admin/plugins.php

Activate plugin

Location: /wp-admin/options-permalink.php

Visit and refresh permalinks by clicking "Save Changes" button

Important

By default, this package pre-bundles the Datastar library. If you site already has Datastar installed, you should dequeue this packages version to avoid conflicts.

Location: /your-theme/functions.php

add_action('wp_enqueue_scripts', function () {
    wp_dequeue_script('pulsar-datastar-script');
});

Usage

<button data-on-click="@get('/pulsar/v1/handle')">GET REQUEST</button>
<div id="random"></div>

add_action('pulsar/get', function (starfederation\datastar\ServerSentEventGenerator $sse, array $params) {
    $sse->mergeFragments('<div id="random">'.random_int(1, 10000).'</div>');
}, 10, 2);

<button data-on-click="@get('/pulsar/v1/handle@foobar')">GET REQUEST - @FOOBAR</button>
<div id="random"></div>

add_action('pulsar/get@foobar', function (starfederation\datastar\ServerSentEventGenerator $sse, array $params) {
    $sse->mergeFragments('<div id="random">'.random_int(1, 10000).'</div>');
}, 10, 2);

<button data-on-click="@post('/pulsar/v1/handle')">POST REQUEST</button>
<div id="random"></div>

add_action('pulsar/post', function (starfederation\datastar\ServerSentEventGenerator $sse, array $params) {
    for ($i = 0; $i < 10; $i++) {
        $sse->mergeFragments('<div id="random">'.random_int(1, 10000).'</div>');

        usleep(10000);
    }
}, 10, 2);

<button data-on-click="@put('/pulsar/v1/handle')">PUT</button>
<button data-on-click="@patch('/pulsar/v1/handle')">PATCH</button>
<button data-on-click="@delete('/pulsar/v1/handle')">DELETE</button>

add_action('pulsar/put', ...);
add_action('pulsar/patch', ...);
add_action('pulsar/delete', ...);

Reference

https://github.com/starfederation/datastar-php