Fetch known-plugins.json from wp.org with daily refresh

Adds a Known_Plugins loader that caches a remote copy of the mapping
and falls back to the bundled JSON. A daily WP-Cron event refreshes
the cache from https://ps.w.org/aaa-option-optimizer/assets/known-plugins.json.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: ilicfilip

aaa-option-optimizer.php

@@ -37,6 +37,11 @@ function aaa_option_optimizer_activation() {
 	// Create the custom table.
 	Progress_Planner\OptionOptimizer\Database::create_table();
 
+	// Schedule daily refresh of the known-plugins mapping.
+	if ( ! wp_next_scheduled( Progress_Planner\OptionOptimizer\Known_Plugins::CRON_HOOK ) ) {
+		wp_schedule_event( time(), 'daily', Progress_Planner\OptionOptimizer\Known_Plugins::CRON_HOOK );
+	}
+
 	$autoload_values = \wp_autoload_values_to_autoload();
 	$placeholders    = implode( ',', array_fill( 0, count( $autoload_values ), '%s' ) );
 
@@ -73,6 +78,8 @@ function aaa_option_optimizer_activation() {
 function aaa_option_optimizer_deactivation() {
 	$aaa_option_value = get_option( 'option_optimizer' );
 	update_option( 'option_optimizer', $aaa_option_value, false );
+
+	wp_clear_scheduled_hook( Progress_Planner\OptionOptimizer\Known_Plugins::CRON_HOOK );
 }
 
 /**

src/class-known-plugins.php

@@ -0,0 +1,98 @@
+<?php
+/**
+ * Loader for the known-plugins mapping.
+ *
+ * @package Progress_Planner\OptionOptimizer
+ */
+
+namespace Progress_Planner\OptionOptimizer;
+
+/**
+ * Class Known_Plugins
+ *
+ * Fetches the latest known-plugins.json from wp.org and caches it locally.
+ * Falls back to the JSON file bundled with the plugin when no fresh remote
+ * copy is available.
+ */
+class Known_Plugins {
+
+	const REMOTE_URL = 'https://ps.w.org/aaa-option-optimizer/assets/known-plugins.json';
+	const CACHE_KEY  = 'aaa_option_optimizer_known_plugins';
+	const CRON_HOOK  = 'aaa_option_optimizer_refresh_known_plugins';
+
+	/**
+	 * In-memory cache for the current request.
+	 *
+	 * @var array<string, array<string, mixed>>|null
+	 */
+	private $list;
+
+	/**
+	 * Get the known-plugins mapping.
+	 *
+	 * @return array<string, array<string, mixed>>
+	 */
+	public function get(): array {
+		if ( null !== $this->list ) {
+			return $this->list;
+		}
+
+		$cached = \get_option( self::CACHE_KEY );
+		if ( \is_array( $cached ) && ! empty( $cached ) ) {
+			$this->list = $cached;
+			return $this->list;
+		}
+
+		$this->list = $this->load_bundled();
+		return $this->list;
+	}
+
+	/**
+	 * Refresh the cached mapping from the remote URL.
+	 *
+	 * @return bool True when a fresh copy was stored, false otherwise.
+	 */
+	public function refresh(): bool {
+		$response = \wp_remote_get(
+			self::REMOTE_URL,
+			[
+				'timeout' => 10,
+			]
+		);
+
+		if ( \is_wp_error( $response ) ) {
+			return false;
+		}
+
+		if ( 200 !== \wp_remote_retrieve_response_code( $response ) ) {
+			return false;
+		}
+
+		$body = \wp_remote_retrieve_body( $response );
+		$data = \json_decode( $body, true );
+
+		if ( ! \is_array( $data ) || empty( $data ) ) {
+			return false;
+		}
+
+		\update_option( self::CACHE_KEY, $data, false );
+		$this->list = $data;
+		return true;
+	}
+
+	/**
+	 * Load the JSON file bundled with the plugin.
+	 *
+	 * @return array<string, array<string, mixed>>
+	 */
+	private function load_bundled(): array {
+		$path = \plugin_dir_path( AAA_OPTION_OPTIMIZER_FILE ) . 'known-plugins/known-plugins.json';
+		if ( ! \file_exists( $path ) ) {
+			return [];
+		}
+
+		// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- Reading a file bundled with the plugin.
+		$data = \json_decode( (string) \file_get_contents( $path ), true );
+		return \is_array( $data ) ? $data : [];
+	}
+}

src/class-map-plugin-to-options.php

@@ -16,7 +16,7 @@ class Map_Plugin_To_Options {
 	/**
 	 * List of plugins we can recognize.
 	 *
-	 * @var object[]
+	 * @var array<string, array<string, mixed>>
 	 */
 	private $plugins_list = [];
 
@@ -28,9 +28,9 @@ class Map_Plugin_To_Options {
 	 * @return string
 	 */
 	public function get_plugin_name( string $option ): string {
-		$plugins_list = [];
 		if ( empty( $this->plugins_list ) ) {
-			$this->plugins_list = json_decode( file_get_contents( plugin_dir_path( AAA_OPTION_OPTIMIZER_FILE ) . 'known-plugins/known-plugins.json' ), true );
+			$known              = new Known_Plugins();
+			$this->plugins_list = $known->get();
 		}
 
 		// for each plugin in the list, check if the option starts with the prefix.

src/class-plugin.php

@@ -79,6 +79,12 @@ public function register_hooks() {
 		// Use the shutdown action to update the option with tracked data.
 		\add_action( 'shutdown', [ $this, 'update_tracked_options' ] );
 
+		// Daily refresh of the known-plugins mapping.
+		\add_action( Known_Plugins::CRON_HOOK, [ $this, 'refresh_known_plugins' ] );
+		if ( ! \wp_next_scheduled( Known_Plugins::CRON_HOOK ) ) {
+			\wp_schedule_event( \time(), 'daily', Known_Plugins::CRON_HOOK );
+		}
+
 		// Register the REST routes.
 		$rest = new REST();
 		$rest->register_hooks();
@@ -160,6 +166,15 @@ protected function add_option_usage( $option_name ) {
 		++$this->accessed_options[ $option_name ];
 	}
 
+	/**
+	 * Refresh the cached known-plugins mapping from wp.org.
+	 *
+	 * @return void
+	 */
+	public function refresh_known_plugins() {
+		( new Known_Plugins() )->refresh();
+	}
+
 	/**
 	 * Update the tracked options at the end of the page load.
 	 *