From 7ae1da37751fb31f8442323ed865aba95fd6d9d7 Mon Sep 17 00:00:00 2001
From: Marcus Quinn <6428977+marcusquinn@users.noreply.github.com>
Date: Thu, 10 Apr 2025 01:03:23 +0100
Subject: [PATCH] Rename plugin to 'Fix Plugin file does not exist. Notices'
 for better SEO

---
 .github/workflows/assets.yml          |  24 ++
 .github/workflows/release.yml         |  20 +-
 README.md                             |  10 +-
 fix-plugin-does-not-exist-notices.php | 343 ++++++++++++++++++++++++++
 readme.txt                            |   6 +-
 rename-migration.md                   |  63 +++++
 6 files changed, 448 insertions(+), 18 deletions(-)
 create mode 100644 .github/workflows/assets.yml
 create mode 100644 fix-plugin-does-not-exist-notices.php
 create mode 100644 rename-migration.md

diff --git a/.github/workflows/assets.yml b/.github/workflows/assets.yml
new file mode 100644
index 0000000..ce0b410
--- /dev/null
+++ b/.github/workflows/assets.yml
@@ -0,0 +1,24 @@
+name: Plugin Asset Update
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - '.wordpress-org/**'
+      - 'assets/**'
+
+jobs:
+  assets:
+    name: Push assets to WordPress.org
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        
+      - name: WordPress.org plugin asset/readme update
+        uses: 10up/action-wordpress-plugin-asset-update@stable
+        env:
+          SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }}
+          SVN_USERNAME: ${{ secrets.SVN_USERNAME }}
+          SLUG: fix-plugin-does-not-exist-notices 
\ No newline at end of file
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index a6e5188..fb813f1 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -20,19 +20,19 @@ jobs:
         run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
 
       - name: Create build directory
-        run: mkdir -p build/plugin-reference-cleaner
+        run: mkdir -p build/fix-plugin-does-not-exist-notices
 
       - name: Copy plugin files
         run: |
-          cp plugin-reference-cleaner.php build/plugin-reference-cleaner/
-          cp readme.txt build/plugin-reference-cleaner/
-          cp LICENSE build/plugin-reference-cleaner/
-          cp README.md build/plugin-reference-cleaner/
+          cp fix-plugin-does-not-exist-notices.php build/fix-plugin-does-not-exist-notices/
+          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/
 
       - name: Create ZIP file
         run: |
           cd build
-          zip -r ../plugin-reference-cleaner-${{ steps.get_version.outputs.VERSION }}.zip plugin-reference-cleaner
+          zip -r ../fix-plugin-does-not-exist-notices-${{ steps.get_version.outputs.VERSION }}.zip fix-plugin-does-not-exist-notices
 
       - name: Create Release
         id: create_release
@@ -42,11 +42,11 @@ jobs:
           draft: false
           prerelease: false
           files: |
-            plugin-reference-cleaner-${{ steps.get_version.outputs.VERSION }}.zip
+            fix-plugin-does-not-exist-notices-${{ steps.get_version.outputs.VERSION }}.zip
           body: |
-            Plugin Reference Cleaner v${{ steps.get_version.outputs.VERSION }}
+            Fix 'Plugin file does not exist.' Notices v${{ steps.get_version.outputs.VERSION }}
             
-            See [CHANGELOG.md](https://github.com/wpallstars/plugin-reference-cleaner/blob/main/CHANGELOG.md) for details.
+            See [CHANGELOG.md](https://github.com/wpallstars/fix-plugin-does-not-exist-notices/blob/main/CHANGELOG.md) for details.
 
   # Deploy to WordPress.org
   wordpress:
@@ -65,4 +65,4 @@ jobs:
         env:
           SVN_USERNAME: ${{ secrets.SVN_USERNAME }}
           SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }}
