=== 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.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find visible content evidence before deactivating or replacing a WordPress plugin.

== Description ==

UsageRay is a read-only evidence scanner. It helps administrators answer a cautious question: where is this plugin visibly used?

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.

== 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. Version 0.1.0 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.0 =

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