Add instructional notification for users (v1.3.1)

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.1] - 2023-10-05
+### Added
+- Instructional notification explaining how to use the plugin
+- Step-by-step guidance for removing plugin references
+- Clear visual indicators for missing plugins
+
 ## [1.3.0] - 2023-10-05
 ### Changed
 - Complete redesign for maximum compatibility with all WordPress themes

README.md

@@ -1,7 +1,7 @@
 # Plugin Reference Cleaner
 Author: Marcus Quinn
 Author URI: https://www.wpallstars.com
-Version: 1.3.0
+Version: 1.3.1
 License: GPL-2.0+
 
 ## Description
@@ -47,6 +47,11 @@ If you don't have this notification perpetually showing on your /wp-admin/plugin
 
 ## Changelog
 
+### 1.3.1
+* Added instructional notification explaining how to use the plugin
+* Improved user guidance with step-by-step instructions
+* Enhanced visual identification of missing plugins
+
 ### 1.3.0
 * Complete redesign for maximum compatibility with all WordPress themes
 * Now adds missing plugins directly to the plugins list table

plugin-reference-cleaner.php

@@ -2,7 +2,7 @@
 /*
  * Plugin Name: Plugin Reference Cleaner
  * Description: Adds a "Remove Reference" button to plugin deactivation error notices, allowing users to clean up invalid plugin entries.
- * Version: 1.3.0
+ * Version: 1.3.1
  * Author: Marcus Quinn
  * Author URI: https://www.wpallstars.com
  * License: GPL-2.0+
@@ -150,6 +150,19 @@ class Plugin_Reference_Cleaner {
             return;
         }
         
+        // Get invalid plugins
+        $invalid_plugins = $this->get_invalid_plugins();
+        
+        // Display instructional notice if there are invalid plugins
+        if (!empty($invalid_plugins)) {
+            echo '<div class="notice notice-info is-dismissible">';
+            echo '<h3>Plugin Reference Cleaner</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>';
+            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>';
+            echo '<p>This will clean up your database and remove the error notifications.</p>';
+            echo '</div>';
+        }
+        
         // Show success message
         if (isset($_GET['reference_removed']) && $_GET['reference_removed'] === '1') {
             echo '<div class="notice notice-success is-dismissible"><p>Plugin reference removed successfully.</p></div>';

readme.txt

@@ -1,7 +1,7 @@
 === Plugin Reference Cleaner ===
 Author: Marcus Quinn
 Author URI: https://www.wpallstars.com
-Version: 1.3.0
+Version: 1.3.1
 License: GPL-2.0+
 
 == Description ==
@@ -47,6 +47,11 @@ If you don't have this notification perpetually showing on your /wp-admin/plugin
 
 == Changelog ==
 
+= 1.3.1 =
+* Added instructional notification explaining how to use the plugin
+* Improved user guidance with step-by-step instructions
+* Enhanced visual identification of missing plugins
+
 = 1.3.0 =
 * Complete redesign for maximum compatibility with all WordPress themes
 * Now adds missing plugins directly to the plugins list table