automattic/jetpack-scan-page

Scan UI for the Jetpack plugin in wp-admin.

dev-trunk / 0.2.x-dev 2026-05-07 02:27 UTC

Requires

• php: >=7.2
• automattic/jetpack-admin-ui: ^0.8.2
• automattic/jetpack-assets: ^4.3.34
• automattic/jetpack-autoloader: ^5.0.17
• automattic/jetpack-composer-plugin: ^4.0.6
• automattic/jetpack-connection: ^8.3.3
• automattic/jetpack-status: ^6.1.3
• automattic/jetpack-wp-build-polyfills: ^0.1.7-alpha

Requires (Dev)

• automattic/jetpack-changelogger: ^6.0.14
• automattic/jetpack-test-environment: @dev
• automattic/phpunit-select-config: ^1.0.5
• yoast/phpunit-polyfills: ^4.0.0

Suggests

• automattic/jetpack-autoloader: Allow for better interoperability with other plugins that use this package.

GPL-2.0-or-later

README

This package hosts the wp-admin Scan UI for the Jetpack plugin. It ports Calypso's Scan dashboard (client/dashboard/sites/scan/) onto a native wp-admin page so customers see active threats, scan history, and the fix / ignore / view-details flows without leaving their site.

The package mirrors the architecture of projects/packages/activity-log/ and projects/packages/backup/: a TanStack Query data layer, a hash router, an AdminPage shell, and @wordpress/dataviews lists.

Architecture

• src/class-jetpack-scan.php — wp-admin submenu under Jetpack (?page=jetpack-scan), asset enqueue, REST registration.
• src/class-initial-state.php — JPSCAN_INITIAL_STATE hydration global.
• src/class-rest-controller.php — jetpack/v4/site/scan/* bridges proxied to WPCOM via the site's Jetpack connection.
• src/js/admin.tsx — createHashRouter + RouterProvider.
• src/js/shell.tsx — AdminPage chrome + HeaderActionsProvider + Outlet.
• src/js/providers.tsx — QueryClient + ThemeProvider.
• src/js/gates.tsx — connection / capabilities gates with mock-mode short-circuit.

Mock mode

Append ?jps-mock=1 to the wp-admin URL to short-circuit every gate and render the overview against fixtures. No server requests are made.