initial

wp-content/plugins/jetpack/_inc/lib/debugger/debug-functions.php

@@ -0,0 +1,125 @@
+<?php
+/**
+ * WP Site Health debugging functions.
+ *
+ * @deprecated 15.9 Site Health integration is now handled by the connection package.
+ * @package automattic/jetpack
+ */
+
+/**
+ * Test runner for Core's Site Health module.
+ *
+ * @since 7.3.0
+ * @deprecated 15.9 Use Automattic\Jetpack\Connection\Site_Health instead.
+ */
+function jetpack_debugger_ajax_local_testing_suite() {
+	_deprecated_function( __FUNCTION__, 'jetpack-15.9' );
+	check_ajax_referer( 'health-check-site-status' );
+	if ( ! current_user_can( 'jetpack_manage_modules' ) ) {
+		// @phan-suppress-next-line PhanTypeMismatchArgumentProbablyReal -- It takes null, but its phpdoc only says int.
+		wp_send_json_error( null, null, JSON_UNESCAPED_SLASHES );
+	}
+	$tests = new Automattic\Jetpack\Connection\Connection_Health_Tests();
+	// @phan-suppress-next-line PhanTypeMismatchArgumentProbablyReal -- It takes null, but its phpdoc only says int.
+	wp_send_json_success( $tests->output_results_for_core_async_site_health(), null, JSON_UNESCAPED_SLASHES );
+}
+/**
+ * Adds the Jetpack Local Testing Suite to the Core Site Health system.
+ *
+ * @since 7.3.0
+ * @deprecated 15.9 Use Automattic\Jetpack\Connection\Site_Health instead.
+ *
+ * @param array $core_tests Array of tests from Core's Site Health.
+ *
+ * @return array $core_tests Array of tests for Core's Site Health.
+ */
+function jetpack_debugger_site_status_tests( $core_tests ) {
+	_deprecated_function( __FUNCTION__, 'jetpack-15.9' );
+	$cxn_tests = new Automattic\Jetpack\Connection\Connection_Health_Tests();
+	$tests     = $cxn_tests->list_tests( 'direct' );
+	foreach ( $tests as $test ) {
+
+		$core_tests['direct'][ $test['name'] ] = array(
+			'label' => __( 'Jetpack: ', 'jetpack' ) . $test['name'],
+			/**
+			 * Callable for Core's Site Health system to execute.
+			 *
+			 * @var array $test A Jetpack Testing Suite test array.
+			 * @var Automattic\Jetpack\Connection\Connection_Health_Tests $cxn_tests An instance of the connection test suite.
+			 *
+			 * @return array {
+			 *      A results array to match the format expected by WordPress Core.
+			 *
+			 *      @type string $label Name for the test.
+			 *      @type string $status 'critical', 'recommended', or 'good'.
+			 *      @type array $badge Array for Site Health status. Keys label and color.
+			 *      @type string $description Description of the test result.
+			 *      @type string $action HTML to a link to resolve issue.
+			 *      @type string $test Unique test identifier.
+			 *  }
+			 */
+			'test'  => function () use ( $test, $cxn_tests ) {
+				$results = $cxn_tests->run_test( $test['name'] );
+				if ( is_wp_error( $results ) ) {
+					return;
+				}
+
+				$label = $results['label'] ?
+					$results['label'] :
+					ucwords(
+						str_replace(
+							'_',
+							' ',
+							str_replace( 'test__', '', $test['name'] )
+						)
+					);
+				if ( $results['long_description'] ) {
+					$description = $results['long_description'];
+				} elseif ( $results['short_description'] ) {
+					$description = sprintf(
+						'<p>%s</p>',
+						$results['short_description']
+					);
+				} else {
+					$description = sprintf(
+						'<p>%s</p>',
+						__( 'This test successfully passed!', 'jetpack' )
+					);
+				}
+
+				$return = array(
+					'label'       => $label,
+					'status'      => 'good',
+					'badge'       => array(
+						'label' => __( 'Jetpack', 'jetpack' ),
+						'color' => 'green',
+					),
+					'description' => $description,
+					'actions'     => '',
+					'test'        => 'jetpack_' . $test['name'],
+				);
+
+				if ( false === $results['pass'] ) {
+					$return['status'] = $results['severity'];
+					if ( ! empty( $results['action'] ) ) {
+						$return['actions'] = sprintf(
+							'<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',
+							esc_url( $results['action'] ),
+							$results['action_label'],
+							/* translators: accessibility text */
+							__( '(opens in a new tab)', 'jetpack' )
+						);
+					}
+				}
+
+				return $return;
+			},
+		);
+	}
+	$core_tests['async']['jetpack_test_suite'] = array(
+		'label' => __( 'Jetpack Tests', 'jetpack' ),
+		'test'  => 'jetpack_local_testing_suite',
+	);
+
+	return $core_tests;
+}