WordPress plugin to disable irrelevant Health Checks when managing your codebase with Composer
Find a file
2025-12-12 04:45:46 -06:00
.github Fixed links in copilot instructions 2025-12-12 04:35:28 -06:00
.vscode Pushed new requirements 2025-12-07 02:56:35 -06:00
src Code cleanup and better tests 2025-12-12 03:43:21 -06:00
tests Refactored tests and made phpcs check all files against PSR-12 with targeted exceptions 2025-12-12 04:10:56 -06:00
.editorconfig Code cleanup and better tests 2025-12-12 03:43:21 -06:00
.gitignore Code cleanup and better tests 2025-12-12 03:43:21 -06:00
composer.json Bumped version to 2.0.0 2025-12-12 04:45:46 -06:00
composer.lock Refactored code and added unit tests 2025-12-12 01:26:24 -06:00
disable-wp-health-checks-composer.php Bumped version to 2.0.0 2025-12-12 04:45:46 -06:00
index.php Code cleanup and better tests 2025-12-12 03:43:21 -06:00
LICENSE Initial commit 2025-12-06 20:00:14 -06:00
phpcs.xml.dist Refactored tests and made phpcs check all files against PSR-12 with targeted exceptions 2025-12-12 04:10:56 -06:00
phpstan.neon.dist Code cleanup and better tests 2025-12-12 03:43:21 -06:00
phpunit.xml.dist Refactored code and added unit tests 2025-12-12 01:26:24 -06:00
README.md Updated readme file 2025-12-12 04:33:10 -06:00

Disable WordPress health checks for Composer projects

Small MU-plugin that disables specific WordPress Site Health checks for projects managed with Composer.

Features

  • Disables the Background Updates Site Health test which is unnecessary in Composer-managed deployments.

Installation

Install dependencies and project packages with Composer:

composer require curtistinkers/disable-wp-health-checks-composer

The package is a Composer wordpress-muplugin type; how it is installed into mu-plugins depends on your project installer configuration.

There is no runtime configuration — the plugin runs when loaded and filters the site_status_tests hook.

Usage

No runtime configuration is required. The plugin unsets async.background_updates so the Background Updates health test does not appear in Site Health.

Development & Testing

  • PHP: >=8.2 (see composer.json).
  • Run code style checks: composer run lint
  • Run static analysis: composer run phpstan
  • Run tests: composer run test
  • Get coverage: composer run coverage

CI is defined in .github/workflows/ci.yml and runs on PHP 8.28.5.

Contributing

Contributions should be small and focused. Follow the repository coding standards (WPCS) and run the static checks before opening a PR.