=== Plugin Usage Detector by Volade ===
Contributors: volade
Tags: plugin usage, audit, cleanup, performance, developer
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find unused, redundant, and zombie plugins with multi-signal scans and trust scores. Works without a Volade account.

== Description ==

**Plugin Usage Detector by Volade** helps agencies and site owners understand which plugins are actually used — before deleting the wrong one.

Unlike basic active/inactive lists, this plugin combines **seven classification statuses**, a **Trust Score (0–100)** with signal breakdown, and **duplicate overlap detection** (multiple SEO, cache, or backup plugins).

**Key features:**

* 7 statuses: active_used, infrastructure, admin_only, uncertain, likely_unused, inactive, zombie_bloat
* Trust Score 0–100 per plugin with signal breakdown
* Multi-signal scan: post content (shortcodes/blocks), widgets, cron hooks, wp_options footprint, admin heuristics
* Infrastructure registry (50+ known plugins: SEO, security, backup, cache, WooCommerce, etc.)
* Duplicate overlap warnings (SEO, cache, backup, security, forms, SMTP, analytics)
* Agency presets: full audit, WooCommerce cleanup, security minimal
* Per-plugin ignore list
* JSON export free (no account); CSV with connected Volade account
* Plugin list column with usage badge
* Site Health test
* WP-CLI: `wp pud scan`, `wp pud status`, `wp pud export`
* Weekly cron scan (V+ Premium)
* Multisite network rollup (V+ Premium)

= No account (free) =

* Audit **active plugins** with multi-signal analysis
* Summary cards, filter tabs, trust scores, overlap warnings
* Agency presets and **JSON export**
* Plugin list usage badges
* Site Health test
* Menu: **Tools → Plugin Usage**

= Free Volade account (optional) =

* Scan **inactive** plugins (zombie bloat detection)
* **CSV export**
* Volade ecosystem: XP, discover, referrals

= V+ Premium (optional paid subscription) =

* Scan history (last 20 audits)
* Weekly scheduled audit emails
* Multisite network rollup
* Client report template (JSON; PDF planned)
* Billed through [volade.com](https://volade.com) via Stripe (only if you choose to subscribe)

= Volade ecosystem =

The bundled **Volade SDK** is optional: **the audit works without any Volade account.** Sign in only for inactive scans, CSV export, or V+ Premium.

= Translations =

English (default). Also available: French, Spanish, German, Brazilian Portuguese, and Italian.

== Installation ==

1. Upload the `plugin-usage-detector-by-volade` folder (with `volade-sdk/` included) to `/wp-content/plugins/`
2. Activate the plugin
3. Open **Tools → Plugin Usage** and click **Run audit**

== Frequently Asked Questions ==

= Does this send my site data to external servers? =

No. Scans run locally on your server. Optional Volade account features use the Volade API only when you sign in.

= How is this different from WP Usage Analyzer or Unplug? =

This plugin combines content, widget, cron, options, and admin signals with an infrastructure registry, trust scores, overlap detection, and agency presets — all in one audit screen.

= Can I export results for clients? =

JSON export is free. CSV requires a connected Volade account. V+ Premium adds a client report template (JSON for now).

= Will it tell me which plugins to delete? =

It classifies plugins and highlights likely unused and zombie bloat — always review on staging before removing infrastructure plugins.

== Screenshots ==

1. Summary cards and agency presets on the audit dashboard
2. Scan options with multi-signal toggles and overlap warnings
3. Results table with status badges, trust scores, and signal breakdown
4. Filter tabs by classification status
5. Plugin list usage badges and V+ Premium feature gates

== External services ==

This plugin may connect to **Volade** (`https://volade.com/api`) when you use optional Volade features (account, V+). No data is sent until you create a Volade account.

**Service:** Volade API (`https://volade.com/api`)

**When:** Only after you sign in to Volade or subscribe to V+.

**Disable:** Do not create a Volade account. Auditing remains fully usable in guest mode.

Developers may override the API URL with the `VOLADE_API_URL` constant in `wp-config.php`.

== Privacy ==

**Local data:** Audit results, settings, ignore list, and scan history are stored in your WordPress database. Volade account data is stored locally when you use the optional Volade account system.

**Export / erasure:** Signed-in users can export their Volade data (JSON) from **Volade → Settings**. Account deletion requests are handled per the [Volade privacy policy](https://volade.com/en/confidentialite).

**Uninstall:** Deleting the plugin removes audit settings, history, ignore list, and all Volade SDK tables, options, and scheduled tasks created by this plugin.

**Cookies:** A `volade_token` HTTP-only cookie is set when you sign in to Volade (admin only).

== Changelog ==

= 1.0.0 =
* Initial release: multi-signal plugin usage audit with trust scores, infrastructure registry, overlap detection, agency presets, JSON/CSV export, WP-CLI, Site Health test, and Volade SDK integration.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
