README

Adds live auto-refresh capability to the SilverStripe Queued Jobs admin panel.

Demo

Features

Play/pause toggle button positioned next to the filter button
Auto-refresh every 5 seconds without full page reload
Minimal DOM updates using intelligent diffing (only changed cells are updated, no false positives from action buttons)
Subtle refresh indicator in the button icon (no intrusive popups)
Preserves scroll position and focus state
Smart pausing (10 seconds) on user interaction
Session timeout detection and handling
Network error handling with notifications
Button persists through DOM updates (MutationObserver ensures it remains available)
Progressive enhancement (graceful degradation when JavaScript is disabled)
Comprehensive automated test coverage (Jest + PHPUnit)

Installation

composer require edwilde/silverstripe-queuedjobs-live

Usage

Once installed, the Queued Jobs admin panel will automatically include a play/pause button positioned to the left of the "Filter" button. Click it to enable automatic refreshing of the jobs grid every 5 seconds.

The button uses a subtle outline style and shows a spinning refresh icon while updating.

Development

# Install dependencies
npm install

# Build for development
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Run tests in watch mode
npm run test:js:watch

# Lint code
npm run lint

Requirements

SilverStripe Framework ^4.0 || ^5.0
symbiote/silverstripe-queuedjobs ^4.0 || ^5.0

License

BSD-3-Clause

edwilde / silverstripe-queuedjobs-live

Maintainers

Details