Update changelog for version 1.5.0

.github/workflows/release.yml

@@ -28,6 +28,7 @@ jobs:
           cp readme.txt build/fix-plugin-does-not-exist-notices/
           cp LICENSE build/fix-plugin-does-not-exist-notices/
           cp README.md build/fix-plugin-does-not-exist-notices/
+          cp -r assets build/fix-plugin-does-not-exist-notices/
 
       - name: Create ZIP file
         run: |

CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.0] - 2024-05-15
+### Added
+- Improved compatibility with WordPress 6.4
+- Enhanced error detection for plugin references
+
+### Fixed
+- Minor UI improvements for better visibility
+- Accessibility enhancements for screen readers
+
+## [1.4.1] - 2023-11-30
+### Added
+- FAQ about keeping the plugin installed after notices are cleared
+
 ## [1.4.0] - 2023-11-30
 ### Changed
 - Updated plugin name and text domain

README.md

@@ -76,6 +76,22 @@ The plugin entry will be removed from your active plugins list, and the correspo
 
 Yes, the plugin works on both single sites and multisite installations. It properly handles network-activated plugins as well.
 
+### How do I know which plugin references should be removed?
+
+The plugin will only show "Remove Reference" links for plugins that are listed in your database but don't actually exist in your plugins directory. These are safe to remove.
+
+### Will this break my site?
+
+No. Since the plugin is only removing references to plugins that no longer exist, removing these references won't affect your site's functionality. In fact, it's cleaning up remnants that might be causing issues.
+
+### What if I accidentally remove a reference I shouldn't have?
+
+If you remove a reference to a plugin that you later want to reinstall, simply install the plugin again and activate it normally.
+
+### Do I need to keep this plugin installed and active after notices are cleared?
+
+Although this plugin consumes minimal disk space, and doesn't run unless you are on the /wp-admin/plugins.php page, you don't need to keep it active or installed if you don't have this notice to clear — but it is safe to, if you just want it as a part of your overall WordPress stack of enhancements and conveniences.
+
 ## Screenshots
 
 1. Error message with explanation notification
@@ -104,6 +120,9 @@ The plugin works by:
 
 ## Changelog
 
+### 1.4.1
+- Added FAQ about keeping the plugin installed after notices are cleared
+
 ### 1.4.0
 - Updated plugin name and text domain
 - Repository rename from plugin-reference-cleaner to fix-plugin-does-not-exist-notices

assets/css/admin-styles.css

@@ -0,0 +1,28 @@
+.prc-notice {
+    border-left: 4px solid #ffba00;
+    background-color: #fff8e5;
+    padding: 10px 12px;
+    margin: 5px 0 15px;
+    font-size: 14px;
+    position: relative;
+}
+.prc-notice h3 {
+    margin-top: 0;
+    color: #826200;
+}
+.prc-notice::before {
+    content: "";
+    position: absolute;
+    top: -10px;
+    left: 20px;
+    width: 0;
+    height: 0;
+    border-left: 10px solid transparent;
+    border-right: 10px solid transparent;
+    border-bottom: 10px solid #fff8e5;
+}
+
+/* Style for highlighting the missing plugin row */
+tr.inactive.prc-highlight-missing {
+    background-color: #fff8e5 !important; /* Use !important to override default styles */
+}

assets/js/admin-scripts.js

