# Pjax SPA-style Navigation — Admin Portal (backend) **Status:** Phases 0–3 DONE for the tested modules (see per-module table) · **Branch:** tailwind-poc · **Created:** 2026-07-21 ## ⚠️ CRITICAL FIX, read this first: `NavContentPjax` Full writeup lives in [`PJAX_NAV_SHOP_PLAN.md`](PJAX_NAV_SHOP_PLAN.md) (found while testing THIS portal, applies identically to both). One-line version: `yii\widgets\Pjax` calls `$view->clear()` on every request it recognizes as its own — i.e. every navigation click this feature produces — which silently wipes any `registerJs()` / `registerJsFile()` / `registerCss()` the page already made, so a page's OWN inline script never arrives at all (not "double-fires on revisit" — never fires, full stop). Fixed by [`common/widgets/NavContentPjax.php`](../../common/widgets/NavContentPjax.php) (shared with the shop portal); both layouts use it instead of the bare `yii\widgets\Pjax`. **This is why the "inline AJAX toggle" audit below reads the way it does** — the toggles were ALWAYS silently broken under Pjax before this fix (not a new regression this work introduced), and needed BOTH the `NavContentPjax` fix (to run at all) AND an idempotency guard (to not double-fire on the 2nd+ visit). Verified live: `/shop`'s `.mode-toggle` confirm dialog fires exactly once on the 1st Pjax visit and exactly once again on the 2nd. ## Phase 0 implementation log + verification (2026-07-21) Built mirroring the shop portal, with one deliberate simplification: **no `AdminNav` PHP helper was needed.** The shop needed `ShopNav::resolveActiveId()` because its sidebar JS re-highlights by a synthetic `data-nav-id` looked up against a server- rendered `data-active-nav-id`. The admin sidebar's `Menu.php` source has no stable per-item id (it's a legacy AdminLTE-style array with a pre-computed boolean `active` per node) — so the JS here re-highlights by comparing each `[data-pjax-nav]` link's `href` to `window.location.pathname + search` directly, needing zero new PHP. - `backend/views/layouts/_tw_admin_sidebar.php` — `$renderLeaf()` now emits `data-pjax-nav`, `data-{active,inactive}-class`, `data-icon-{active,inactive}-class` on every link (same data-attribute contract as the shop, mechanically copied). - `backend/views/layouts/tailwind.php` — content wrapped in `Pjax::begin(['id' => 'tw-content-pjax', ...])`; the inner div carries `data-nav-title` (no `data-active-nav-id` needed, see above). New JS registered as a plain `