Fixes asset processing reliability and ZIP packaging behavior. Recommended update for all users.<\/p>","2.1.4":"
Adds WordPress metadata injection to cached HTML files for improved headless CMS migration support. Backward compatible.<\/p>","2.0.6":"
Change all standard template variables to include the prefix stcw_ for WordPress.Org WordPress.NamingConventions.PrefixAllGlobals compliance.<\/p>","2.0.5":"
Enhanced multisite support with isolated directories per site. Storage moved to wp-content\/cache\/stcw_static\/ with unique namespace. Fully backward compatible for new installs. WordPress.org compliant.<\/p>","2.0.4":"
Major compliance update. Plugin renamed to Static Cache Wrangler. Clear old plugin before installing. All prefixes changed from SCG to STCW. No data migration needed as plugin not yet published.<\/p>","2.0.3":"
WordPress.org compliance. All prefixes changed to STCW (4+ characters). Clear and regenerate static files after update. WP-CLI commands unchanged.<\/p>","2.0":"
Major rewrite with modern standards, WP_Filesystem support, and enhanced security. Recommended for all users.<\/p>\n\n
Static Cache Wrangler<\/em><\/strong> is a lightweight, low\u2011resource static site generator<\/em> and HTML export engine<\/em> for WordPress. It automatically creates self\u2011contained, URL\u2011agnostic static pages<\/em><\/strong> of your site \u2014 perfect for anyone who needs to preserve, distribute, or accelerate WordPress content<\/em><\/strong>.<\/p>\n\n Originally developed as a command\u2011line tool for WP\u2011CLI<\/em><\/strong>, it has evolved into composable, zero\u2011impact tooling that supports administrators, developers, and site owners alike. Whether you're archiving a client project, deploying to a CDN, or creating a portable offline version that runs anywhere, Static Cache Wrangler delivers fast, CDN\u2011ready HTML output without complex setup.<\/p>\n\n Technically, the plugin uses an asynchronous, lazy\u2011loading build mechanism<\/em> that generates static pages as visitors browse your site. Over time, your entire site is exported as lightweight static HTML. Unlike traditional static\u2011site plugins that require full crawls or database schema changes, Static Cache Wrangler is zero\u2011impact<\/em><\/strong>:\n* Does not<\/strong> add custom database tables or modify your schema Perfect for:<\/em><\/strong>\n* Creating fully offline or portable copies of WordPress sites A demo site created using this plugin can be found at Cache Wrangler Demo Site<\/a> which is a static version of this WordPress site<\/a><\/p>\n\n Static Cache Wrangler<\/em><\/strong> turns WordPress into a fast, secure, and portable static\u2011site generator \u2014 with no database changes<\/strong>, no vendor lock\u2011in<\/strong>, and no maintenance overhead<\/strong>.<\/p>\n\n Detailed Testing and Profiling:<\/strong>\n* Triggering of page rendering requires 1-2MB of PHP memory for the duration of the process.\n* Average processing duration is less than 500 ms (meaning memory consumption is quickly released)\n* Average asset (JS, CSS, image) batch processing is less than 100 ms\n* WordPress Core and theme rendering is generally 20-25 MB; SCW usage keeps total memory below 30 MB\n* CLI commands are even more efficient<\/p>\n\n Funding Model<\/strong>\n* This plugin and all companion plugins will remain 100% free (true WordPress style)\n* Want to make a donation? Consider purchasing a copy of the author's book on command-line interfaces for yourself or as a gift.<\/p>\n\n Modern CLI Book<\/a><\/p>\n\n\n\n What's New in 2.1.6:<\/strong><\/p>\n\n Version 2.1.6 Adds ghost file protection for environments where PHP memory based failures cause the HTML generation process to fail rendering blank HTML files.<\/p>\n\n What's New in 2.1.5:<\/strong><\/p>\n\n Version 2.1.5 fixes auto asset processing script loading, ensures What's Fixed in 2.1.3:<\/strong><\/p>\n\n Version 2.1.3 fixes errantly cached files and directories related to index.php and admin in URLs.<\/p>\n\n What's New in 2.1.2:<\/strong><\/p>\n\n Version 2.1.2 introduces configuration details<\/strong> in addition to file locations<\/strong> on a key admin card.<\/p>\n\n What's New in 2.1.1:<\/strong><\/p>\n\n Version 2.1.1 introduces cache file timestamps<\/strong>, staleness checks<\/strong>, and adds sitemap creation<\/strong> to both the GUI and CLI zip file creation.<\/p>\n\n What's New in 2.1.0:<\/strong><\/p>\n\n Version 2.1.0 introduces static sitemap generation<\/strong> - a file system-based approach that creates sitemaps from your actual cached files rather than the WordPress database.<\/p>\n\n This update enables true static sitemaps that work in exported sites without WordPress, PHP, or a database connection - perfect for deployments to S3, Netlify, GitHub Pages, or any static hosting platform.<\/p>\n\n New WP-CLI Commands<\/strong><\/p>\n\n Why File System-Based?<\/strong><\/p>\n\n Traditional WordPress sitemap plugins (Yoast SEO, Rank Math) query the database dynamically. This works great for live sites, but fails for static exports because there's no PHP or database available.<\/p>\n\n Static Cache Wrangler scans your actual cached index.html files to build the sitemap, ensuring:<\/p>\n\n Sitemap Features<\/strong><\/p>\n\n Typical Workflow<\/strong><\/p>\n\n wp scw enable # Enable generation<\/p>\n\nBrowse your site...\n\n wp scw process # Process assets\nwp scw sitemap # Generate sitemap (NEW!)\nwp scw zip # Export with sitemap included<\/p>\n\nDeploy to S3\/Netlify...\n\n View in Browser<\/strong><\/p>\n\n Open https:\/\/your-site.com\/sitemap.xml - the XSL stylesheet transforms it into a readable HTML table with color-coded priorities and sortable columns.<\/p>\n\n Technical Implementation<\/strong><\/p>\n\n GUI Coming Soon<\/strong><\/p>\n\n This release is CLI-only to validate the approach and gather user feedback. A visual interface in WordPress admin is planned for version 2.2.0.<\/p>\n\n Compatibility<\/strong><\/p>\n\n What's New in 2.0.7:<\/strong><\/p>\n\n Version 2.0.7 is a major compatibility enhancement release<\/strong>, focused on improving support for Kadence Blocks and all Gutenberg block plugins that rely on dynamic JavaScript and CSS enqueues.<\/p>\n\n This update improves the accuracy of static exports by capturing all front-end assets that WordPress prints dynamically<\/strong>\u2014including those output by Compatibility Improvements<\/strong><\/p>\n\n Technical Enhancements<\/strong><\/p>\n\n Full control without the dashboard:<\/p>\n\n Typical Usage:<\/strong>\n* Small site (10-50 pages): 50-200 MB\n* Medium site (100-500 pages): 200 MB - 1 GB Monitor disk usage via Settings \u2192 Static Cache or To reduce disk usage, exclude large pages:\n add_filter('stcw_should_generate', function($should, $url) {\n if (strpos($url, '\/gallery\/') !== false) {\n return false;\n }\n return $should;\n }, 10, 2);<\/p>\n\n \u2705 CSS files, JavaScript files, Images (all formats), Fonts, Favicons, Responsive images (srcset)<\/p>\n\n \u274c External CDN assets (preserved as-is), Third-party embeds (YouTube, Twitter), Video\/audio files (intentionally excluded to save space)<\/p>\n\n\n\n Offline Documentation<\/strong> \u2014 Generate static, portable documentation sites for offline or air-gapped environments. All product names, logos, and brands referenced in this plugin and its documentation are property of their respective owners.<\/p>\n\n Static Cache Wrangler<\/strong> (also historically referred to as Static Cache Generator<\/strong>) must always be referenced using all three words \u2014 \u201cStatic Cache Wrangler.\u201d<\/strong><\/p>\n\n The prior name Static Cache Generator<\/strong> is considered a legacy name<\/em> and is no longer in use, as it did not meet WordPress.org plugin naming standards<\/a> due to its generic nature. That name was originally selected in good faith to avoid any potential confusion with existing trademarks or brand names.<\/p>\n\n Prior to renaming, U.S. and international trademark databases<\/strong> were reviewed by independent intellectual property counsel<\/strong>, and no conflicts or registered marks<\/strong> were identified for the phrases \u201cStatic Cache Generator,\u201d \u201cCache Generator,\u201d<\/strong> or \u201cStatic Cache.\u201d<\/strong> The current and accepted plugin name Static Cache Wrangler<\/strong>: This clarification is provided in accordance with U.S. trademark law<\/strong>, WordPress.org plugin repository policies<\/strong>, and general principles of fair use and naming transparency. NGINX\u00ae is a registered trademark of F5, Inc. This plugin has not been tested by any of the services, platforms, software projects, nor their respective owners. This plugin is an independent open-source project and is not endorsed by, affiliated with, or sponsored by<\/strong> any of the companies or open-source projects mentioned herein.<\/p>\n\n\n\n For issues, requests, and documentation, visit:
\nFree companion plugin STCW Coverage Assistant<\/a> adds real\u2011time build monitoring and manually triggered full\u2011site generation for any uncached pages.<\/p>\n\n
\n* Automatically cleans up all plugin options, cron jobs, and transients upon uninstall
\n* Keeps your WordPress database completely untouched
\n* Runs all caching processes asynchronously<\/strong> in the background
\n* Offers an optional performance profiler<\/strong> for granular resource and execution insights<\/p>\n\n
\n* Rsyncing to read\u2011only Nginx failover servers for high availability
\n* Publishing WordPress content to Amazon\u202fS3\u00ae, Netlify\u00ae, or other static CDNs
\n* Geo\u2011distributing static HTML for ultra\u2011fast global reads
\n* Archiving, demos, and secure client deliverables
\n* Small to mid\u2011sized sites (\u2248\u202f100\u202fpages\u202f+) \u2014 upcoming assistant plugin expands this to 1\u202fK\u202fpages
\n* Multisite administrators needing scalable static\u2011cache exports<\/p>\n\nHow It Works<\/h3>\n\n
\n
index.html<\/code> in any browser \u2014 it works completely offline.<\/li>\n<\/ol>\n\n\n\nKey Features<\/h3>\n\n
2.1.6<\/h4>\n\n
2.1.5<\/h4>\n\n
STCW_ASYNC_ASSETS<\/code> false mode processes assets immediately, prevents endless retries for failed asset downloads, and removes duplicate assets in ZIP exports.<\/p>\n\n2.1.3<\/h4>\n\n
2.1.2<\/h4>\n\n
2.1.1<\/h4>\n\n
2.1.0<\/h4>\n\n
\n
wp scw sitemap<\/code> - Generate sitemap.xml from cached static files<\/li>\nwp scw sitemap-delete<\/code> - Remove sitemap files<\/li>\n<\/ul>\n\n\n
\n
stcw_sitemap_changefreq<\/code><\/li>\n`\n<\/code><\/pre>\n\n`\n<\/code><\/pre>\n\n\n
\n
2.0.7<\/h4>\n\n
wp_print_scripts()<\/code> and wp_print_footer_scripts()<\/code>\u2014ensuring that interactive block functionality is preserved outside of WordPress.<\/p>\n\n\n
\n
\n
wp_print_head_scripts()<\/code><\/li>\nwp_print_scripts()<\/code><\/li>\nwp_print_footer_scripts()<\/code><\/li>\n<\/ul><\/li>\nWP-CLI Commands<\/h3>\n\n
\n
wp scw enable<\/code> \u2013 Enable static generation <\/li>\nwp scw disable<\/code> \u2013 Disable static generation <\/li>\nwp scw status<\/code> \u2013 View current status and statistics <\/li>\nwp scw process<\/code> \u2013 Process all pending assets <\/li>\nwp scw clear<\/code> \u2013 Remove all generated static files <\/li>\nwp scw zip<\/code> \u2013 Create a ZIP archive of the site <\/li>\nwp scw sitemap<\/code> \u2013 Generate sitemap.xml from cached files<\/li>\nwp scw sitemap --target-url=<url><\/code> \u2013 Generate sitemap for deployment URL<\/li>\nwp scw sitemap-delete<\/code> \u2013 Remove sitemap files<\/li>\n<\/ul>\n\n\n\nAdvanced Configuration<\/h3>\n\n
Server Requirements<\/h3>\n\n
\n
wp-content\/cache\/<\/code><\/li>\n<\/ul>\n\nPerformance Characteristics<\/h3>\n\n
\n
Disk Space Considerations<\/h3>\n\n
\n* Large site (1000+ pages): 1-5 GB<\/p>\n\nwp scw status<\/code>.<\/p>\n\nWhat Gets Downloaded<\/h3>\n\n
Use Cases<\/h3>\n\n
\nClient Deliverables<\/strong> \u2014 Deliver static versions that eliminate hosting complexity.
\nFailover Ready<\/strong> \u2014 Rsync to a read-only Nginx\u00ae server for uninterrupted uptime.
\nCDN \/ Amazon S3\u00ae Deployment<\/strong> \u2014 Publish static HTML to Amazon S3\u00ae, Cloudflare\u00ae, or Netlify\u00ae for instant global delivery.
\nGeo Load Balancing<\/strong> \u2014 Serve from multiple regions with Cloudflare or Amazon Route53\u00ae for high performance.
\nArchival Snapshots<\/strong> \u2014 Capture your site before major redesigns or migrations.<\/p>\n\n\n\nTrademark Recognition and Legal Disclaimer<\/h3>\n\n
\nCounsel further cited legal precedent confirming that generic terms cannot be trademarked, including:
\n- USPTO v. Booking.com B.V.<\/em>, 591 U.S. ___ (2020)
\n- In re Hotels.com, L.P.<\/em>, 573 F.3d 1300 (Fed. Cir. 2009)
\n- Kellogg Co. v. National Biscuit Co.<\/em>, 305 U.S. 111 (1938)<\/p>\n\n
\n- Does not<\/strong> imply, refer to, or associate with the standalone trademark \u201cWrangler\u201d<\/strong> of Wrangler Apparel<\/strong>.
\n- Does not<\/strong> imply, refer to, or associate with the standalone trademark \u201cCache\u201d<\/strong> (U.S. Reg. No. 6094619<\/strong>, registered July 7, 2020).
\n- Does not<\/strong> imply, refer to, or associate with any trademarks involving the standalone term \u201cStatic.\u201d<\/strong>
\n- Has no connection<\/strong> with Automattic Inc.<\/strong>, its employees, or any internal job titles (e.g., \u201cWrangler\u201d) used within Automattic. The name Static Cache Wrangler<\/strong> does not suggest endorsement, employment, or automation of work performed by Automattic personnel.<\/p>\n\n
\n(U.S. Reg. No. 6094619 reference: \u201cCACHE,\u201d Registered July 7, 2020; Status: LIVE\/REGISTRATION\/Issued and Active \u2014 TSDR, generated 2025-10-23 08:17:17 EDT.)<\/em><\/p>\n\n\n\nThird-Party Trademark Notices<\/h3>\n\n
\nAmazon S3\u00ae and Route 53\u2122 are trademarks of Amazon Technologies, Inc.
\nNetlify\u00ae is a registered trademark of Netlify, Inc.
\nCloudflare\u00ae and Cloudflare Pages\u2122 are trademarks of Cloudflare, Inc.
\nWP-CLI\u00ae and Gutenberg\u00ae are trademarks of the WordPress Foundation.
\nElementor\u00ae is a registered trademark of Elementor Ltd.
\nDivi\u00ae is a registered trademark of Elegant Themes, Inc.
\nGitHub\u00ae is a registered trademark of GitHub, Inc.
\nYouTube\u00ae is a registered trademark of Google LLC.
\nTwitter\u00ae is a registered trademark of X Corp.
\nModernCLI.Dev is owned by Derick Schaefer.<\/p>\n\n
\nThese names and services are referenced solely as examples of where static cache files might be repurposed, used, uploaded, stored, or transmitted.<\/p>\n\nSupport<\/h3>\n\n
\nGitHub \u2013 Static Cache Wrangler<\/a>\nDocumentation & Guides<\/a><\/p>\n\n\n\n