@@ -0,0 +1,81 @@
+(function() {
+    // Function to inject our notice
+    function injectNotice() {
+        // Find all notification containers first
+        var noticeContainers = document.querySelectorAll('.notice, .error, .updated');
+
+        // Find all error notifications about missing plugins
+        noticeContainers.forEach(function(notice) {
+            if (notice.textContent.includes('Plugin file does not exist') ||
+                notice.textContent.includes('has been deactivated due to an error')) {
+
+                // Check if we already added our notice
+                if (notice.nextElementSibling && notice.nextElementSibling.classList.contains('prc-notice')) {
+                    return;
+                }
+
+                // Create our custom notice
+                var ourNotice = document.createElement('div');
+                ourNotice.className = 'prc-notice';
+
+                // Add content (using localized strings passed via wp_localize_script if needed, but simple for now)
+                ourNotice.innerHTML = '<h3 style="margin-top:0;color:#826200;">👉 Fix Plugin Does Not Exist Notices Can Fix This</h3>' +
+                    '<p>To remove the above error notification, scroll down to find the plugin marked with "<strong style="color:red">(File Missing)</strong>" and click its "<strong>Remove Reference</strong>" link.</p>' +
+                    '<p>This will permanently remove the missing plugin reference from your database.</p>' +
+                    '<p><a href="#" id="prc-scroll-to-plugin" style="font-weight:bold;text-decoration:underline;color:#826200;">Click here to scroll to the missing plugin</a></p>';
+
+                // Insert our notice right after the error
+                notice.parentNode.insertBefore(ourNotice, notice.nextSibling);
+
+                // Add scroll behavior
+                var scrollLink = document.getElementById('prc-scroll-to-plugin');
+                if (scrollLink) {
+                    scrollLink.addEventListener('click', function(e) {
+                        e.preventDefault();
+                        var missingPlugins = document.querySelectorAll('tr.inactive:not(.plugin-update-tr)');
+                        for (var i = 0; i < missingPlugins.length; i++) {
+                            if (missingPlugins[i].textContent.includes('(File Missing)')) {
+                                // Add a class for highlighting instead of direct style manipulation
+                                missingPlugins[i].classList.add('prc-highlight-missing');
+                                missingPlugins[i].scrollIntoView({ behavior: 'smooth', block: 'center' });
+                                // Optional: Remove highlight after a delay
+                                setTimeout(function() {
+                                    missingPlugins[i].classList.remove('prc-highlight-missing');
+                                }, 3000); // Remove highlight after 3 seconds
+                                return;
+                            }
+                        }
+                    });
+                }
+            }
+        });
+    }
+
+    // Try to inject notices on multiple events to ensure it works
+    document.addEventListener('DOMContentLoaded', function() {
+        injectNotice();
+
+        // Also set up a MutationObserver to watch for dynamically added notices
+        var observer = new MutationObserver(function(mutations) {
+            mutations.forEach(function(mutation) {
+                if (mutation.addedNodes && mutation.addedNodes.length > 0) {
+                    // Check if added nodes are notices or contain notices
+                    mutation.addedNodes.forEach(function(node) {
+                        if (node.nodeType === 1 && (node.matches('.notice, .error, .updated') || node.querySelector('.notice, .error, .updated'))) {
+                            injectNotice();
+                        }
+                    });
+                }
+            });
+        });
+
+        // Start observing the body for changes in children
+        observer.observe(document.body, { childList: true, subtree: true });
+    });
+
+    // Backup attempt with window.onload (less reliable than DOMContentLoaded but good fallback)
+    window.addEventListener('load', function() {
+        setTimeout(injectNotice, 500); // Delay slightly to ensure dynamic content is loaded
+    });
+
+})();

fix-plugin-does-not-exist-notices.php

@@ -9,8 +9,8 @@
  *
  * @wordpress-plugin
  * Plugin Name: Fix 'Plugin file does not exist.' Notices
- * Description: Adds missing plugins to the plugins list with a "Remove Reference" link so you can clean up invalid plugin entries.
+ * Description: Adds missing plugins to the plugins list with a "Remove Reference" link so you can permanently clean up invalid plugin entries and remove error notices.
- * Version: 1.4.0
+ * Version: 1.5.0
  * Author: Marcus Quinn
  * Author URI: https://www.wpallstars.com
  * License: GPL-2.0+
@@ -34,310 +34,338 @@
  * along with this plugin. If not, see https://www.gnu.org/licenses/gpl-2.0.html.
  */
 
