| 1 |
--- |
| 2 |
module: wizard |
| 3 |
--- |
| 4 |
|
| 5 |
# wizard |
| 6 |
|
| 7 |
## Responsibility |
| 8 |
|
| 9 |
Owns the CartFlows first-run setup wizard: the standalone `index.php?page=cartflow-setup` admin screen (its own full HTML document, React SPA, and asset enqueue), the six-step flow, and the eight `wp_ajax_cartflows_*` handlers backing it. |
| 10 |
|
| 11 |
Ownership stops at the data it writes — flow/step import mechanics, settings shape, and the template-preview iframe's own message handling all live outside this module. |
| 12 |
|
| 13 |
## Why it is this way |
| 14 |
|
| 15 |
The wizard is not a normal admin page. It renders its own `<html>` document, fires `admin_print_styles` and `admin_head` manually, and ends in `exit`, so nothing that assumes the standard admin lifecycle applies inside it. |
| 16 |
|
| 17 |
The jQuery↔React boundary is entirely string-based: buttons carry CSS classes that a delegated jQuery handler binds, and the two halves communicate through custom DOM events with no registry. Rename a class or an event name and nothing errors — the wizard just stops. |
| 18 |
|