-          SLUG: plugin-reference-cleaner 
\ No newline at end of file
+          SLUG: fix-plugin-does-not-exist-notices 
\ No newline at end of file
diff --git a/README.md b/README.md
index 86010d3..d78405b 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
-# Plugin Reference Cleaner
+# Fix 'Plugin file does not exist.' Notices
 
-[![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/plugin-reference-cleaner)](https://wordpress.org/plugins/plugin-reference-cleaner/)
-[![WordPress Plugin Rating](https://img.shields.io/wordpress/plugin/rating/plugin-reference-cleaner)](https://wordpress.org/plugins/plugin-reference-cleaner/)
-[![WordPress Plugin Downloads](https://img.shields.io/wordpress/plugin/dt/plugin-reference-cleaner)](https://wordpress.org/plugins/plugin-reference-cleaner/)
+[![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/fix-plugin-does-not-exist-notices)](https://wordpress.org/plugins/fix-plugin-does-not-exist-notices/)
+[![WordPress Plugin Rating](https://img.shields.io/wordpress/plugin/rating/fix-plugin-does-not-exist-notices)](https://wordpress.org/plugins/fix-plugin-does-not-exist-notices/)
+[![WordPress Plugin Downloads](https://img.shields.io/wordpress/plugin/dt/fix-plugin-does-not-exist-notices)](https://wordpress.org/plugins/fix-plugin-does-not-exist-notices/)
 [![License](https://img.shields.io/badge/license-GPL--2.0%2B-blue.svg)](https://www.gnu.org/licenses/gpl-2.0.html)
 
 Easily remove references to deleted plugins that cause "Plugin file does not exist" errors in your WordPress admin.
@@ -45,7 +45,7 @@ When WordPress detects a plugin file that no longer exists but is still referenc
 ### From WordPress.org:
 
 1. Visit Plugins > Add New in your WordPress admin
-2. Search for "Plugin Reference Cleaner"
+2. Search for "Fix 'Plugin file does not exist.' Notices"
 3. Click "Install Now" and then "Activate"
 
 ### Manual Installation:
diff --git a/fix-plugin-does-not-exist-notices.php b/fix-plugin-does-not-exist-notices.php
new file mode 100644
index 0000000..cd577f4
--- /dev/null
+++ b/fix-plugin-does-not-exist-notices.php
@@ -0,0 +1,343 @@
+<?php
+/**
+ * Fix 'Plugin file does not exist.' Notices
+ *
+ * @package           FixPluginDoesNotExistNotices
+ * @author            Marcus Quinn
+ * @copyright         2023 WP All Stars
+ * @license           GPL-2.0+
+ *
+ * @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.
+ * Version: 1.3.3
+ * Author: Marcus Quinn
+ * Author URI: https://www.wpallstars.com
+ * License: GPL-2.0+
+ * License URI: https://www.gnu.org/licenses/gpl-2.0.html
+ * Text Domain: fix-plugin-does-not-exist-notices
+ * Domain Path: /languages
+ * Requires at least: 5.0
+ * Requires PHP: 7.0
+ *
+ * This plugin is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * any later version.
+ *
+ * This plugin is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this plugin. If not, see https://www.gnu.org/licenses/gpl-2.0.html.
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+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);
+        
+        // Handle the remove reference action
+        add_action('admin_init', array($this, 'handle_remove_reference'));
+        
+        // Add admin notices for operation feedback
+        add_action('admin_notices', array($this, 'admin_notices'));
+    }
+    
+    /**
+     * Find and add invalid plugin references to the plugins list
+     */
+    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
+        $invalid_plugins = $this->get_invalid_plugins();
+        
+        // Add each invalid plugin to the plugin list
+        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>',
+                    'Description' => 'This plugin file does not exist. You can safely remove this reference.',
+                    'Version' => 'N/A',
+                    'Author' => '',
+                    'PluginURI' => '',
+                    'AuthorURI' => '',
+                    'Title' => $plugin_name . ' (Missing)',
+                    'AuthorName' => ''
+                );
+            }
+        }
+        
+        return $plugins;
+    }
+    
+    /**
+     * 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
+        if (isset($plugin_data['Name']) && strpos($plugin_data['Name'], '<span class="error">(File Missing)</span>') !== false) {
+            // Clear existing actions
+            $actions = array();
+            
+            // Add our action
+            $nonce = wp_create_nonce('remove_plugin_reference_' . $plugin_file);
+            $remove_url = admin_url('plugins.php?action=remove_reference&plugin=' . urlencode($plugin_file) . '&_wpnonce=' . $nonce);
+            $actions['remove_reference'] = '<a href="' . esc_url($remove_url) . '" class="delete" aria-label="' . esc_attr__('Remove Reference', 'plugin-reference-cleaner') . '">Remove Reference</a>';
+        }
+        
+        return $actions;
+    }
+    
+    /**
+     * Handle the remove reference action
+     */
+    public function handle_remove_reference() {
+        // Check if we're removing a reference
+        if (!isset($_GET['action']) || $_GET['action'] !== 'remove_reference' || !isset($_GET['plugin'])) {
+            return;
+        }
+        
+        // Verify permissions
+        if (!current_user_can('activate_plugins')) {
+            wp_die(__('You do not have sufficient permissions to perform this action.', 'plugin-reference-cleaner'));
+        }
+        
+        // Get the plugin file
+        $plugin_file = isset($_GET['plugin']) ? $_GET['plugin'] : '';
+        
+        // Verify nonce
+        check_admin_referer('remove_plugin_reference_' . $plugin_file);
+        
+        // Remove the plugin reference
+        $success = $this->remove_plugin_reference($plugin_file);
+        
+        // Redirect back to plugins page with a message
+        $redirect = admin_url('plugins.php');
+        $redirect = add_query_arg($success ? 'reference_removed' : 'reference_removal_failed', '1', $redirect);
+        wp_redirect($redirect);
+        exit;
+    }
+    
+    /**
+     * Remove a plugin reference from the active plugins
+     */
+    public function remove_plugin_reference($plugin_file) {
+        $success = false;
+        
+        // Handle multisite network admin
+        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;
+    }
+    
+    /**
+     * Display admin notices
+     */
+    public function admin_notices() {
+        // Only run on the plugins page
+        if (!$this->is_plugins_page()) {
+            return;
+        }
+        
+        // Get invalid plugins
+        $invalid_plugins = $this->get_invalid_plugins();
+        
+        // Create a highlighted notice immediately after WordPress error messages
+        if (!empty($invalid_plugins)) {
+            // 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
+                        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
+                                ourNotice.innerHTML = '<h3 style="margin-top:0;color:#826200;">👉 Plugin Reference Cleaner 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)')) {
+                                                missingPlugins[i].style.backgroundColor = '#fff8e5';
+                                                missingPlugins[i].scrollIntoView({behavior: 'smooth', block: 'center'});
+                                                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) {
+                                    injectNotice();
+                                }
+                            });
+                        });
+                        
+                        // Start observing the body for changes
+                        observer.observe(document.body, { childList: true, subtree: true });
+                    });
+                    
+                    // Backup attempt with window.onload
+                    window.onload = function() {
+                        setTimeout(injectNotice, 500);
+                    };
+                    
+                    // Final backup in case other methods fail
+                    setTimeout(injectNotice, 1000);
+                </script>
+                <?php
+            });
+            
+            // Also display our standard info notice with more details
+            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>';
+        }
+        
+        // Show error message
+        if (isset($_GET['reference_removal_failed']) && $_GET['reference_removal_failed'] === '1') {
+            echo '<div class="notice notice-error is-dismissible"><p>Failed to remove plugin reference. The plugin may already have been removed.</p></div>';
+        }
+    }
+    
+    /**
+     * Check if we're on the plugins page
+     */
+    private function is_plugins_page() {
+        global $pagenow;
+        return is_admin() && $pagenow === 'plugins.php';
+    }
+    
+    /**
+     * Get a list of invalid plugin references
+     */
+    private function get_invalid_plugins() {
+        $invalid_plugins = array();
+        
+        // Get all active plugins
+        if (is_multisite() && is_network_admin()) {
+            $active_plugins = array_keys(get_site_option('active_sitewide_plugins', array()));
+        } else {
+            $active_plugins = get_option('active_plugins', array());
+        }
+        
+        // Check if each plugin exists
+        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();
\ No newline at end of file
diff --git a/readme.txt b/readme.txt
index 399e916..6757132 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,7 +1,7 @@
-=== Plugin Reference Cleaner ===
+=== Fix 'Plugin file does not exist.' Notices ===
 Contributors: marcusquinn
 Donate link: https://www.wpallstars.com
-Tags: plugins, missing plugins, cleanup, error fix, admin tools
+Tags: plugins, missing plugins, cleanup, error fix, admin tools, plugin file does not exist
 Requires at least: 5.0
 Tested up to: 6.4
 Requires PHP: 7.0
@@ -46,7 +46,7 @@ When WordPress detects a plugin file that no longer exists but is still referenc
 
 == Installation ==
 
-1. Upload the `plugin-reference-cleaner` folder to the `/wp-content/plugins/` directory
+1. Upload the `fix-plugin-does-not-exist-notices` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the 'Plugins' menu in WordPress
 3. No configuration needed - the plugin works automatically
 4. If you have missing plugin errors, you'll immediately see them in your plugins list with "Remove Reference" links
diff --git a/rename-migration.md b/rename-migration.md
new file mode 100644
index 0000000..e4e7139
--- /dev/null
+++ b/rename-migration.md
@@ -0,0 +1,63 @@
+# Repository Rename Migration Guide
+
+This document outlines the steps needed to safely rename the GitHub and Gitea repositories from `plugin-reference-cleaner` to `fix-plugin-does-not-exist-notices` while maintaining history and ensuring proper redirects.
+
+## GitHub Repository Rename
+
+1. Go to the GitHub repository settings: 
+   - https://github.com/wpallstars/plugin-reference-cleaner/settings
+
+2. In the "General" tab, find the "Repository name" section and enter the new name: 
+   - `fix-plugin-does-not-exist-notices`
+
+3. Click "Rename"
+
+GitHub will automatically set up redirects from the old URL to the new URL, so any existing links to the old repository will still work.
+
+## Gitea Repository Rename
+
+1. Go to the Gitea repository settings:
+   - https://gitea.wpallstars.com/wpallstars/plugin-reference-cleaner/settings
+
+2. Find the "Repository Name" field and change it to:
+   - `fix-plugin-does-not-exist-notices`
+
+3. Click "Update Repository"
+
+## Update Local Repository
+
+After renaming the remote repositories, update your local git configuration:
+
+```bash
+# 1. Update the remote URLs for both GitHub and Gitea
+git remote set-url github https://github.com/wpallstars/fix-plugin-does-not-exist-notices.git
+git remote set-url gitea git@gitea.wpallstars.com:wpallstars/fix-plugin-does-not-exist-notices.git
+
+# 2. Verify the changes
+git remote -v
+
+# 3. Create a new local clone (optional but recommended)
+cd ..
+git clone git@gitea.wpallstars.com:wpallstars/fix-plugin-does-not-exist-notices.git
+cd fix-plugin-does-not-exist-notices
+```
+
+## WordPress.org Plugin Submission
+
+When submitting to WordPress.org, you'll need to use the new slug:
+
+- Plugin slug: `fix-plugin-does-not-exist-notices`
+
+After approval, update the GitHub secrets with:
+
+```
+SVN_USERNAME: your_wordpress_username
+SVN_PASSWORD: your_wordpress_password
+SLUG: fix-plugin-does-not-exist-notices
+```
+
+## Final Steps
+
+1. Update any documentation or links that reference the old repository name
+2. Commit and push all the renamed files
+3. Create a new release with the new file naming conventions 
\ No newline at end of file