=== UsageRay ===
Contributors: dagemawi409
Tags: plugin usage, unused plugins, blocks, shortcodes, cleanup
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See where installed plugins are used—blocks, shortcodes, widgets, and custom post types—before you deactivate them.

== Description ==

Before deactivating a plugin, UsageRay scans your site for blocks, shortcodes, widgets, and custom post types connected to it. It shows matching content and edit links without changing or deleting anything.

Watch the short UsageRay overview:

https://www.youtube.com/watch?v=TWtoWhgtr2w

The video narration is AI-generated.

Use UsageRay when you are cleaning up an old site, replacing a page builder or form plugin, or checking whether a plugin still supports visible content.

The first release checks:

* Gutenberg blocks declared or registered by the selected plugin.
* Shortcodes registered by the selected plugin or declared literally in its source.
* Active legacy widgets registered by the selected plugin.
* Content stored in custom post types declared literally by the selected plugin.

Results link directly to matching content when WordPress provides an edit screen.

UsageRay does not deactivate, delete, or modify plugins or site content. A result of "no visible usage detected" does not prove that a plugin is unnecessary. Security, caching, SEO, backups, integrations, and other background functionality may leave no visible content evidence.

== Screenshots ==

1. Choose any installed plugin and start a read-only usage scan.
2. Review the evidence summary and open matching content directly from the results.
3. Start a scan directly from the Find usage link on the Installed Plugins screen.

== Installation ==

1. Upload the `usageray` directory to `/wp-content/plugins/` or install the ZIP in WordPress.
2. Activate UsageRay.
3. Open Tools > UsageRay, or click "Find usage" beside an installed plugin.

== Frequently Asked Questions ==

= Does this plugin tell me that another plugin is safe to delete? =

No. It reports evidence and uncertainty. It never claims that absence of visible usage makes deletion safe.

= Does it change my content? =

No. UsageRay is read-only.

= Can it inspect inactive plugins? =

It can find literal shortcode and custom post type registrations and block.json metadata in many inactive plugins. Runtime-only or dynamically registered components may require the plugin to be active.

= Why can usage be "unable to determine"? =

Some plugins work entirely in the background or register components dynamically. WordPress does not maintain a universal ownership record for all plugin data.

== Changelog ==

= 0.1.2 =

* Added a short demonstration video to the plugin page.
* Added a third screenshot showing Find usage links on the Installed Plugins screen.
* Added a scalable SVG directory icon while retaining PNG fallbacks.

= 0.1.1 =

* Added a custom icon, banner, and real interface screenshots.
* Improved the directory description to explain the plugin's purpose more clearly.

= 0.1.0 =

* Initial read-only MVP.
* Added block, shortcode, widget, and custom post type evidence scanning.
* Added Find usage links to the Installed Plugins screen.
