TSO Options & Tables Cleaner

By deadko

20+ active installationsVersion 1.4.5

Database cleanup for wp_options, orphan metadata, revisions, and unused tables. Includes backups. English, Spanish, and Catalan.

Description

TSO Options & Tables Cleaner is a database maintenance plugin for WordPress. It helps you clean wp_options, orphan metadata, revisions, and leftover plugin tables, with backups and table optimization.

Features:

  • Current status — Dashboard tab with database size, options/transients summary, autoload highlights, and quick links to cleanup actions
  • General cleanup — Remove expired transients, post revisions, auto-drafts, trashed posts and comments, orphan post/comment/user/term metadata
  • wp_options manager — Browse, search and delete orphan options grouped by plugin, with autoload management and plugin detection for 300+ known plugins
  • Extra tables — Detect and remove tables left by uninstalled plugins (see detection limitations below)
  • Plugin & theme history — Track installation, activation, deactivation and deletion events for plugins and themes
  • Database backup — Export the full database to SQL, download, restore or delete backups stored in wp-content/uploads/tso-options-tables-cleaner/backups/
  • Table optimizer — Run OPTIMIZE TABLE on all fragmented WordPress tables
  • Interface languages — Catalan, Spanish and English UI with per-user language preference
  • Cache-plugin compatible — Compatible with LiteSpeed Cache and other caching plugins

Detection is heuristic, not perfect

WordPress does not record which database table belongs to which plugin. TSO Options & Tables Cleaner infers ownership from table prefixes, plugin folders on disk, install history, and other signals. That works well for many sites, but it cannot be 100% accurate in every case.

You may occasionally see:

  • A table marked as probably orphaned while the plugin is still installed or active (false positive)
  • A leftover table not flagged as orphaned after uninstall (false negative)
  • Recent activity on a table because MySQL metadata was updated (maintenance, repair, or unreliable timestamps on some engines) even though the plugin is gone
  • Unclear ownership for shared prefixes, renamed plugin folders, or custom tables

The plugin is intentionally conservative: when confidence is low, delete actions are blocked and you will see Review only. Always check the plugin list, export SQL before dropping tables, and use manual assignment when the automatic label looks wrong. Never delete a table unless you are sure it is safe for your site.

Privacy Policy

TSO Options & Tables Cleaner does not collect, transmit, or share any personal data with external services.

Data stored locally:

  • Language preference: The administrator’s chosen UI language (Catalan, Spanish or English) is stored in wp_usermeta under the key tso_ui_lang. This data stays on your server and is never transmitted anywhere.
  • Plugin/theme history: A log of plugin and theme events is stored in wp_options under the key tso_plugin_history. This log is optional and can be cleared at any time from the History tab.
  • Database backups: SQL backup files are stored locally in wp-content/uploads/tso-options-tables-cleaner/backups/ and are never uploaded to any external service. They are removed when you uninstall the plugin (download first if you need to keep them).

No external connections: This plugin does not make any HTTP requests to external servers, does not use analytics, and does not track usage of any kind.

Installation

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate the plugin through the Plugins screen in WordPress
  3. Go to Tools > TSO Options & Tables Cleaner to start cleaning

FAQ

Is it safe to delete options from inactive plugins?

Yes. Options from inactive plugins can be deleted safely. The plugin marks active plugin options with a warning so you can identify them.

Is plugin and table detection always accurate?

No. Detection is heuristic. WordPress does not store a definitive link between each table or option and its plugin. TSO uses prefixes, folder names, history, and other clues. Results are usually helpful, but false positives and false negatives can happen — especially after plugin renames, shared prefixes, stale maps, or unusual custom setups.

Why does a table show as orphaned when the plugin is still active?

Usually because automatic detection matched an outdated path, a label-only prefix map, or conflicting signals. Reload the Extra tables tab after plugin updates. If the label is wrong, use Assign to link the table to the correct plugin, or export SQL and review before deleting anything.

Why is delete blocked for a table that looks orphaned?

Delete is allowed only when status and usage signals both look safe. If MySQL reports recent writes, the plugin folder still exists but is inactive, or ownership is uncertain, the UI shows Review only to reduce the risk of dropping a table still in use. Export the SQL backup and verify manually when in doubt.

Where are the backups stored?

In wp-content/uploads/tso-options-tables-cleaner/backups/. This directory is protected by .htaccess and an index.php to prevent direct access. Files are stored locally and never transmitted to any external service.

What happens to backups when I uninstall the plugin?

Uninstall removes the plugin-owned uploads folder (including SQL backups and options-tab cache). Download any backups you want to keep before deleting the plugin from WordPress.

Does it work with LiteSpeed Cache?

Yes. The plugin sends the appropriate no-cache headers and LiteSpeed Cache API calls to avoid caching the admin interface.

What data does this plugin store?

Only the administrator interface language preference (Catalan, Spanish or English), saved as user meta (tso_ui_lang). No data is sent to external servers.

Screenshots

Changelog

See changelog.txt in the plugin folder for older versions.

1.4.5

  • Fix: cron events are matched to the plugin that registers them and are not marked orphaned while that plugin is active.
  • Improvement: the Cron events table can be sorted, with one small sort icon on every sortable header.
  • Improvement: the wp_options summary cards name what they count.
  • Improvement: automatic cleanup on Current status lists only actions that changed something, plus current table fragmentation.
  • Improvement: extra-table groups and backups stay readable on narrow screens.

1.4.4

  • Fix: plugin status no longer writes “Undefined array key active” to the debug log when a detected row has no active flag.
  • Fix: custom cleanup schedules no longer trigger the WordPress 6.7 notice about loading translations too early.
  • Improvement: the language switcher includes AUTO, which follows the WordPress user language. Languages other than Catalan, Spanish and English keep their WordPress language pack.

1.4.3

  • Fix: Current status tab figures, cards, notices, buttons and “Refresh data” link.
  • Fix: tables only read by another plugin are no longer assigned to it.
  • Fix: languages, plurals and dates in the General cleanup tab.
  • Fix: backups keep the % character; older backups are repaired on restore.
  • Fix: restoring large backups no longer fails with a critical error.
  • Improvement: Current status tab shows accumulated content, biggest tables and versions.
  • Improvement: compatible with PHP 7.4.
  • Improvement: General cleanup asks for confirmation only on Caution actions.