apermo/site-bookkeeper-dashboard

A WordPress site-bookkeeper-dashboard plugin.

v0.1.1 2026-04-04 14:03 UTC

Requires

• php: >=8.2

Requires (Dev)

• apermo/apermo-coding-standards: ^2.0
• apermo/phpstan-wordpress-rules: ^0.2
• brain/monkey: ^2.6
• php-stubs/wp-cli-stubs: ^2.12
• phpstan/extension-installer: ^1.4
• phpunit/phpunit: ^11.0
• szepeviktor/phpstan-wordpress: ^2.0
• yoast/phpunit-polyfills: ^3.0

GPL-2.0-or-later

• Christoph Daum

README

A monitoring tool for your WordPress Sites — Dashboard Plugin

WordPress admin dashboard for viewing site health data from a central Site Bookkeeper Hub. Provides an at-a-glance overview of all monitored sites, their plugin/theme update status, and cross-site reports.

Requirements

• PHP 8.2+
• WordPress 6.2+
• A running Site Bookkeeper Hub instance with a client token
• One or more sites using the Site Bookkeeper Reporter plugin to push data to the hub

Installation

Install via Composer:

composer require apermo/site-bookkeeper-dashboard

Activate the plugin and configure in Settings > Site Bookkeeper Dashboard, or define constants in wp-config.php:

define( 'SITE_BOOKKEEPER_HUB_URL', 'https://monitor.example.tld' );
define( 'SITE_BOOKKEEPER_CLIENT_TOKEN', 'your-client-token-here' );

Security

The plugin enforces HTTPS for all communication with the hub. Both the settings page and the API client will reject plain HTTP URLs.

For local development you can opt out by defining the following constant in wp-config.php:

define( 'SITE_BOOKKEEPER_ALLOW_HTTP', true );

Features

Sites Overview

WP_List_Table with sortable columns: site URL, WordPress version, PHP version, pending plugin/theme updates, last seen, stale indicator. Stale sites (no report in 48h) are highlighted.

Site Detail

Full report for a single site: environment info, plugins with versions and update status, themes, users with roles and meta (e.g. 2FA status), custom fields with status badges.

Cross-Site Reports

Plugin-centric and theme-centric views showing which versions are installed across all sites, with an "outdated only" filter.

Network Views (Multisite)

Networks overview listing all multisite networks with subsite count. Network detail view showing network-activated plugins, super admins, network settings, and linked subsites.

WP-CLI Commands

wp bookkeeper-dashboard sites                # List all monitored sites
wp bookkeeper-dashboard site <id>            # Full detail for a single site
wp bookkeeper-dashboard plugins              # Cross-site plugin report
wp bookkeeper-dashboard plugins --outdated   # Only plugins with pending updates
wp bookkeeper-dashboard themes               # Cross-site theme report
wp bookkeeper-dashboard themes --outdated    # Only themes with pending updates
wp bookkeeper-dashboard networks             # List all networks
wp bookkeeper-dashboard network <id>         # Full network detail
wp bookkeeper-dashboard test                 # Test connection to the hub

All commands support --format=table|csv|json|yaml.

Development

composer install
composer cs              # Run PHPCS
composer cs:fix          # Fix PHPCS violations
composer analyse         # Run PHPStan
composer test:unit       # Run unit tests

License

GPL-2.0-or-later