WPCalibrate LCP Repair Assistant
Diagnostic and surgical repair engine designed specifically for WordPress Largest Contentful Paint (LCP) bottlenecks.
Install
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/zeeshanraza-official/wpcalibrate-lcp-repair-assistant/archive/refs/heads/main.zipWPCalibrate LCP Repair Assistant
Diagnostic & Surgical Repair Engine for WordPress Largest Contentful Paint (LCP)
Surgical, controlled, non-destructive Core Web Vitals optimization. Diagnose bottlenecks, explain findings in plain English, apply surgical output fixes, and safely rollback anytime.
📖 About
WPCalibrate LCP Repair Assistant is a purpose-built WordPress performance plugin created to diagnose, inspect, and surgically repair Largest Contentful Paint (LCP) bottlenecks.
Unlike all-in-one caching or minification plugins that apply aggressive, opaque site-wide changes that often break layouts or scripts, WPCalibrate follows a controlled engineering philosophy:
Diagnose first → Explain bottlenecks in plain English → Recommend surgical repairs → Administrator confirms → Apply non-destructively via WordPress output filters → Verify before/after delta → Instant 1-click rollback.
Your database content, page builder JSON, and theme template files are never modified. All optimizations are applied at runtime using native WordPress filters and response hooks.
⚡ Why Largest Contentful Paint (LCP)?
Largest Contentful Paint is Google's primary Core Web Vitals loading metric, measuring how quickly the main visible content of a page is rendered:
- Good: $\le 2500\text{ ms}$ (2.5 seconds)
- Needs Improvement: $2501\text{ ms} - 4000\text{ ms}$
- Poor: $> 4000\text{ ms}$ (4.0 seconds)
The 4 Sub-Part Phases of LCP
WPCalibrate breaks down your LCP score into the exact 4 phases identified by the Chrome DevTools and Google Lighthouse teams:
- Time to First Byte (TTFB): Server response time, backend execution, and page cache delivery.
- Resource Load Delay: Time between page load start and when the browser discovers the LCP image.
- Resource Load Duration: Time taken for the browser to download the LCP asset over the network.
- Element Render Delay: Time between asset download completion and when pixels paint to the screen.
✨ Features
- 🔍 Google PageSpeed Insights v5 Integration: Run authentic mobile and desktop Lighthouse audits directly from your WordPress dashboard.
- ⏱️ Sub-Part Phase Analysis: Quantifies exact millisecond delays for TTFB, Load Delay, Load Duration, and Render Delay.
- 🎯 Targeted LCP Candidate Detection: Automatically inspects featured images, Gutenberg Cover/Image blocks, Elementor image widgets/containers, and WooCommerce product hero images.
- 🛠️ Controlled Output Repairs:
fetchpriority="high": Priority hint informing browser network schedulers to fetch the LCP asset immediately.- Native Lazy-Load Removal: Disables
loading="lazy"on above-the-fold hero images while preserving lazy-loading on all offscreen media. - Responsive Image Preload: Injects
<link rel="preload" as="image">withimagesrcsetandimagesizesinwp_head. - CSS Background Discovery: Preloads hero background images hidden inside external stylesheets or inline `