*/ namespace RankMath\Abilities\Settings; use RankMath\Status\System_Status; defined( 'ABSPATH' ) || exit; /** * Registers and executes the rank-math/get-system-status ability. * * Delegates entirely to System_Status::get_json_data() which already * collects Rank Math health data and WordPress core / server info. */ class Get_System_Status extends Abstract_Ability { /** * Constructor. * * @param string $category Ability category slug. * @param array $shared_meta Shared meta args. */ public function __construct( string $category, array $shared_meta ) { parent::__construct( $category, $shared_meta, 'manage_options' ); } /** * Register the ability with the WordPress Abilities API. * * @return void */ public function register(): void { \wp_register_ability( 'rank-math/get-system-status', [ 'category' => $this->category, 'label' => esc_html__( 'Get system status', 'seo-by-rank-math' ), 'description' => esc_html__( 'Returns a structured system health snapshot identical to Status & Tools → System Status in the admin: Rank Math version, plan, DB table health, Google token status, WordPress core info, server environment, and active plugins. Call this alongside get-settings at the start of any AI configuration flow to detect environment issues before making changes.', 'seo-by-rank-math' ), 'input_schema' => [ 'type' => 'object', 'default' => [], ], 'output_schema' => [ 'type' => 'object', 'description' => 'System info sections keyed by section ID (e.g. rank-math, wp-core, wp-server).', ], 'permission_callback' => [ $this, 'check_permissions' ], 'execute_callback' => [ $this, 'execute' ], 'meta' => $this->build_meta( true ), ] ); } /** * Execute the ability. * * @param array $input Ability input arguments. * @return array */ public function execute( array $input = [] ): array { $result = $this->fetch_system_data()['systemInfo']; rank_math()->tracking->track_ability_executed( 'System Status Fetched', [], 'manage_options' ); return $result; } /** * Fetch raw data from System_Status. Extracted for testability. * * @return array */ protected function fetch_system_data(): array { return System_Status::get_json_data(); } }