WP Manifestindependent plugin directory
manifest / performance / tw-perf-intelligence

TW Perf Intelligence self-updates

WordPress performance plugin — DOM-aware JS/CSS optimisation, per-page defer/delay/unload rules, PageSpeed Insights integration, and GitHub auto-updates

by TechWonders / PC Buddy 247 · github.com/techwonders101/tw-perf-intelligence · website

★ 2stars
1forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/techwonders101/tw-perf-intelligence/archive/refs/heads/master.zip

Ships its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.

Readme github.com/techwonders101/tw-perf-intelligence ↗

WordPress performance plugin -- DOM-aware JS/CSS optimisation with per-page rules, PageSpeed Insights integration, and GitHub auto-updates.

Why it matters for SEO

Google uses Core Web Vitals (LCP, INP, CLS) as a direct ranking factor. Render-blocking JavaScript and CSS are among the most common causes of poor LCP and high Total Blocking Time scores. Deferring and delaying scripts that are not needed above the fold reduces render-blocking, improves PageSpeed Insights scores, and directly boosts organic search rankings.

This plugin handles that at the WordPress asset level -- per page, per post type, or globally -- with a DOM-aware engine that tells you which assets are actually safe to remove or defer on each specific page.

What it does

TW Perf Intelligence scans every enqueued script and style on each page and tells you exactly which ones are safe to unload, defer, or delay -- based on what elements are actually in the DOM, not guesswork.

Unlike generic performance plugins that apply blanket rules, this plugin detects whether each asset's DOM signatures (CSS selectors, data attributes) are present on the current page before making any recommendation.

Key Features

DOM-Aware Intelligence Engine

  • Analyses 100+ common plugin and library signatures (jQuery, WooCommerce, Elementor, Slick, Swiper, CF7, GSAP, AOS, DataTables, Tribe Events, cookie consent plugins, social sharing, maps, video, and more)
  • 15 dynamic handle patterns for page builder assets (Elementor post CSS, UAGB, Greenshift, Divi, Beaver Builder, WooCommerce Blocks)
  • Detects duplicate slider libraries automatically (Slick and Swiper conflict warnings)
  • Flags third-party (external-origin) assets with a "3rd party" badge and filter
  • Unknown handles marked for manual review -- never blindly guessed

Interaction Recorder

  • Record a live session on any page -- the plugin patches addEventListener to detect which scripts actually fire during scroll, click, hover, and form interaction
  • Monitors XHR/fetch calls triggered during the session
  • After recording, each script is marked "confirmed active" or left unconfirmed
  • Detects companion CSS files linked to active scripts
  • Gives you real evidence to support unload decisions, not just DOM scanning

Per-Page Rule Scoping

  • Global rules apply site-wide
  • Post type rules apply to all pages of a given type (e.g. all page, all product)
  • Page rules apply to a single URL or post ID
  • Rules merge with page-level taking precedence
  • Promote a page rule up to post type or global without re-entering it

Asset Actions

Action What it does SEO benefit
Unload Completely dequeues the asset on the matched scope Eliminates unused requests -- reduces render-blocking
Defer Adds defer attribute -- script loads after HTML parse Removes render-blocking JS -- improves LCP and TBT
Delay Script loads only after first user interaction (scroll, click, touchstart) Removes render-blocking JS -- maximum TBT reduction
Async CSS Converts blocking <link> to non-render-blocking preload with noscript fallback Removes render-blocking CSS -- improves LCP
Preload Adds <link rel="preload"> in <head> for LCP images and critical assets Speeds up LCP element discovery

Safe Preview Mode

  • Test rules before they go live -- only you see the optimised version
  • All other visitors see the unmodified site until you are ready
  • Per-rule "Go Live" button promotes individual rules from preview to live
  • Rules can run in frontend context, admin context, or both

PageSpeed Insights Integration

  • Run a live PSI analysis from the admin bar panel
  • Mobile and desktop strategy toggle
  • Lab metrics: LCP, FCP, TBT, CLS, INP, Speed Index, TTI
  • Real-user (CrUX) field data: LCP, INP, CLS, FCP, TTFB with good/needs improvement/poor thresholds
  • Render-blocking resources matched back to WP handles with one-click Fix buttons
  • Identifies unused JS and CSS opportunities
  • Results cached 1 hour per URL

PHP Profiler

  • Excimer-powered sampling profiler for detailed PHP request analysis
  • Profile any wp-admin screen or frontend page from the TW Perf admin-bar menu while logged in as an admin
  • Reports include inline top sampled functions plus Speedscope JSON, collapsed stacks, and summary JSON downloads
  • Report files are stored in a private server-side directory and served only through admin-only download handlers
  • Sampling period, stack depth, and report retention are configurable from Settings

Quick Wins (one-click toggles)

  • Remove emoji scripts and styles (saves one JS + one CSS request per page)
  • Clean <head> -- removes generator meta, RSD, WLW, shortlink, REST discovery, oEmbed links
  • Reduce heartbeat frequency (keeps, frontend-only, or everywhere)
  • Add font-display: swap to all @font-face blocks (prevents invisible text during font load)
  • Add fetchpriority="high" and remove loading="lazy" from your saved LCP image
  • Cache and serve Google Fonts locally after a settings scan across representative templates, with cached family names shown in Settings
  • Remove render-blocking Google Fonts entirely

Dependency Visualiser

  • See the full dependency tree for any script handle
  • Prevents breaking changes -- shows exactly what depends on jQuery or any other handle before you remove it

