Feature: add Equalize Digital tab to WP 7.0+ Plugins screen

admin/class-admin.php

@@ -14,6 +14,7 @@
 use EqualizeDigital\AccessibilityChecker\Admin\Upgrade_Promotion;
 use EqualizeDigital\AccessibilityChecker\Admin\Admin_Footer_Text;
 use EqualizeDigital\AccessibilityChecker\Admin\Activation_Redirect;
+use EqualizeDigital\AccessibilityChecker\Admin\Plugin_List_Tab;
 
 if ( ! defined( 'ABSPATH' ) ) {
 	exit;
@@ -80,6 +81,9 @@ public function init(): void {
 		$plugin_row_meta = new Plugin_Row_Meta();
 		$plugin_row_meta->init_hooks();
 
+		$plugin_list_tab = new Plugin_List_Tab();
+		$plugin_list_tab->init_hooks();
+
 		$admin_footer_text = new Admin_Footer_Text();
 		$admin_footer_text->init();
 

admin/class-plugin-list-tab.php

@@ -0,0 +1,124 @@
+<?php
+/**
+ * Plugin List Tab class file for the Accessibility Checker plugin.
+ *
+ * @package Accessibility_Checker
+ */
+
+namespace EqualizeDigital\AccessibilityChecker\Admin;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Registers an "Equalize Digital" tab on the WordPress Plugins screen.
+ *
+ * The tab appears when 2 or more Equalize Digital plugins are installed,
+ * using the plugins_list and plugins_list_status_text filters added in WP 7.0.
+ *
+ * @since 1.43.0
+ */
+class Plugin_List_Tab {
+
+	/**
+	 * Minimum number of Equalize Digital plugins required to show the tab.
+	 *
+	 * @var int
+	 */
+	const MINIMUM_FOR_TAB = 2;
+
+	/**
+	 * The status slug used for the Equalize Digital tab.
+	 *
+	 * @var string
+	 */
+	const STATUS_SLUG = 'equalize-digital';
+
+	/**
+	 * Initialize hooks.
+	 *
+	 * @since 1.43.0
+	 *
+	 * @return void
+	 */
+	public function init_hooks(): void {
+		global $wp_version;
+
+		if ( \version_compare( $wp_version, '7.0-alpha0', '<' ) ) {
+			return;
+		}
+
+		add_filter( 'plugins_list', [ $this, 'filter_plugins_list' ] );
+		add_filter( 'plugins_list_status_text', [ $this, 'get_status_text' ], 10, 3 );
+	}
+
+	/**
+	 * Filters the plugins list to add an Equalize Digital group.
+	 *
+	 * Only adds the group when 2 or more Equalize Digital plugins are installed.
+	 *
+	 * @since 1.43.0
+	 *
+	 * @param array<string, array<string, array<string, string>>> $plugins The plugins list keyed by status.
+	 *
+	 * @return array<string, array<string, array<string, string>>> The filtered plugins list.
+	 */
+	public function filter_plugins_list( $plugins ) {
+		if ( ! \is_array( $plugins ) || ! isset( $plugins['all'] ) || ! \is_array( $plugins['all'] ) ) {
+			return $plugins;
+		}
+
+		$equalize_digital_plugins = [];
+		foreach ( $plugins['all'] as $plugin_file => $plugin_data ) {
+			if ( $this->is_equalize_digital_plugin( $plugin_data ) ) {
+				$equalize_digital_plugins[ $plugin_file ] = $plugin_data;
+			}
+		}
+
+		if ( \count( $equalize_digital_plugins ) < self::MINIMUM_FOR_TAB ) {
+			return $plugins;
+		}
+
+		$plugins[ self::STATUS_SLUG ] = $equalize_digital_plugins;
+
+		return $plugins;
+	}
+
+	/**
+	 * Returns the label text for the Equalize Digital tab.
+	 *
+	 * @since 1.43.0
+	 *
+	 * @param string $text  The current status text.
+	 * @param int    $count The number of plugins with this status.
+	 * @param string $type  The status type slug.
+	 *
+	 * @return string The status text.
+	 */
+	public function get_status_text( $text, $count, $type ) {
+		if ( self::STATUS_SLUG !== $type ) {
+			return $text;
+		}
+
+		// translators: %s: Number of plugins.
+		return \_nx( 'Equalize Digital <span class="count">(%s)</span>', 'Equalize Digital <span class="count">(%s)</span>', $count, 'plugin status', 'accessibility-checker' );
+	}
+
+	/**
+	 * Determines whether a plugin belongs to Equalize Digital.
+	 *
+	 * @since 1.43.0
+	 *
+	 * @param array<string, string> $plugin_data The plugin header data.
+	 *
+	 * @return bool
+	 */
+	private function is_equalize_digital_plugin( $plugin_data ): bool {
+		if ( ! \is_array( $plugin_data ) || empty( $plugin_data['AuthorURI'] ) ) {
+			return false;
+		}
+
+		return false !== \stripos( $plugin_data['AuthorURI'], 'equalizedigital.com' );
+	}
+}