WP Manifestindependent plugin directory
manifest / unclassified / woo-performance-toolkit

Woo Performance Toolkit

WordPress plugin that trims WooCommerce overhead: cart fragments, front-end assets, heartbeat, scheduled DB cleanup (WP-CLI + dry-run) and diagnostics with recommendations.

by saizul · github.com/saizul/woo-performance-toolkit · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/saizul/woo-performance-toolkit/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/saizul/woo-performance-toolkit ↗

Trim WooCommerce overhead from one settings page: cart fragments, front-end assets, heartbeat, scheduled database cleanup and a diagnostics screen that tells you what to fix next.

Every feature is toggleable under WooCommerce > Performance and defaults are conservative: only the heartbeat throttle is active after activation.

Features

Area What it does Default
Cart fragments Dequeues wc-cart-fragments except on cart/checkout, pages with a cart widget/block, and an allow-list of post IDs, URLs or path prefixes (/shop/*) off
Front-end assets Dequeues WooCommerce scripts and styles on non-shop pages without Woo shortcodes/blocks; keep-list and filters off
Marketing hub Removes the WooCommerce Admin marketing feature and Marketplace suggestions through documented filters off
WooCommerce Admin Optional full disable via woocommerce_admin_disabled (advanced) off
Heartbeat Slow down or disable on admin and front end; the post editor always keeps a slow heartbeat slow
Cleanup Expired WC sessions, expired transients, old Action Scheduler completed/failed actions and logs, orphaned order item meta; dry run, batching, daily/weekly schedule schedule off
Diagnostics HPOS, object cache, autoloaded options size and largest options, Action Scheduler backlog, variation-count outliers, PHP version, with recommendations always available

It declares compatibility with HPOS (custom order tables) and the Cart and Checkout blocks.

Install

cd wp-content/plugins
git clone https://github.com/saizul/woo-performance-toolkit.git
wp plugin activate woo-performance-toolkit

Requires WooCommerce to be active.

WP-CLI

wp woo-perf status                    # features, pending cleanup counts, diagnostics, recommendations
wp woo-perf status --format=json
wp woo-perf cleanup --dry-run         # counts only, nothing is deleted
wp woo-perf cleanup --yes             # run the tasks enabled in settings
wp woo-perf cleanup --task=sessions,transients --yes

Tasks: sessions, transients, action_scheduler, orphan_item_meta.

Hooks

Filter Purpose
woo_performance_toolkit_is_woocommerce_page ( bool $is_woo, int $post_id ) Treat a page as a WooCommerce page (keeps assets)
woo_performance_toolkit_keep_cart_fragments ( bool $keep, int $post_id ) Keep cart fragments on the current page
woo_performance_toolkit_keep_handles ( string[] $handles, string $type ) Handles never dequeued (script or style)
woo_performance_toolkit_disabled_admin_features ( string[] $features ) WooCommerce Admin features removed by "Disable Marketing hub" (default marketing)
woo_performance_toolkit_variation_threshold ( int $threshold ) Variation count above which a product is flagged (default 50) 
// Keep cart fragments on landing pages.
add_filter( 'woo_performance_toolkit_keep_cart_fragments', function ( $keep, $post_id ) {
    return $keep || has_term( 'landing', 'page_type', $post_id );
}, 10, 2 );

How cleanup stays safe

  • Counts are shown first (admin Cleanup tab and --dry-run).
  • Only expired sessions, expired transients, orphaned item meta and Action Scheduler complete/failed rows older than the retention period are touched.
  • Deletes run in batches (LIMIT), never one giant query.
  • All SQL is built by tested classes using %i/%s/%d placeholders and run through $wpdb->prepare().
  • Admin actions require the manage_woocommerce capability and a nonce.

Development

Logic that does not need WordPress lives in src/ and is tested with PHPUnit without loading WordPress. WordPress glue lives in includes/.

composer install
composer test
composer lint
composer phpcs

See CONTRIBUTING.md and CHANGELOG.md.

Author

Built by Saizul Amin, e-commerce web developer.

License

GPL-2.0-or-later. See LICENSE.