Conflict Checker

  • Detects handles with conflicting actions across scopes (e.g. unloaded globally but kept on a page)
  • Warns when delayed or unloaded scripts have active dependents that would break

Preloads and Preconnects

  • Font preloads managed from the panel (<link rel="preload" as="font">)
  • Auto-detection of Google Fonts in enqueued stylesheets
  • Local Google Fonts cache from Settings scans homepage/archive/post/page/product templates and rewrites matching fonts.googleapis.com URLs to local cached CSS
  • Preconnect origins for third-party domains (<link rel="preconnect">)
  • LCP image preload per page with fetchpriority="high"

Critical CSS

  • Paste above-the-fold CSS directly into the panel -- injected inline in <head> at highest priority
  • Use alongside Async CSS to eliminate render-blocking stylesheets entirely

Export / Import

  • Export all rules to JSON -- import on another site
  • Merge mode (add new rules) or Replace mode (full overwrite)
  • Roll a tested configuration across multiple client sites

Cache Integration

Automatically purges cache after saving rules on: W3 Total Cache - WP Rocket - WP Super Cache - LiteSpeed Cache - Nginx Helper - Breeze - Autoptimize - FlyingPress - SG Optimizer - Hummingbird - Plesk/Nginx static cache

Installation

  1. Download tw-performance.zip from the latest release
  2. Go to WP Admin -- Plugins -- Add New -- Upload Plugin
  3. Activate the plugin
  4. Go to TW Perf -- Settings to configure
  5. Optionally add a Google PageSpeed Insights API key (free)
  6. Visit the front end of your site -- use the TW Perf panel in the admin bar

Auto-updates

Once installed, the plugin checks GitHub releases automatically and appears in Dashboard -- Updates like any other WordPress plugin. No manual downloads needed for future versions.

  1. Quick Wins first -- enable the one-click toggles in Settings (safe for all sites)
  2. Preload your LCP image -- find your above-the-fold hero image, save its URL in the Preloads tab
  3. Serve fonts locally -- run the Local Google Fonts scan in Settings, then preload critical local font files where needed
  4. Analyse each key page -- open the panel, click Analyse, review recommendations
  5. Record a session -- scroll the full page, open menus, interact with forms and sliders so the recorder can detect which scripts actually fire
  6. Apply recommendations -- use Preview Mode to test, then Go Live on what works

For JS you are unsure about -- use Defer. For CSS you are unsure about -- use Async CSS. Only Unload when DOM analysis or the recorder confirms the asset is genuinely unused.

Requirements

  • WordPress 6.0+
  • PHP 8.0+
  • MySQL 5.7+ / MariaDB 10.3+

FAQ

Will this break my site? Test mode is on by default. Rules only apply to you while Preview Mode is active -- other visitors see the unmodified site until you are confident and disable test mode.

My slider broke after applying rules. What do I do? Open the panel -- Rules tab -- find the slider handle -- change action from "unload" to "keep". Cache is purged automatically.

jQuery is flagged but I can't unload it. Correct. jQuery can't be safely removed until all dependents are also removed. The dependency tree shows exactly what needs to go first.

Does it work with page caching? Yes. Rules apply at the PHP level before caching, so cached pages include the correct optimised state. Cache is purged automatically after saving rules.

Can I copy my config to another site? Panel -- Tools -- Export Rules -- download the JSON. On the other site: Import Rules -- paste -- choose Merge or Replace.

Is it safe to have a public repo? Yes. The plugin contains no API keys, secrets, or credentials. Users supply their own PSI API key in WP Admin, stored in wp_options on their own server.

Changelog

1.0.9

  • Added Excimer-powered PHP profiler for wp-admin screens and frontend pages browsed by admins
  • Added Profiler reports page with top sampled functions and Speedscope/collapsed/summary downloads
  • Added profiler settings for enable/disable, sampling period, stack depth, and report retention
  • Added Local Google Fonts scanner in Settings with uploads-based local CSS/font cache and frontend URL rewrites
  • Added cached Google Font family names to the local fonts status panel
  • Added top-level TW Perf admin navigation with Settings, Rules, and Profiler subpages
  • Secured profiler capture, downloads, deletion, and report file access behind manage_options plus nonces

1.0.5

  • Added GitHub-native auto-updater -- plugin appears in WP Dashboard -- Updates
  • Added Mobile/Desktop strategy toggle to PSI Score button
  • Added CrUX real-user field data to PSI results (LCP, INP, CLS, FCP, TTFB)
  • Added INP (Interaction to Next Paint) to lab metrics -- replaced FID as Core Web Vital
  • Fixed dashicons/admin-bar auto-protected when admin bar is visible
  • Fixed ghost button hover text contrast
  • Fixed delay default trigger events: scroll + touchstart + click
  • Improved Settings and All Rules pages with modern card layout
  • Improved delay vs defer explanation in Settings

1.0.4

  • Plugin renamed to TW Perf Intelligence (slug unchanged: tw-performance)
  • Added third-party asset detection with "3rd party" badge and filter
  • Added auto-detected third-party origins card in Preloads tab
  • Added scope promotion for page rules (promote to post type or global)
  • Added Remove Google Fonts quick win toggle
  • Added Critical CSS textarea in Tools tab

1.0.3

  • Added frontend / admin / both context selector for unload rules
  • Added Font Preloads and Preconnect Origins sections
  • Added WP Quick Wins card
  • Added "Hide WP core" filter toggle
  • Multiple bug fixes and security improvements

1.0.0

  • Initial release

License

GPL-2.0+ -- see LICENSE

Built by TechWonders / PC Buddy 247