Performance Toolkit

website·Indexed 30 days ago

https://docs.pivotlabs.dev

A comprehensive WordPress optimization and caching plugin designed to improve site speed and stability. Key features include page caching, asset minification and combination, image lazy loading, database optimization, and Cloudflare CDN integration.

Tokens
10.1K
Snippets
21
Records
83
Agent score
50%

What's inside Performance Toolkit

  1. Overview of Minification in Performance Toolkit

    Minification reduces file sizes by 20-50% by removing unnecessary characters such as whitespace and comments from CSS, JavaScript, and HTML files without altering their functionality. Typical reductions include 20-40% for CSS, 20-50% for JS, and 10-20% for HTML.
    // Original (220 bytes)
    function calculateTotal(items) {
      // Loop through items and sum prices
      let total = 0;
      for (let i = 0; i < items.length; i++) {
        total += items[i].price;
      }
      return total;
    }
    
    // Minified (110 bytes)
    function calculateTotal(items){let total=0;for(let i=0;i<items.length;i++)total+=items[i].price;return total;}
  2. Overview of Performance Toolkit for WordPress

    Performance Toolkit is a comprehensive WordPress plugin designed to optimize site performance. It provides tools for intelligent caching, asset optimization, CDN integration, and performance monitoring to reduce server load, improve Core Web Vitals, and decrease bandwidth usage.
  3. Optimize WordPress site speed with Performance Toolkit

    The Performance Toolkit provides a suite of optimization features for WordPress sites, including page caching, asset minification and combination, image lazy-loading, and CDN integration to improve overall site performance.
  4. Use Smart Cache Preload Engine (Pro)

    The Pro engine provides orchestration, reliability, and operational controls for larger sites and agency workflows that require complex queue management and scheduling.

    Key Capabilities:

    • Triggers: Scheduled warmups and advanced event-based warmups (post-update, taxonomy changes, deploy/webhooks).
    • URL Discovery: Full sitemap processing, discovered related URLs, and custom seed lists.
    • Queue Management: Persistent URL queue with status lifecycles, priority handling (critical URLs first), and configurable queue strategies.
    • Reliability & Performance: Retries with backoff, failure classification, concurrency settings, and request pacing/rate limits.
    • Operational Control: Ability to pause, resume, or cancel preloads.
    • Observability: Detailed preload history, per-URL status/timing, and error summaries.
  5. Use Basic Cache Preloading (Free)

    The Free version of the cache preload tool provides a simple, bounded warmup flow to reduce cold cache hits after a purge. It is suitable for small sites requiring a single-pass warmup of a limited URL set.

    Included Capabilities:

    • Trigger warmup after manual cache purges.
    • Warmup of the homepage and a small set of key URLs configured via the plugin.
    • Limited sitemap warmup (capped at the first N URLs).
    • Basic outcome feedback (started/completed/failed summary).
  6. Understand how script deferral improves page performance

    Script deferral prevents JavaScript from blocking page rendering during download and execution. By delaying non-critical scripts, the page HTML renders immediately, allowing users to see content and interact with the page while scripts load in the background. This significantly reduces perceived load time and improves metrics like First Input Delay (FID) and Largest Contentful Paint (LCP).
  7. Monitor site performance via the System Status dashboard

    The System Status page provides a comprehensive overview of site health across four main categories:

    • Cache Metrics: Tracks cache enabled status, total cached pages, disk space used by cache, cache hit rate, and purge history.
    • Performance Metrics: Monitors average page load time (cached), database query time, PHP execution time, and Time to First Byte (TTFB).
    • Optimization Status: Shows the active state (✅/❌) of Page caching, Minification, Defer scripts, Lazy load images, and CDN integration, along with pending recommendations.
    • System Information: Displays versions for PHP, MySQL/MariaDB, WordPress, and Performance Toolkit, as well as available disk space, memory usage, and server uptime.
  8. Understand how Performance Toolkit page caching works

    Page caching stores rendered HTML pages on disk to serve repeat visitors instantly, bypassing the database and PHP engine. This typically reduces page load times from 500-2000ms down to 50-200ms. The lifecycle is: first visitor triggers a normal render $\rightarrow$ HTML is saved to disk $\rightarrow$ repeat visitors receive cached HTML $\rightarrow$ cache expires based on the configured TTL $\rightarrow$ next visitor triggers a fresh render.
  9. Manage and clear the page cache

    You can manage the cache through the following methods:

    • Viewing Status: Go to Performance Toolkit $\rightarrow$ System Status to monitor total cached pages, cache size (MB), cache hit rate percentage, and the last purge timestamp.
    • Manual Clearing: Go to Performance Toolkit $\rightarrow$ Tools and click Clear All Cache to delete all cached files.
    • Automatic Purging: The plugin automatically purges specific URLs on post/page updates or the post associated with a comment approval. Global cache is purged when plugin settings change.
  10. Run Google Lighthouse tests

    Trigger a Google Lighthouse test for Mobile or Desktop directly from the plugin to get a performance score (0-100), Core Web Vitals, and specific fix recommendations.
    1. Go to Tools
    2. Click Run Lighthouse Test
    3. Select Mobile or Desktop
  11. Deploy Cloudflare integration using a staged rollout strategy

    To ensure stability and verify performance gains when integrating Cloudflare with the Performance Toolkit, follow this deployment sequence: first deploy to a staging environment for testing, monitor the Dashboard and System Status metrics, verify that performance improvements are realized, and only then roll out the configuration to production. Continuous monitoring of performance metrics should be maintained after the production release.
    1. Set up on staging first to test
    2. Monitor Dashboard and System Status metrics
    3. Verify performance improvements
    4. Roll out to production when confident
    5. Continue monitoring performance metrics