User Documentation

What this plugin helps diagnose

• Cart fragment refreshes that run too often
• Add-to-cart requests that fire more than once
• Slow callbacks attached to common WooCommerce cart hooks
• Large AJAX payloads from fragments or cart responses
• Whether a problematic cart path is using classic AJAX or Store API routes

Start a profiling session

1. Open WooCommerce -> Cart Conflict Visualizer.
2. Enter optional context:
   • Start reason
   • Test URL
   • Notes
3. Start a 5, 15, 30, or 60 minute session.
4. Reproduce the cart issue during that window.

Review results

The admin screen shows:

• Current plugin state and expiry time
• Summary totals
• Session metadata
• Ranked findings
• Request table with counts and max timings
• Store API awareness rows when detected
• Callback table with hook, callback, owner, counts, and timing
• Session list and before/after comparison

Export data

You can export the latest or selected session as:

• JSON
• CSV
• HTML report

Exports redact common identifiers before output.

Practical workflow

1. Start a short session.
2. Reproduce issue on one target page.
3. Sort findings by severity and inspect slowest endpoint or callback first.
4. Compare with a second session after changing theme, plugin, or custom code.

Limits to know

• Store API support is directional, not full deep tracing.
• Plugin records only the hooks listed in the profiler.
• Data lives in options and should be treated as temporary diagnostic data.