apply_filters( ‘site_status_tests’, array[] $tests )

Filters which site status tests are run on a site.

Description

The site health is determined by a set of tests based on best practices from both the WordPress Hosting Team and web standards in general.

Some sites may not have the same requirements, for example the automatic update checks may be handled by a host, and are therefore disabled in core.
Or maybe you want to introduce a new test, is caching enabled/disabled/stale for example.

Tests may be added either as direct, or asynchronous ones. Any test that may require some time to complete should run asynchronously, to avoid extended loading periods within wp-admin.

Parameters

$testsarray[]
An associative array of direct and asynchronous tests.
  • direct array[]
    An array of direct tests.
    • ...$identifier array
      $identifier should be a unique identifier for the test. Plugins and themes are encouraged to prefix test identifiers with their slug to avoid collisions between tests.
      • label string
        The friendly label to identify the test.
      • test callable
        The callback function that runs the test and returns its result.
      • skip_cron bool
        Whether to skip this test when running as cron.
        }
    • async array[]
      An array of asynchronous tests.
      • ...$identifier array
        $identifier should be a unique identifier for the test. Plugins and themes are encouraged to prefix test identifiers with their slug to avoid collisions between tests.
        • label string
          The friendly label to identify the test.
        • test string
          An admin-ajax.php action to be called to perform the test, or if $has_rest is true, a URL to a REST API endpoint to perform the test.
        • has_rest bool
          Whether the $test property points to a REST API endpoint.
        • skip_cron bool
          Whether to skip this test when running as cron.
        • async_direct_test callable
          A manner of directly calling the test marked as asynchronous, as the scheduled event can not authenticate, and endpoints may require authentication.
          }

Source

$tests = apply_filters( 'site_status_tests', $tests );

Changelog

VersionDescription
5.6.0Added the async_direct_test array key for asynchronous tests.
Added the skip_cron array key for all tests.
5.2.0Introduced.

User Contributed Notes

  1. Skip to note 4 content

    Example usage to remove a test:

    function remove_background_updates_test( $tests ) {
    	unset( $tests['async']['background_updates'] );
    	return $tests;
    }
    add_filter( 'site_status_tests', 'remove_background_updates_test' );

    Also check out the Site Health Manager plugin that allows you to easily remove custom status test using this hook.

  2. Skip to note 6 content

    Here’s a quick one-liner to disable 3 Site Health tests that tend to be false alarms. You can drop it into a plugin or your theme’s functions.php.

    • PHP version (which is outside of user control anyway)
    • theme version (complains when it doesn’t find one of the WordPress twenty**** themes)
    • background updates (complains when you have a .git directory in your site root, for example)
    add_filter('site_status_tests', function (array $test_type) {
      unset($test_type['direct']['php_version'],
        $test_type['direct']['theme_version'],
        $test_type['async']['background_updates']);
      return $test_type;
    }, 10, 1);

You must log in before being able to contribute a note or feedback.