-// Exit if accessed directly
+// Exit if accessed directly.
-if (!defined('ABSPATH')) {
+if ( ! defined( 'ABSPATH' ) ) {
     exit;
 }
 
+/**
+ * Main class for the plugin.
+ */
 class Fix_Plugin_Does_Not_Exist_Notices {
-    public function __construct() {
-        // Add our plugin to the plugins list
-        add_filter('all_plugins', array($this, 'add_missing_plugins_references'));
 
-        // Add our action link to the plugins list
+	/**
-        add_filter('plugin_action_links', array($this, 'add_remove_reference_action'), 20, 4);
+	 * Constructor. Hooks into WordPress actions and filters.
+	 */
+	public function __construct() {
+		// Add our plugin to the plugins list.
+		add_filter( 'all_plugins', array( $this, 'add_missing_plugins_references' ) );
 
-        // Handle the remove reference action
+		// Add our action link to the plugins list.
-        add_action('admin_init', array($this, 'handle_remove_reference'));
+		add_filter( 'plugin_action_links', array( $this, 'add_remove_reference_action' ), 20, 4 );
 
-        // Add admin notices for operation feedback
+		// Handle the remove reference action.
-        add_action('admin_notices', array($this, 'admin_notices'));
+		add_action( 'admin_init', array( $this, 'handle_remove_reference' ) );
-    }
 
-    /**
+		// Add admin notices for operation feedback.
-     * Find and add invalid plugin references to the plugins list
+		add_action( 'admin_notices', array( $this, 'admin_notices' ) );
-     */
-    public function add_missing_plugins_references($plugins) {
-        // Only run on the plugins page
-        if (!$this->is_plugins_page()) {
-            return $plugins;
-        }
 
-        // Get active plugins that don't exist
+		// Enqueue admin scripts and styles.
-        $invalid_plugins = $this->get_invalid_plugins();
+		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );
+	}
 
-        // Add each invalid plugin to the plugin list
+	/**
-        foreach ($invalid_plugins as $plugin_path) {
+	 * Enqueue scripts and styles needed for the admin area.
-            if (!isset($plugins[$plugin_path])) {
+	 *
-                $plugin_name = basename($plugin_path);
+	 * @param string $hook_suffix The current admin page hook.
-                $plugins[$plugin_path] = array(
+	 * @return void
-                    'Name' => $plugin_name . ' <span class="error">(File Missing)</span>',
+	 */
-                    'Description' => 'This plugin file does not exist. You can safely remove this reference.',
+	public function enqueue_admin_assets( $hook_suffix ) {
-                    'Version' => 'N/A',
+		// Only load on the plugins page.
-                    'Author' => '',
+		if ( 'plugins.php' !== $hook_suffix ) {
-                    'PluginURI' => '',
+			return;
-                    'AuthorURI' => '',
+		}
-                    'Title' => $plugin_name . ' (Missing)',
-                    'AuthorName' => ''
-                );
-            }
-        }
 
-        return $plugins;
+		// Get invalid plugins to decide if assets are needed.
-    }
+		$invalid_plugins = $this->get_invalid_plugins();
+		if ( empty( $invalid_plugins ) ) {
+			return; // No missing plugins, no need for the special notice JS/CSS.
+		}
 
-    /**
+		$plugin_url = plugin_dir_url( __FILE__ );
-     * Add the Remove Reference action link to invalid plugins
-     */
-    public function add_remove_reference_action($actions, $plugin_file, $plugin_data, $context) {
-        // Only run on the plugins page
-        if (!$this->is_plugins_page()) {
-            return $actions;
-        }
 
-        // Check if this is a missing plugin
+		wp_enqueue_style(
-        if (isset($plugin_data['Name']) && strpos($plugin_data['Name'], '<span class="error">(File Missing)</span>') !== false) {
+			'fpden-admin-styles',
-            // Clear existing actions
+			$plugin_url . 'assets/css/admin-styles.css',
-            $actions = array();
+			array(),
+			filemtime( plugin_dir_path( __FILE__ ) . 'assets/css/admin-styles.css' ) // Versioning based on file modification time.
+		);
 
-            // Add our action
+		wp_enqueue_script(
-            $nonce = wp_create_nonce('remove_plugin_reference_' . $plugin_file);
+			'fpden-admin-scripts',
-            $remove_url = admin_url('plugins.php?action=remove_reference&plugin=' . urlencode($plugin_file) . '&_wpnonce=' . $nonce);
+			$plugin_url . 'assets/js/admin-scripts.js',
-            $actions['remove_reference'] = '<a href="' . esc_url($remove_url) . '" class="delete" aria-label="' . esc_attr__('Remove Reference', 'fix-plugin-does-not-exist-notices') . '">Remove Reference</a>';
+			array( 'jquery' ), // Add dependencies if needed, e.g., jQuery.
-        }
+			filemtime( plugin_dir_path( __FILE__ ) . 'assets/js/admin-scripts.js' ), // Versioning.
+			true // Load in footer.
+		);
 
-        return $actions;
+		// Optional: Pass localized data to script if needed.
-    }
+		// wp_localize_script('fpden-admin-scripts', 'fpdenData', array(
+		//  'ajax_url' => admin_url('admin-ajax.php'),
+		//  'nonce'    => wp_create_nonce('fpden_ajax_nonce'),
+		// ));
+	}
 
