WooCommerce templates
Theme compatibility mode, force theme templates, and selector tuning for custom product loops.
Compatibility
Show developers how the filter adapts to real WooCommerce themes.
This page should never promise "works with any theme". It should explain selectors, compatibility modes, cache behavior, debug tools, and the troubleshooting path.
- AJAX selectors
- Theme modes
- Debug tools
- Cache caveats
- Import/export
Selector checklist
Make AJAX setup inspectable.
Developers need to know what Fuzzy targets when a theme does not use the standard WooCommerce loop.
| Selector | What it maps | Common symptom if wrong |
|---|---|---|
| Products container | The grid/list wrapper that receives updated products | Products do not change after filtering |
| Product item | Single product cards inside the loop | Animations or counts do not match the visible items |
| Pagination | Pagination controls after filtering | Old pages remain after filter changes |
| Result count | "Showing X products" UI | Count stays stale while products update |
| OrderBy | Sort dropdown/control | Sort state resets or stops changing results |
Integration areas
Separate verified support from unverified compatibility notes.
Only publish named third-party support after source confirmation or real testing.
Elementor, Divi, Beaver, Gutenberg
Publish as verified only after confirmed support or QA. Otherwise keep as compatibility topics.
WPML and Polylang
Needs verified support facts before production copy names these tools as supported.
WP Rocket, LiteSpeed, Perfmatters
Explain cache exclusions, stale AJAX responses, minification checks, and troubleshooting.
Role pricing and private products
Keep role-pricing claims conservative until behavior is tested with target plugins.
Debug, export/import, reset, rebuild
These are core developer trust signals and should link to docs and support forms.
Troubleshooting
Give support a diagnostic route.
Use this structure for both the compatibility page and support intake form.
Products do not update
Check products container selector, AJAX response, cache layer, and product loop template.
Pagination stays stale
Check pagination selector, theme pagination markup, and whether the loop is replaced after filtering.
Result count is wrong
Check result count selector, count mode, variation behavior, and cached HTML fragments.
Mobile filter does not open
Check breakpoint, mobile layout state, popup markup, and theme scripts that alter body scroll.
SEO URL is unexpected
Check URL mode, selected parameters, canonical/noindex rules, and third-party SEO plugin output.
Slow large catalog
Check index status, count mode, live counts, random sort, cache, and max products per query.