Atte Liimatainen

Converts frontend to JSON response when request is done with certain conditions.
<h3>Inspiration</h3>
After creating a bunch of headless WordPress + Web app stacks, I wanted to find a standard and a all-round solution for fetching per page information for web applications inside WordPress. Built-in rest api works fine in basic cases, but it doesn’t support querying by path. Usually this meant that for each project developers would create a custom rest endpoint which would return expected content using content type and slug parameters.
WordPress has few built-in functions to retrieve content by path, <a href="https://developer.wordpress.org/reference/functions/url_to_postid/" rel="nofollow ugc">url_to_postid</a> and <a href="https://developer.wordpress.org/reference/functions/get_page_by_path/" rel="nofollow ugc">get_page_by_path</a>, but they don’t seem to work with multilanguage plugins, taxonomy or archive pages, which means that WP doesn’t have a reliable way to fetch content this way through rest api.
This plugin converts frontend to JSON which seems after above solution the best way to do things, with added layer of security through application passwords (WordPress v5.6 feature) and a filter, which let’s developers alter outgoing data.
<h3>How to start using the plugin</h3>
<ul>
<li>Install and activate this plugin in your environment</li>
<li>Create application password for a user with administrator role</li>
</ul>
After above steps have been made, make a request to a page with added <a href="https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side" rel="nofollow ugc">Authorization header</a>. See data fetching examples at the end of this documentation for more help
<h3>Modifying the output</h3>
Plugin outputs current page’s Post object or null. This can be modified using <code>headless-converter-modify-data</code>-filter. You can either modify passed in post object or do your own logic like in the example below.
<pre><code>/**
 * Modifies Headless Converter plugin's output.
 * 
 * @param WPPost|null $post - Current template's post object 
 */
function modify_headless_converter_output($post) {
 if(is_404()) {
 return "this block renders 404 page content";
 } else if(is_page()) {
 return "this block renders page post types content";
 } else if (is_singular('post')) {
 return "this block renders single post content";
 } else if(is_home()) {
 return "this block renders post archive";
 } else {
 return $post;
 }
}

add_filter('headless-converter-modify-data', 'modify_headless_converter_output');
</code></pre>
<h3>Data fetching examples</h3>
<h4>Fetch</h4>
<pre><code>const username = "admin"
const password = "1111 1111 1111 1111 1111"
const url = "http://localhost:3000/?page_id=2"
const opts = {
 headers: {
 'Authorization': 'Basic ' + btoa(username + ":" + password) 
 }, 
}
fetch(url, opts).then(r => r.json()).then(console.log)
</code></pre>
<h4>Axios</h4>
<pre><code>const axios = require("axios")

const username = "admin"
const password = "1111 1111 1111 1111 1111"
const url = "http://localhost:3000/?page_id=2"
const opts = {
 auth: {
 username,
 password
 }
}

axios(url, opts).then(r => r.data).then(console.log)
</code></pre>

Headless Converter

Converts frontend to JSON response when request is done with certain conditions.

derickschaefer

