=== Elevoire Orphaned Data Cleaner ===
Contributors: elevoire, hassanraza
Tags: cleanup, database, orphaned data, optimize, uninstall
Requires at least: 6.5
Tested up to: 7.1
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 and safely remove database leftovers from uninstalled plugins — tables, options, meta, cron jobs, and transients.

== Description ==

Most WordPress plugins don't clean up fully after themselves. Deactivate and delete a plugin, and it often leaves behind:

* Custom database tables
* Settings rows in `wp_options`
* Meta keys attached to your posts or users
* Scheduled cron jobs that fire forever into the void
* Transients that never expire cleanly

Over months and years, this debris accumulates and quietly bloats your database. **Elevoire Orphaned Data Cleaner** scans for exactly this kind of leftover and lets you remove it, one confirmed item at a time.

= How it works =

The plugin cross-references everything it finds against your currently installed plugins (active or not). If nothing installed matches a table, option, or meta key by name, it's flagged as orphaned — with a confidence level so you know how sure the plugin is:

* **High confidence** — no installed plugin has ever existed with a matching name. Very safe to remove.
* **Medium confidence** — a loose name match wasn't found, but naming conventions vary; worth a quick look before deleting.
* **Low confidence** — flagged conservatively; verify manually first.

Every deletion is logged with a snapshot of what was removed, so there's always an audit trail.

= Features =

* Scans 6 categories: tables, options, post meta, user meta, cron jobs, transients
* Confidence-rated findings — never blind guesses
* One-click delete per item, with a confirmation dialog
* Step-by-step scan with a progress bar — safe even on large databases
* Every delete logged with a snapshot for manual recovery
* No settings to configure, no bloat — just scan and clean

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/elevoire-orphaned-data-cleaner`, or install directly through the WordPress plugins screen.
2. Activate the plugin.
3. Go to **Tools → Orphaned Data** and click **Scan My Site**.

== Frequently Asked Questions ==

= Will this delete data from plugins I'm still using? =

No. Every finding is cross-referenced against your installed plugins (even inactive ones). If a plugin folder exists for it, it's never flagged.

= Is this safe to run on a live site? =

Yes, but as with any database operation, we recommend taking a full database backup first, especially before deleting medium/low confidence items. The plugin logs a snapshot of everything it deletes, but that's not a substitute for a real backup.

= What if I accidentally delete something I needed? =

Check Tools → Orphaned Data — every deletion is logged with a snapshot of the original value, which a developer can use to manually restore it via phpMyAdmin.

== Changelog ==

= 1.0.0 =
* Initial release.