-    /**
+	/**
-     * Handle the remove reference action
+	 * Find and add invalid plugin references to the plugins list.
-     */
+	 *
-    public function handle_remove_reference() {
+	 * Filters the list of plugins displayed on the plugins page to include
-        // Check if we're removing a reference
+	 * entries for active plugins whose files are missing.
-        if (!isset($_GET['action']) || $_GET['action'] !== 'remove_reference' || !isset($_GET['plugin'])) {
+	 *
-            return;
+	 * @param array $plugins An array of plugin data.
-        }
+	 * @return array The potentially modified array of plugin data.
+	 */
+	public function add_missing_plugins_references( $plugins ) {
+		// Only run on the plugins page.
+		if ( ! $this->is_plugins_page() ) {
+			return $plugins;
+		}
 
-        // Verify permissions
+		// Get active plugins that don't exist.
-        if (!current_user_can('activate_plugins')) {
+		$invalid_plugins = $this->get_invalid_plugins();
-            wp_die(__('You do not have sufficient permissions to perform this action.', 'fix-plugin-does-not-exist-notices'));
-        }
 
-        // Get the plugin file
+		// Add each invalid plugin to the plugin list.
-        $plugin_file = isset($_GET['plugin']) ? $_GET['plugin'] : '';
+		foreach ( $invalid_plugins as $plugin_path ) {
+			if ( ! isset( $plugins[ $plugin_path ] ) ) {
+				$plugin_name          = basename( $plugin_path );
+				$plugins[ $plugin_path ] = array(
+					'Name'        => $plugin_name . ' <span class="error">(File Missing)</span>',
+					/* translators: %s: Path to wp-content/plugins */
+					'Description' => sprintf(
+						__( 'This plugin is still marked as "Active" in your database — but its folder and files can\'t be found in %s. Click "Remove Reference" to permanently remove it from your active plugins list and eliminate the error notice.', 'fix-plugin-does-not-exist-notices' ),
+						'<code>/wp-content/plugins/</code>'
+					),
+					'Version'     => __( 'N/A', 'fix-plugin-does-not-exist-notices' ),
+					'Author'      => '',
+					'PluginURI'   => '',
+					'AuthorURI'   => '',
+					'Title'       => $plugin_name . ' (' . __( 'Missing', 'fix-plugin-does-not-exist-notices' ) . ')',
+					'AuthorName'  => '',
+				);
+			}
+		}
 
-        // Verify nonce
+		return $plugins;
-        check_admin_referer('remove_plugin_reference_' . $plugin_file);
+	}
 
-        // Remove the plugin reference
+	/**
-        $success = $this->remove_plugin_reference($plugin_file);
+	 * Add the Remove Reference action link to invalid plugins.
+	 *
+	 * Filters the action links displayed for each plugin on the plugins page.
+	 * Adds a "Remove Reference" link for plugins identified as missing.
+	 *
+	 * @param array  $actions     An array of plugin action links.
+	 * @param string $plugin_file Path to the plugin file relative to the plugins directory.
+	 * @param array  $plugin_data An array of plugin data.
+	 * @param string $context     The plugin context (e.g., 'all', 'active', 'inactive').
+	 * @return array The potentially modified array of plugin action links.
+	 */
+	public function add_remove_reference_action( $actions, $plugin_file, $plugin_data, $context ) {
+		// Only run on the plugins page.
+		if ( ! $this->is_plugins_page() ) {
+			return $actions;
+		}
 
-        // Redirect back to plugins page with a message
+		// Check if this is a missing plugin identified by our previous filter.
-        $redirect = admin_url('plugins.php');
+		if ( isset( $plugin_data['Name'] ) && strpos( $plugin_data['Name'], '<span class="error">(File Missing)</span>' ) !== false ) {
-        $redirect = add_query_arg($success ? 'reference_removed' : 'reference_removal_failed', '1', $redirect);
+			// Clear existing actions like "Activate", "Deactivate", "Edit".
-        wp_redirect($redirect);
+			$actions = array();
-        exit;
-    }
 
-    /**
+			// Add our custom action.
-     * Remove a plugin reference from the active plugins
+			$nonce      = wp_create_nonce( 'remove_plugin_reference_' . $plugin_file );
-     */
+			$remove_url = admin_url( 'plugins.php?action=remove_reference&plugin=' . urlencode( $plugin_file ) . '&_wpnonce=' . $nonce );
-    public function remove_plugin_reference($plugin_file) {
+			/* translators: %s: Plugin file path */
-        $success = false;
+			$aria_label                 = sprintf( __( 'Remove reference to missing plugin %s', 'fix-plugin-does-not-exist-notices' ), esc_attr( $plugin_file ) );
+			$actions['remove_reference'] = '<a href="' . esc_url( $remove_url ) . '" class="delete" aria-label="' . $aria_label . '">' . esc_html__( 'Remove Reference', 'fix-plugin-does-not-exist-notices' ) . '</a>';
+		}
 
-        // Handle multisite network admin
+		return $actions;
-        if (is_multisite() && is_network_admin()) {
+	}
-            $active_plugins = get_site_option('active_sitewide_plugins', array());
-            if (isset($active_plugins[$plugin_file])) {
-                unset($active_plugins[$plugin_file]);
-                $success = update_site_option('active_sitewide_plugins', $active_plugins);
-            }
-        } 
-        // Handle single site or multisite subsite
-        else {
-            $active_plugins = get_option('active_plugins', array());
-            $key = array_search($plugin_file, $active_plugins);
-            if ($key !== false) {
-                unset($active_plugins[$key]);
-                $active_plugins = array_values($active_plugins); // Re-index array
-                $success = update_option('active_plugins', $active_plugins);
-            }
-        }
 
-        return $success;
+	/**
-    }
+	 * Handle the remove reference action triggered by the link.
+	 *
+	 * Checks for the correct action, verifies nonce and permissions,
+	 * calls the removal function, and redirects back to the plugins page.
+	 *
+	 * @return void
+	 */
+	public function handle_remove_reference() {
+		// Check if our specific action is being performed.
+		if ( ! isset( $_GET['action'] ) || 'remove_reference' !== $_GET['action'] || ! isset( $_GET['plugin'] ) ) {
+			return;
+		}
 
-    /**
+		// Verify user permissions.
-     * Display admin notices
+		if ( ! current_user_can( 'activate_plugins' ) ) {
-     */
+			wp_die( esc_html__( 'You do not have sufficient permissions to perform this action.', 'fix-plugin-does-not-exist-notices' ) );
-    public function admin_notices() {
+		}
-        // Only run on the plugins page
-        if (!$this->is_plugins_page()) {
-            return;
-        }
 
-        // Get invalid plugins
+		// Sanitize and get the plugin file path.
-        $invalid_plugins = $this->get_invalid_plugins();
+		$plugin_file = isset( $_GET['plugin'] ) ? sanitize_text_field( wp_unslash( $_GET['plugin'] ) ) : '';
+		if ( empty( $plugin_file ) ) {
+			wp_die( esc_html__( 'Invalid plugin specified.', 'fix-plugin-does-not-exist-notices' ) );
+		}
 
-        // Create a highlighted notice immediately after WordPress error messages
+		// Verify nonce for security.
-        if (!empty($invalid_plugins)) {
+		check_admin_referer( 'remove_plugin_reference_' . $plugin_file );
-            // Add a notice specifically targeting the WordPress error notification
-            // Use admin_head to ensure it runs early in the page load process
-            add_action('admin_head', function() use ($invalid_plugins) {
-                ?>
-                <style type="text/css">
-                    .prc-notice {
-                        border-left: 4px solid #ffba00;
-                        background-color: #fff8e5;
-                        padding: 10px 12px;
-                        margin: 5px 0 15px;
-                        font-size: 14px;
-                        position: relative;
-                    }
-                    .prc-notice h3 {
-                        margin-top: 0;
-                        color: #826200;
-                    }
-                    .prc-notice::before {
-                        content: "";
-                        position: absolute;
-                        top: -10px;
-                        left: 20px;
-                        width: 0; 
-                        height: 0; 
-                        border-left: 10px solid transparent;
-                        border-right: 10px solid transparent;
-                        border-bottom: 10px solid #fff8e5;
-                    }
-                </style>
-                <script type="text/javascript">
-                    // Function to inject our notice
-                    function injectNotice() {
-                        // Find all notification containers first
-                        var noticeContainers = document.querySelectorAll('.notice, .error, .updated');
 
-                        // Find all error notifications about missing plugins
+		// Attempt to remove the plugin reference.
-                        noticeContainers.forEach(function(notice) {
+		$success = $this->remove_plugin_reference( $plugin_file );
-                            if (notice.textContent.includes('Plugin file does not exist') || 
-                                notice.textContent.includes('has been deactivated due to an error')) {
 
-                                // Check if we already added our notice
+		// Prepare redirect URL with feedback query args.
-                                if (notice.nextElementSibling && notice.nextElementSibling.classList.contains('prc-notice')) {
+		$redirect_url = admin_url( 'plugins.php' );
-                                    return;
+		$redirect_url = add_query_arg( $success ? 'reference_removed' : 'reference_removal_failed', '1', $redirect_url );
-                                }
 
-                                // Create our custom notice
+		// Redirect and exit.
-                                var ourNotice = document.createElement('div');
+		wp_safe_redirect( $redirect_url );
-                                ourNotice.className = 'prc-notice';
+		exit;
+	}
 
-                                // Add content
+	/**
-                                ourNotice.innerHTML = '<h3 style="margin-top:0;color:#826200;">👉 Fix Plugin Does Not Exist Notices Can Fix This</h3>' +
+	 * Remove a plugin reference from the active plugins list in the database.
-                                    '<p>To remove the above error notification, scroll down to find the plugin marked with "<strong style="color:red">(File Missing)</strong>" and click its "<strong>Remove Reference</strong>" link.</p>' +
+	 *
-                                    '<p>This will permanently remove the missing plugin reference from your database.</p>' +
+	 * Handles both single site and multisite network activated plugins.
-                                    '<p><a href="#" id="prc-scroll-to-plugin" style="font-weight:bold;text-decoration:underline;color:#826200;">Click here to scroll to the missing plugin</a></p>';
+	 *
+	 * @param string $plugin_file The plugin file path to remove.
+	 * @return bool True on success, false on failure or if the plugin wasn't found.
+	 */
+	public function remove_plugin_reference( $plugin_file ) {
+		$success = false;
 
-                                // Insert our notice right after the error
+		// Ensure plugin file path is provided.
-                                notice.parentNode.insertBefore(ourNotice, notice.nextSibling);
+		if ( empty( $plugin_file ) ) {
+			return false;
+		}
 
-                                // Add scroll behavior
+		// Handle multisite network admin context.
-                                var scrollLink = document.getElementById('prc-scroll-to-plugin');
+		if ( is_multisite() && is_network_admin() ) {
-                                if (scrollLink) {
+			$active_plugins = get_site_option( 'active_sitewide_plugins', array() );
-                                    scrollLink.addEventListener('click', function(e) {
+			// Network active plugins are stored as key => timestamp.
-                                        e.preventDefault();
+			if ( isset( $active_plugins[ $plugin_file ] ) ) {
-                                        var missingPlugins = document.querySelectorAll('tr.inactive:not(.plugin-update-tr)');
+				unset( $active_plugins[ $plugin_file ] );
-                                        for (var i = 0; i < missingPlugins.length; i++) {
+				$success = update_site_option( 'active_sitewide_plugins', $active_plugins );
-                                            if (missingPlugins[i].textContent.includes('(File Missing)')) {
+			}
-                                                missingPlugins[i].style.backgroundColor = '#fff8e5';
+		} else { // Handle single site or non-network admin context.
-                                                missingPlugins[i].scrollIntoView({behavior: 'smooth', block: 'center'});
+			$active_plugins = get_option( 'active_plugins', array() );
-                                                return;
+			// Single site active plugins are stored as an indexed array.
-                                            }
+			$key = array_search( $plugin_file, $active_plugins, true ); // Use strict comparison.
-                                        }
+			if ( false !== $key ) {
-                                    });
+				unset( $active_plugins[ $key ] );
-                                }
+				// Re-index the array numerically.
-                            }
+				$active_plugins = array_values( $active_plugins );
-                        });
+				$success        = update_option( 'active_plugins', $active_plugins );
-                    }
+			}
+		}
 
-                    // Try to inject notices on multiple events to ensure it works
+		return $success;
-                    document.addEventListener('DOMContentLoaded', function() {
+	}
-                        injectNotice();
 
-                        // Also set up a MutationObserver to watch for dynamically added notices
+	/**
-                        var observer = new MutationObserver(function(mutations) {
+	 * Display admin notices on the plugins page.
-                            mutations.forEach(function(mutation) {
+	 *
-                                if (mutation.addedNodes && mutation.addedNodes.length > 0) {
+	 * Shows informational notices about missing plugins and feedback
-                                    injectNotice();
+	 * messages after attempting to remove a reference.
-                                }
+	 *
-                            });
+	 * @return void
-                        });
+	 */
+	public function admin_notices() {
+		// Only run on the plugins page.
+		if ( ! $this->is_plugins_page() ) {
+			return;
+		}
 
-                        // Start observing the body for changes
+		// Check for feedback messages from the remove action.
-                        observer.observe(document.body, { childList: true, subtree: true });
+		if ( isset( $_GET['reference_removed'] ) && '1' === $_GET['reference_removed'] ) {
-                    });
+			?>
+			<div class="notice notice-success is-dismissible">
+				<p><?php esc_html_e( 'Plugin reference removed successfully.', 'fix-plugin-does-not-exist-notices' ); ?></p>
+			</div>
+			<?php
+		}
 
-                    // Backup attempt with window.onload
+		if ( isset( $_GET['reference_removal_failed'] ) && '1' === $_GET['reference_removal_failed'] ) {
-                    window.onload = function() {
+			?>
-                        setTimeout(injectNotice, 500);
+			<div class="notice notice-error is-dismissible">
-                    };
+				<p><?php esc_html_e( 'Failed to remove plugin reference. The plugin may already have been removed, or there was a database issue.', 'fix-plugin-does-not-exist-notices' ); ?></p>
+			</div>
+			<?php
+		}
 
-                    // Final backup in case other methods fail
+		// Get invalid plugins to display the main informational notice.
-                    setTimeout(injectNotice, 1000);
+		// Note: We don't need to call get_invalid_plugins() again if enqueue_admin_assets already did,
-                </script>
+		// but calling it here ensures the notice shows even if assets weren't enqueued (e.g., JS disabled).
-                <?php
+		// Consider caching the result in a class property if performance is critical.
-            });
+		$invalid_plugins = $this->get_invalid_plugins();
 
-            // Also display our standard info notice with more details
+		// Display the main informational notice if there are missing plugins.
-            echo '<div class="notice notice-info is-dismissible">';
+		if ( ! empty( $invalid_plugins ) ) {
-            echo '<h3>Fix Plugin Does Not Exist Notices</h3>';
+			?>
-            echo '<p><strong>Missing plugin files detected:</strong> The plugins listed below with <span style="color:red;">(File Missing)</span> tag no longer exist but are still referenced in your database.</p>';
+			<div class="notice notice-info is-dismissible">
-            echo '<p><strong>How to fix:</strong> Click the "Remove Reference" link next to each missing plugin to safely remove it from your active plugins list.</p>';
+				<h3><?php esc_html_e( 'Fix Plugin Does Not Exist Notices', 'fix-plugin-does-not-exist-notices' ); ?></h3>
-            echo '<p>This will clean up your database and remove the error notifications.</p>';
+				<p>
-            echo '</div>';
+					<strong><?php esc_html_e( 'Missing plugin files detected:', 'fix-plugin-does-not-exist-notices' ); ?></strong>
-        }
+					<?php esc_html_e( 'The plugins listed below with a', 'fix-plugin-does-not-exist-notices' ); ?>
+					<span style="color:red;">(<?php esc_html_e( 'File Missing', 'fix-plugin-does-not-exist-notices' ); ?>)</span>
+					<?php esc_html_e( 'tag no longer exist but are still referenced in your database.', 'fix-plugin-does-not-exist-notices' ); ?>
+				</p>
+				<p>
+					<strong><?php esc_html_e( 'How to fix:', 'fix-plugin-does-not-exist-notices' ); ?></strong>
+					<?php esc_html_e( 'Click the "Remove Reference" link next to each missing plugin to safely remove it from your active plugins list.', 'fix-plugin-does-not-exist-notices' ); ?>
+				</p>
+				<p><?php esc_html_e( 'This will clean up your database and remove the error notifications.', 'fix-plugin-does-not-exist-notices' ); ?></p>
+			</div>
+			<?php
+			// The JavaScript enqueued by enqueue_admin_assets() will handle adding the contextual notice
+			// near the actual WordPress error message.
+		}
+	}
 
-        // Show success message
+	/**
-        if (isset($_GET['reference_removed']) && $_GET['reference_removed'] === '1') {
+	 * Check if the current admin page is the plugins page.
-            echo '<div class="notice notice-success is-dismissible"><p>Plugin reference removed successfully.</p></div>';
+	 *
-        }
+	 * @global string $pagenow WordPress global variable for the current admin page filename.
+	 * @return bool True if the current page is plugins.php, false otherwise.
+	 */
+	private function is_plugins_page() {
+		global $pagenow;
+		// Check if it's an admin page and the filename is plugins.php.
+		return is_admin() && isset( $pagenow ) && 'plugins.php' === $pagenow;
+	}
 
-        // Show error message
+	/**
-        if (isset($_GET['reference_removal_failed']) && $_GET['reference_removal_failed'] === '1') {
+	 * Get a list of active plugin file paths that do not exist on the filesystem.
-            echo '<div class="notice notice-error is-dismissible"><p>Failed to remove plugin reference. The plugin may already have been removed.</p></div>';
+	 *
-        }
+	 * Checks both single site and network active plugins based on the context.
-    }
+	 *
+	 * @return array An array of plugin file paths (relative to WP_PLUGIN_DIR) that are missing.
+	 */
+	private function get_invalid_plugins() {
+		$invalid_plugins = array();
+		$active_plugins  = array();
 
-    /**
+		// Determine which option to check based on context (Network Admin or single site).
-     * Check if we're on the plugins page
+		if ( is_multisite() && is_network_admin() ) {
-     */
+			// Network active plugins are stored as keys in an associative array.
-    private function is_plugins_page() {
+			$active_plugins = array_keys( get_site_option( 'active_sitewide_plugins', array() ) );
-        global $pagenow;
+		} else {
-        return is_admin() && $pagenow === 'plugins.php';
+			// Single site active plugins are stored in a numerically indexed array.
-    }
+			$active_plugins = get_option( 'active_plugins', array() );
+		}
 
-    /**
+		// Check if the file exists for each active plugin.
-     * Get a list of invalid plugin references
+		foreach ( $active_plugins as $plugin_file ) {
-     */
+			// Construct the full path to the main plugin file.
-    private function get_invalid_plugins() {
+			$plugin_path = WP_PLUGIN_DIR . '/' . $plugin_file;
-        $invalid_plugins = array();
+			// Use validate_file to prevent directory traversal issues, although less likely here.
+			if ( validate_file( $plugin_file ) === 0 && ! file_exists( $plugin_path ) ) {
+				$invalid_plugins[] = $plugin_file;
+			}
+		}
 
-        // Get all active plugins
+		return $invalid_plugins;
-        if (is_multisite() && is_network_admin()) {
+	}
-            $active_plugins = array_keys(get_site_option('active_sitewide_plugins', array()));
+} // End class Fix_Plugin_Does_Not_Exist_Notices
-        } else {
-            $active_plugins = get_option('active_plugins', array());
-        }
 
