Static Cache Wrangler – Coverage Assistant

Coverage Assistant is a companion plugin for Static Cache Wrangler that helps you monitor which posts and pages have been cached as static HTML files.

Get instant visibility into your static cache coverage with a modern, card-based dashboard that shows:

• Coverage Percentage – See at a glance what % of your content is cached
• Uncached Content List – Identify exactly which pages need caching
• One-Click Copy Links – Copy uncached URLs to clipboard for manual caching
• GUI Crawler – Interactive browser-based crawler unlocks at 65% coverage
• Cache Statistics – View total files, cache size, and more

Perfect for site owners who want to ensure complete static site generation before deploying to CDN, Amazon S3®, or creating offline copies.

Key Features

• Visual Dashboard – Modern card-based UI with 4 key metrics
• Coverage Cards – Color-coded indicators (green/yellow/red) for quick status checks
• Uncached Content Table – Complete list with page titles, types, and last modified dates
• One-Click Copy Links – Copy uncached URLs to clipboard for manual caching
• GUI Crawler – Interactive browser-based crawler with progress tracking (unlocks at 65% coverage)
• Adaptive Throttling – Smart crawling speed adjusts to your server’s performance
• Recently Cached – See the last 10 pages that were successfully cached
• Auto-Cache Command – Use wp scw crawl-uncached to automatically cache all remaining pages
• WP-CLI Integration – Full command-line interface for coverage monitoring and automation
• Batch Processing – Concurrent crawling with --concurrency flag for faster cache generation
• Export URLs – wp scw uncached-urls outputs URLs for piping to external tools
• Zero Configuration – Works immediately after activation
• Clean Uninstall – Removes all data when plugin is deleted

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Static Cache Wrangler 2.0.5+ (parent plugin must be active)

Perfect For

• Site owners deploying to CDN or Amazon S3®
• Developers creating offline-ready static sites
• Agencies managing multiple static WordPress installations
• Anyone who wants to monitor cache generation progress
• Teams ensuring 100% coverage before launch

How It Works

1. Install and activate both Static Cache Wrangler and Coverage Assistant
2. Enable static site generation in Static Cache settings
3. Browse your site normally – pages are cached as you visit them
4. Check the Coverage Assistant dashboard to see progress
5. Use the uncached content list to identify pages that need caching
6. Click “Copy Link” buttons to copy URLs for manual visiting
7. NEW: At 65% coverage, unlock the GUI crawler to batch-process remaining pages
8. Alternative: Use wp scw crawl-uncached CLI command for fastest bulk caching

Additional Information

About the Author

Created by Derick Schaefer – Developer, writer, and WordPress enthusiast.

• Website: ModernCLI.dev
• GitHub: @derickschaefer

Related Plugins

• Static Cache Wrangler – Parent plugin (required)

Planned Features

• Custom post type support
• Multisite compatibility
• Configurable exclusion rules
• Advanced filtering options
• Enhanced reporting and analytics

Contributing

This is an open-source project. Contributions are welcome!

• GitHub Repository: https://github.com/derickschaefer/stcw-assistant
• Submit Issues: https://github.com/derickschaefer/stcw-assistant/issues
• Pull Requests: https://github.com/derickschaefer/stcw-assistant/pulls
• More details and examples: Modern CLI Book

License

This plugin is licensed under the GNU General Public License v2.0 or later.

Copyright (C) 2025 Derick Schaefer

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Trademark Recognition

Amazon S3® is a registered trademark of Amazon Technologies, Inc.

This plugin is not endorsed by, affiliated with, or sponsored by Amazon Technologies, Inc. or any trademark owners mentioned in this documentation.

Privacy Policy

Data Collection

This plugin does not:
* Collect any personal data
* Send data to external servers
* Use cookies or tracking
* Store user information

Data Storage

The plugin does not store any data in the WordPress database. All coverage statistics are calculated in real-time from your existing WordPress posts and pages. No historical data, user information, or statistics are stored.

This data is:
* Stored locally in your WordPress database
* Not shared with any third parties

GDPR Compliance

This plugin is GDPR compliant as it:
* Does not process personal data
* Does not track users
* Does not use cookies
* Stores only aggregate statistics locally

Technical Details

Database Usage

• No WordPress options created or stored
• No custom database tables created
• No database schema modifications
• Queries existing WordPress posts table only (read-only)
• Clean uninstall (nothing to remove)

Performance

• Lightweight – minimal resource usage
• Queries optimized with prepared statements
• No frontend performance impact
• Dashboard-only calculations (not run on frontend)
• GUI crawler uses adaptive throttling to prevent server overload

Security

• All database queries use $wpdb->prepare()
• All output escaped (esc_html, esc_url, esc_attr)
• All input sanitized (sanitize_text_field, sanitize_key, absint)
• Capability checks on all admin functions
• Nonce verification on all form submissions
• AJAX endpoints protected with nonce validation

Compatibility

• WordPress 5.0+
• PHP 7.4, 8.0, 8.1, 8.2, 8.3
• Compatible with all major themes
• Compatible with all major page builders
• Compatible with Static Cache Wrangler 2.0.5+

File Structure

stcw-coverage-assistant/
    stcw-coverage-assistant.php    Main plugin file
    LICENSE                        GPL v2+ license
    readme.txt                     This file
    uninstall.php                  Clean removal script
    includes/
        class-stcwca-core.php      Coverage calculation engine
        class-stcwca-cli.php       WP-CLI commands
        class-stcwca-crawler.php   Shared crawler logic
    admin/
        class-stcwca-admin.php     Admin dashboard controller
        css/
            admin-style.css        Modern UI styling
        js/
            admin-script.js        Copy Link functionality
            crawler.js             GUI crawler with adaptive throttling
        views/
            dashboard.php          Dashboard template

Code Quality

• Follows WordPress Coding Standards
• PHPCS compliant
• Plugin Check compliant
• Proper PHPDoc comments throughout
• Meaningful variable and function names
• DRY principles applied

Interested in learning more about command-line interfaces and WP-CLI?
Check out ModernCLI.dev — a practical guide to mastering modern CLI workflows.