Static Cache Wrangler – Headless Assistant is a companion plugin for <a href="https://wordpress.org/plugins/static-cache-wrangler/" rel="ugc">Static Cache Wrangler</a> that converts cached HTML files into headless CMS-compatible formats for modern headless CMS workflows. This plugin requires WP-CLI and is intended for developers and administrators who have good working knowledge of operating in shell environments with traditional Linux stream processing commands (e.g. sed, grep, awk, sort) and a willingness to explore the WordPress command-line interface. This plugin enables composable, command-line interface tooling and IS NOT a point and click solution.
<h4>Testing Results</h4>
Tested on cachewrangler.com (15-page WordPress site):
<ul>
<li>☑ 74% semantic conversion rate – 564 blocks converted to structured content</li>
<li>☑ 15 pages converted successfully to Sanity format</li>
<li>☑ 763 links preserved with proper structure and references</li>
<li>☑ 36 images tracked with migration metadata</li>
<li>☑ 14 accordions converted semantically</li>
<li>☑ 13 tables converted semantically</li>
</ul>
Top Conversion Rates Achieved: 
* Simple pages: 86% semantic conversion 
* Complex pages with mixed content: 74-82% 
* Ultimate test page (141 blocks, 23 different Kadence block types): 52%
What Falls Back to HTML (requires custom hooks): 
* Navigation menus (by design – preserves styling) 
* Advanced Kadence blocks (countdown, forms, testimonials, maps, etc.) 
* Premium block libraries (Otter, Spectra – requires additional detectors)
<h4>Extensible Architecture</h4>
Unlike hardcoded solutions, this plugin uses a pluggable engine system where CMS targets can be registered via filters. Ships with Sanity® CMS support (unofficial) out of the box. It is technically feasible to target Contentful, Strapi, and others via extensions.
Sanity® is a registered trademark of Sanity.io. This project is not affiliated with or endorsed by Sanity.io.
<h4>Features</h4>
Direct Sanity CMS Conversion: 
* WordPress → Sanity NDJSON export 
* Pattern detection for Gutenberg blocks 
* Schema generation for Sanity Studio 
* Asset tracking and manifest 
* Command: <code>wp scw-headless convert --cms=sanity</code>
Smart Pattern Detection: 
* 12 core Gutenberg patterns 
* 28 Kadence Blocks patterns 
* XPath-based detection with confidence scoring 
* Priority-based matching for nested structures 
* Pattern inheritance system
CLI-First Experience: 
* <code>wp scw-headless scan</code> – View cached files 
* <code>wp scw-headless analyze <file></code> – Detect patterns 
* <code>wp scw-headless convert --cms=sanity</code> – Export to Sanity 
* <code>wp scw-headless patterns</code> – List registered patterns 
* <code>wp scw-headless detectors</code> – Show detector modules 
* <code>wp scw-headless targets</code> – List available CMS platforms 
* <code>wp scw-headless info</code> – Show plugin statistics
<h4>Future Roadmap Considerations</h4>
Generic Portable Text Output: 
* CMS-agnostic JSON format 
* Support for any Portable Text consumer 
* Command: <code>wp scw-headless normalize</code> 
* Non-WP analyzer and converter tooling
Advanced Pattern Detection: 
* 40+ patterns including Kadence Blocks 
* ACF field support (roadmap) 
* Page builder compatibility (roadmap) 
* Custom pattern registration
Multi-CMS Support: 
* Sanity (today) 
* Strapi (horizon) 
* Contentful (horizon) 
* Payload CMS (horizon) 
* Any Portable Text consumer (roadmap)
<a href="https://wp2headless.com/" rel="nofollow ugc">Learn more about planned features features</a>
Funding Model 
* This plugin is 100% free (true WordPress style) 
* Want to make a donation? Consider purchasing a copy of the author’s book on command-line interfaces for yourself or as a gift.
<a href="https://moderncli.dev" rel="nofollow ugc">Modern CLI Book</a>
<h4>Pattern Detection System</h4>
Built-in Detector Modules:
Gutenberg Core – 12 patterns: 
* heading, paragraph, image, gallery, video 
* list (ordered/unordered), quote, code 
* button, buttons, separator, table
Kadence Blocks – 28 patterns: 
* accordion, tabs, advanced_button, progress_bar 
* icon_list, infobox, countdown, rowlayout 
* column, advanced_heading, form, testimonials 
* posts, table_of_contents, google_maps, lottie 
* image, video_popup, advanced_gallery, navigation 
* icon, spacer, show_more, search, identity 
* table, vector, countup
Extensible via Filters: 
 <code>php 
