Simpli Revisions

Cleans up WordPress post revisions on demand. No cron, no auto-delete — you look at the numbers, choose how many to keep, and confirm.

For users

Tools → Revisions

• Top of page: total revision count and an estimated database size.
• Keep last: how many of the newest revisions to keep per post. Defaults to 5.
• Clean Up Revisions: asks you to confirm, then deletes every revision older than the newest N for every post on the site. This cannot be undone.
• View Revisions by Post: expands a table of every post/page that has revisions — title (linked to the editor), post type, revision count, and estimated size — sorted by count, worst offenders first. Click again to collapse it. It refreshes automatically after a cleanup if it's open; otherwise it just refetches next time you open it.
• There's also a Revisions link on the Plugins list page for quick access, next to Deactivate.

The size shown is an estimate (post_content + post_title + post_excerpt length for revision rows), not a SHOW TABLE STATUS figure — it's meant to give a sense of scale, not an exact byte count.

For developers

Flat procedural plugin, no build step, no external dependencies.

simpli-revisions.php   Plugin bootstrap, all PHP logic, AJAX handlers
templates/page.php       Admin page markup (included, not templated)
assets/admin.js          Vanilla JS — fetch + DOM, no jQuery

Core functions

All three data functions are safe to call directly from other code (e.g. WP-CLI commands, a scheduled cron job, a dashboard widget) — they don't touch $_POST or output anything.

Filters

// Require a custom capability instead of manage_options
add_filter( 'sw_rev_capability', function () {
    return 'edit_others_posts';
} );

// Change the default "keep" count
add_filter( 'sw_rev_default_keep', function () {
    return 10;
} );

AJAX endpoints

Both require current_user_can( sw_rev_capability() ) and a sw_rev_cleanup nonce (swRev.nonce, localized to admin.js).

• wp_ajax_sw_rev_cleanup — POST { action, nonce, keep } → { deleted, stats }
• wp_ajax_sw_rev_by_post — POST { action, nonce } → { posts: [...] }

Extending

• Deletion behaviour: sw_rev_cleanup_revisions() uses core's wp_delete_post_revision(), so anything already hooking delete_post / deleted_post on revision deletes fires as normal — no separate hook needed on our side.
• Excluding post types or specific posts: not built in. The cleanest way to add it is a guard at the top of the loop in sw_rev_cleanup_revisions() — skip $parent_id based on get_post_type( $parent_id ) before calling wp_delete_post_revision(), and mirror the same check in sw_rev_get_stats() / sw_rev_get_stats_by_post() so the UI numbers match what cleanup will actually do.
• New admin UI: templates/page.php is a plain include with sw_rev_get_stats() already in scope — add markup and wire it up in assets/admin.js the same way the existing table is (a fetch() to swRev.ajaxUrl with swRev.nonce).
• Scheduling: there's no cron here by design (see "For users" above). To automate it, hook wp_scheduled_delete or your own cron event and call sw_rev_cleanup_revisions( $keep ) directly — it's a plain function, not gated behind the AJAX/nonce layer.