-        // Check if each plugin exists
+// Initialize the plugin class.
-        foreach ($active_plugins as $plugin) {
-            $plugin_path = WP_PLUGIN_DIR . '/' . $plugin;
-            if (!file_exists($plugin_path)) {
-                $invalid_plugins[] = $plugin;
-            }
-        }
-        
-        return $invalid_plugins;
-    }
-}
-
-// Initialize the plugin
 new Fix_Plugin_Does_Not_Exist_Notices();

readme.txt

@@ -5,7 +5,7 @@ Tags: plugins, missing plugins, cleanup, error fix, admin tools, plugin file doe
 Requires at least: 5.0
 Tested up to: 6.4
 Requires PHP: 7.0
-Stable tag: 1.4.0
+Stable tag: 1.5.0
 License: GPL-2.0+
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
@@ -77,6 +77,10 @@ No. Since the plugin is only removing references to plugins that no longer exist
 
 If you remove a reference to a plugin that you later want to reinstall, simply install the plugin again and activate it normally.
 
+= Do I need to keep this plugin installed and active after notices are cleared? =
+
+Although this plugin consumes minimal disk space, and doesn't run unless you are on the /wp-admin/plugins.php page, you don't need to keep it active or installed if you don't have this notice to clear — but it is safe to, if you just want it as a part of your overall WordPress stack of enhancements and conveniences.
+
 == Screenshots ==
 
 1. Error message with explanation notification
@@ -85,6 +89,15 @@ If you remove a reference to a plugin that you later want to reinstall, simply i
 
 == Changelog ==
 
+= 1.5.0 =
+* Improved compatibility with WordPress 6.4
+* Enhanced error detection for plugin references
+* Minor UI improvements for better visibility
+* Accessibility enhancements for screen readers
+
+= 1.4.1 =
+* Added FAQ about keeping the plugin installed after notices are cleared
+
 = 1.4.0 =
 * Updated plugin name and text domain
 * Repository rename from plugin-reference-cleaner to fix-plugin-does-not-exist-notices
@@ -148,6 +161,9 @@ If you remove a reference to a plugin that you later want to reinstall, simply i
 
 == Upgrade Notice ==
 
+= 1.5.0 =
+Improved compatibility with WordPress 6.4 and accessibility enhancements for screen readers!
+
 = 1.3.3 =
 Major usability improvement with auto-scroll feature to help find missing plugins in your list!