// Register custom patterns 
add_action('stcw_headless_patterns_loaded', function() { 
 \STCW\Headless\Engine\Detector\PatternRegistry::register('custom_block', [ 
 'selectors' => ['.my-custom-block'], 
 'extractor' => [MyExtractor::class, 'extract'], 
 'priority' => 8, 
 'confidence' => 0.95, 
 ]); 
});</code>
<h4>How It Works</h4>
<ol>
<li>Cache your WordPress site with Static Cache Wrangler </li>
<li>Scan cached files: <code>wp scw-headless scan</code> </li>
<li>Analyze patterns: <code>wp scw-headless analyze /page/</code> </li>
<li>Convert:
<ul>
<li>Free: <code>wp scw-headless convert --cms=sanity</code></li>
</ul>
</li>
</ol>
<h4>Supported CMS Targets</h4>
Included: 
* Sanity CMS – Full Portable Text conversion with schema generation
<h4>Perfect For</h4>
<ul>
<li>Migrating WordPress content to headless CMS platforms </li>
<li>JAMstack architecture with WordPress as authoring tool </li>
<li>SEO component analysis</li>
<li>UI pattern analysis</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>WordPress 6.0 or higher </li>
<li>PHP 7.4+ (PHP 8.x fully supported) </li>
<li>Static Cache Wrangler 2.0.5+ (must be installed and active) </li>
<li>WP-CLI recommended for best experience </li>
<li>Pattern Library Pro for enterprise features (optional)</li>
</ul>
<h3>Pattern Analysis</h3>
File: index.html (104 KB) 
Patterns Found: 71
paragraph 20 Confidence: 1.00 
heading 15 Confidence: 1.00 
separator 14 Confidence: 1.00 
kadence_button 6 Confidence: 0.90 
kadence_accordion 2 Confidence: 0.95 
…
Confidence Distribution: 
 High (≥0.95): 60 
 Medium (0.85+): 11 
 Low (<0.85): 0 
 `
<h4>How do I get support?</h4>

<ul>
<li>Free users: <a href="https://github.com/derickschaefer/stcw-headless-assistant/issues" rel="nofollow ugc">GitHub Issues</a></li>
<li>Documentation: <a href="https://wp2headless.com/documentation/" rel="nofollow ugc">wp2headless.com/docs</a></li>
</ul>
<h4>Why are some files showing as 140 B?</h4>
Static Cache Wrangler may create gzipped files or use compression. The plugin handles this automatically by reading the actual <code>index.html</code> files within cached directories.
<h3>Additional Information</h3>
<h4>Architecture</h4>
Engine Components: 
* Scanner – Finds cached HTML files 
* Normalizer – Cleans HTML while preserving structure 
* Pattern Registry – Centralized pattern definitions with inheritance 
* Pattern Detector – XPath-based pattern matching engine 
* Extractors – DOM-to-data conversion functions 
* Parser – Orchestrates normalization → detection → extraction 
* Converter – Transforms to target CMS format 
* Target Registry – Pluggable CMS target management
Data Flow: 
 <code>Cached HTML → Normalizer → Pattern Detector → Extractors → Converter → Export</code>
<h4>Support</h4>
<ul>
<li>Documentation: https://wp2headless.com/documentation/</li>
<li>GitHub: https://github.com/derickschaefer/stcw-headless-assistant</li>
<li>Issues: https://github.com/derickschaefer/stcw-headless-assistant/issues</li>
</ul>
<h4>Roadmap</h4>
v2.2.0 (Q1 2026) – Quality Focus 
* Improve semantic conversion to 85%+ (currently 74%) 
* Wire up remaining Kadence extractors (button, icon list, maps) 
* Enhance navigation menu handling 
* Add pattern detection validators 
* 80%+ test coverage
v2.3.0 (Q2 2026) – More Patterns 
* Elementor widgets detection 
* Beaver Builder modules 
* ACF field mapping 
* Custom post type support
v2.5.0 (Q3 2026) – Multi-CMS 
* TBD based on input, feedback, and demand
<h4>Contributing</h4>
Contributions welcome! 
* Additional CMS target implementations 
* Page builder detector modules 
* Pattern extraction improvements 
* Documentation and examples 
* Test coverage
<a href="https://github.com/derickschaefer/stcw-headless-assistant/blob/main/CONTRIBUTING.md" rel="nofollow ugc">Contribution Guidelines</a>
<h4>Privacy Policy</h4>
This plugin does not collect, store, or transmit any user data. All conversion happens locally on your WordPress installation.
Data Storage: 
* No external API calls 
* No analytics or tracking 
* No cookies used 
* Export files stored locally in WordPress uploads directory 
* License validation (Pattern Library Pro) stored in wp_options
<h3>License</h3>
GPL v2 or later – Copyright © 2024-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.
<h3>Third-Party Trademark Notices</h3>
Content Management Systems: 
Sanity® is a registered trademark of Sanity.io 
Contentful® is a registered trademark of Contentful GmbH 
Strapi® is a registered trademark of Strapi Solutions SAS 
Builder.io® is a registered trademark of Builder.io, Inc. 
DatoCMS® is a registered trademark of Dato srl 
Payload CMS® is a registered trademark of Payload CMS, Inc.
WordPress Ecosystem: 
WordPress® and Gutenberg® are registered trademarks of the WordPress Foundation 
WP-CLI® is a registered trademark of the WordPress Foundation 
Kadence® and Kadence Blocks™ are trademarks of Kadence WP LLC 
Elementor® is a registered trademark of Elementor Ltd. 
Divi® is a registered trademark of Elegant Themes, Inc. 
Advanced Custom Fields® (ACF) is a registered trademark of WP Engine, Inc. 
WooCommerce® is a registered trademark of Automattic Inc. 
Beaver Builder® is a registered trademark of Beaver Builder
Development Tools: 
GitHub® is a registered trademark of GitHub, Inc. 
JSON™ is a trademark of JSON.org
Content & Media: 
YouTube® is a registered trademark of Google LLC 
Lottie™ is a trademark of Airbnb, Inc. 
Google Maps™ is a trademark of Google LLC
Project Attribution: 
WP2Headless.com is owned by Derick Schaefer 
Static Cache Wrangler is developed by Derick Schaefer
Disclaimer: 
This plugin is not affiliated with, endorsed by, or sponsored by any of the trademark owners listed above. These names are referenced solely to describe compatibility, integration capabilities, or as examples of headless CMS platforms that may be used with exported content. The plugin has not been tested, approved, or certified by any of these companies or organizations.

Static Cache Wrangler – Headless Assistant

Convert Static Cache Wrangler HTML output to headless CMS import formats with pluggable architecture.

Headless Converter vs Static Cache Wrangler – Headless Assistant