Static Cache Wrangler - Coverage Assistant
| 开发者 | derickschaefer |
|---|---|
| 更新时间 | 2025年12月13日 22:20 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
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
- 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-uncachedto automatically cache all remaining pages - WP-CLI Integration - Full command-line interface for coverage monitoring and automation
- Batch Processing - Concurrent crawling with
--concurrencyflag for faster cache generation - Export URLs -
wp scw uncached-urlsoutputs URLs for piping to external tools - Zero Configuration - Works immediately after activation
- Clean Uninstall - Removes all data when plugin is deleted
- WordPress 5.0 or higher
- PHP 7.4 or higher
- Static Cache Wrangler 2.0.5+ (parent plugin must be active)
- 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
- Install and activate both Static Cache Wrangler and Coverage Assistant
- Enable static site generation in Static Cache settings
- Browse your site normally - pages are cached as you visit them
- Check the Coverage Assistant dashboard to see progress
- Use the uncached content list to identify pages that need caching
- Click "Copy Link" buttons to copy URLs for manual visiting
- NEW: At 65% coverage, unlock the GUI crawler to batch-process remaining pages
- Alternative: Use
wp scw crawl-uncachedCLI command for fastest bulk caching
安装:
Automatic Installation
- Log in to your WordPress admin panel
- Navigate to Plugins > Add New
- Search for "Static Cache Wrangler - Coverage Assistant"
- Click Install Now then Activate
- Ensure Static Cache Wrangler is also installed and activated
- Navigate to Static Cache > Coverage Assistant
- Download the plugin ZIP file
- Log in to your WordPress admin panel
- Navigate to Plugins > Add New > Upload Plugin
- Choose the downloaded ZIP file
- Click Install Now then Activate
- Ensure Static Cache Wrangler is also installed and activated
- Navigate to Static Cache > Coverage Assistant
- Go to Settings > Static Cache and enable static generation
- Browse your site to generate some cached pages
- Go to Static Cache > Coverage Assistant to view your dashboard
屏幕截图:
常见问题:
Does this work without Static Cache Wrangler?
No, this is a companion plugin that requires Static Cache Wrangler 2.0.5 or higher to be installed and activated. It will show an admin notice if the parent plugin is missing.
How often is coverage data updated?
Coverage statistics are calculated in real-time when you visit the dashboard.
What data does this plugin store?
This plugin does not store any persistent data in the WordPress database. All coverage statistics are calculated in real-time when you view the dashboard. No options, settings, or historical data are saved.
Does this plugin cache anything itself?
No, this plugin only monitors caching done by Static Cache Wrangler. It does not perform any caching operations itself.
How do I know which pages need caching?
The dashboard shows an "Uncached Content" table listing all posts and pages that haven't been cached yet. Each row includes a "Copy Link" button to copy the URL to your clipboard for easy visiting.
What is the GUI crawler and how do I unlock it?
The GUI crawler is an interactive, browser-based tool that automatically visits and caches your uncached pages. It unlocks when you reach 65% cache coverage. This threshold ensures you've naturally cached the most important pages first, and the crawler is used only to finish the remaining less-visited pages.
You can adjust this threshold in wp-config.php:
php
define('STCWCA_GUI_CRAWLER_THRESHOLD', 70); // Default is 65
How fast is the GUI crawler?
The GUI crawler uses adaptive throttling to respect your server's capabilities. It automatically speeds up on fast servers and slows down if errors occur. Typical processing speed is 1-2 pages per second, adjusting in real-time based on server response times.
Can I exclude certain pages from the uncached list?
Not currently, but this is planned for a future version. The plugin currently shows all published posts and pages.
Does this work with custom post types?
Currently, the plugin only monitors standard posts and pages. Custom post type support is planned for a future release.
How can I get 100% coverage quickly?
- Enable static generation in Static Cache Wrangler
- Visit the Coverage Assistant dashboard
- Choose your preferred method:
- Fastest (CLI): Run
wp scw crawl-uncached --concurrency=4to auto-cache everything - Browser-based: Once you reach 65% coverage, use the GUI crawler to finish remaining pages
- Manual: Click "Copy Link" on each uncached page and visit them in a browser
- Check progress with
wp scw coverageor refresh the dashboard
crawl-uncached CLI command is the fastest way to achieve 100% coverage - it automatically visits all uncached URLs to trigger static file generation.
What WP-CLI commands are available?
Coverage Assistant extends the wp scw-coverage namespace with the following commands:
wp scw-coverage stats– Show coverage statistics (supports--format=json,csv,yaml)wp scw-coverage list– List all uncached URLs with filtering optionswp scw-coverage urls– Export URLs for piping to external crawlers or automationwp scw-coverage crawl– Automatically visit and cache all uncached URLs
What happens if I uninstall the plugin?
The plugin stores no persistent data, so uninstalling simply removes the plugin files. Your static cached files created by Static Cache Wrangler remain completely untouched and continue to function normally.
Is this compatible with multisite?
Not tested yet. Multisite compatibility is planned for a future release.
Where can I get support?
For issues, feature requests, and general support:
更新日志:
1.1.0 2025-12-13
WP-CLI Namespace Refactor (Breaking Change)
- Refactored WP-CLI command namespace to
wp scw-coveragefor consistency with the parent plugin and upcoming companion plugins - Improved long-term maintainability and discoverability of CLI commands
- Breaking change: Existing
wp scwcoverage-related commands must be updated to the new namespace
- Thorough testing with WordPress 6.9 release
- Card layout alignment fixes in both CSS and dashboard implementation
- Introduced interactive GUI crawler for browser-based batch caching
- GUI crawler unlocks at 65% coverage (configurable via wp-config.php)
- Adaptive throttling automatically adjusts crawl speed to server performance
- Real-time progress tracking with success/error counts
- Smart delay calculation prevents server overload
- Copy clarifications on multiple UI cards
- Readme updates and corrections
- Removed legacy trend tracking feature (not actively used)
- Introduced
wp scwCLI commands for coverage management: wp scw coverage– Display current cache stats (table, JSON, CSV, YAML)wp scw uncached– List uncached pages/posts with filtering and formatswp scw uncached-urls– Export uncached URLs for external crawlerswp scw crawl-uncached– Automatically crawl and cache all missing pages- CLI output includes warning indicators, progress bars, and real-time status
- Ideal for CI/CD pipelines, cron jobs, and batch caching automation
- Extensive format and concurrency options for advanced scripting
- Added display of total cached file count and total content items
- New metric for cache size in MB added to dashboard
- Improved support for custom file paths during coverage analysis
- Admin UI: tooltip hints added to clarify coverage formula
- Fixed bug with incorrect uncached post count in rare conditions
- Escaped all admin output strings for WordPress.org security compliance
- Removed legacy helper functions and optimized data handling
- Improved compatibility with Static Cache Wrangler 2.0.5
- Refined coverage percentage calculation logic for mixed post statuses
- Added logic to exclude drafts, private posts, and trashed items from stats
- Reduced database queries on the dashboard by ~30% for faster load
- Fixed issue where some pages were misidentified as uncached
- Added "Last Cached" timestamp to recently cached list
- Adjusted color thresholds for coverage indicators (green/yellow/red)
- Internal refactoring of coverage engine for extensibility
- Minor styling tweaks for better mobile admin view
- Coverage percentage calculation and display
- Uncached content identification and listing
- Recently cached content display
- Modern card-based dashboard UI
- Color-coded status indicators (green/yellow/red)
- One-click "Copy Link" buttons for uncached pages
- Quick actions sidebar
- WordPress.org coding standards compliance
- Clean uninstall support
- Full i18n/translation readiness