Web Worker Offloading: Add sunset notice in plugin row

westonruter · gemini-code-assist[bot] · westonruter · commit ac38e3251e2d · 2026-02-26T13:29:45.000-08:00
This notice informs users that the plugin is proposed for being sunset and encourages them to share INP metrics in the support forum.

Co-authored-by: gemini-cli &lt;176961590+gemini-code-assist[bot]@users.noreply.github.com&gt;
diff --git a/plugins/web-worker-offloading/helper.php b/plugins/web-worker-offloading/helper.php
@@ -198,3 +198,33 @@ function plwwo_render_generator_meta_tag(): void {
 	// Use the plugin slug as it is immutable.
 	echo '<meta name="generator" content="web-worker-offloading ' . esc_attr( WEB_WORKER_OFFLOADING_VERSION ) . '">' . "\n";
 }
+
+/**
+ * Displays a sunset warning notice for the plugin in the plugin row meta.
+ *
+ * @since n.e.x.t
+ * @access private
+ *
+ * @param string $plugin_file Path to the plugin file relative to the plugins directory.
+ */
+function plwwo_render_sunset_notice( string $plugin_file ): void {
+	if ( 'web-worker-offloading/load.php' !== $plugin_file ) {
+		return;
+	}
+
+	$message = sprintf(
+		/* translators: 1: GitHub issue URL. 2: Support forum URL. */
+		__( 'The Web Worker Offloading plugin is proposed for being sunset. Please refer to the <a href="%1$s" target="_blank" rel="noopener">GitHub issue</a> for more information. If you have metrics showing how this plugin specifically improved your Interaction to Next Paint (INP), please share them in the <a href="%2$s" target="_blank" rel="noopener">support forum</a> as this could provide a reason to keep the plugin.', 'web-worker-offloading' ),
+		esc_url( 'https://github.com/WordPress/performance/issues/2284' ),
+		esc_url( 'https://wordpress.org/support/plugin/web-worker-offloading/' )
+	);
+	?>
+	<div class="notice inline notice-warning notice-alt">
+		<p>
+			<?php
+			echo wp_kses_post( $message );
+			?>
+		</p>
+	</div>
+	<?php
+}
diff --git a/plugins/web-worker-offloading/hooks.php b/plugins/web-worker-offloading/hooks.php
@@ -15,4 +15,5 @@
 add_filter( 'script_loader_tag', 'plwwo_update_script_type', 10, 2 );
 add_filter( 'wp_inline_script_attributes', 'plwwo_filter_inline_script_attributes' );
 add_action( 'wp_head', 'plwwo_render_generator_meta_tag' );
+add_action( 'after_plugin_row_meta', 'plwwo_render_sunset_notice' );
 // @codeCoverageIgnoreEnd
diff --git a/plugins/web-worker-offloading/tests/test-web-worker-offloading.php b/plugins/web-worker-offloading/tests/test-web-worker-offloading.php
@@ -396,4 +396,33 @@ public function test_plwwo_load_third_party_integrations(): void {
 		$this->assertFalse( function_exists( 'plwwo_rank_math_configure' ) );
 		$this->assertFalse( function_exists( 'plwwo_woocommerce_configure' ) );
 	}
+
+	/**
+	 * Test the sunset notice hook.
+	 *
+	 * @covers ::plwwo_render_sunset_notice
+	 */
+	public function test_plwwo_render_sunset_notice_hook(): void {
+		$this->assertEquals( 10, has_action( 'after_plugin_row_meta', 'plwwo_render_sunset_notice' ) );
+	}
+
+	/**
+	 * Test rendering the sunset notice.
+	 *
+	 * @covers ::plwwo_render_sunset_notice
+	 */
+	public function test_plwwo_render_sunset_notice_rendering(): void {
+		$plugin_file = 'web-worker-offloading/load.php';
+
+		$output = get_echo( 'plwwo_render_sunset_notice', array( $plugin_file ) );
+
+		$this->assertStringContainsString( 'notice-warning', $output );
+		$this->assertStringContainsString( 'The Web Worker Offloading plugin is proposed for being sunset.', $output );
+		$this->assertStringContainsString( 'Interaction to Next Paint (INP)', $output );
+		$this->assertStringContainsString( 'https://wordpress.org/support/plugin/web-worker-offloading/', $output );
+
+		// Test with different plugin file.
+		$output = get_echo( 'plwwo_render_sunset_notice', array( 'other-plugin/load.php' ) );
+		$this->assertEmpty( $output );
+	}
 }
