Migrate navigation mega-menus to the Core Icon block (LS-3229)

[brandonmarshal]

Summary

Replaces every outermost/icon-block (third-party "Icon Block" plugin) instance in the navigation mega-menus with WordPress 7.1's native Core Icon block (core/icon), referencing icons from the lightspeed collection registered in ls-plugin. First of 5 stacked batches migrating all 38 outermost/icon-block usages across the theme (see LS-3229).

Files changed (8 files, 81 icon instances)

• parts/about-mega-menu.html — lightbulb, rocket, shield, trend-up, seal-check, wheelchair + 6× arrow-right chevron
• parts/insights-mega-menu.html — cube, brain, arrows-clockwise, tray, palette, book + 6× arrow-right chevron
• parts/mobile-menu.html — dot ×6 (one per lifecycle phase — Discover/Create/Build/Launch/Grow/Evolve, each its own phase colour)
• parts/pricing-mega-menu.html — stack, building-office, archive, trending-up, calculator, seal-check + 6× arrow-right chevron
• parts/services-mega-menu.html — dot ×6 (per-phase) + chevron-right ×5 (all phases except Evolve, which had no trailing arrow in the original either)
• parts/solutions-mega-menu.html — credit-card, newspaper, brain, chat, cart, airplane-tilt, palette + 7× arrow-right chevron
• parts/work-mega-menu.html — folder ×2, puzzle-piece, cart, database, quote + 6× arrow-right chevron
• patterns/menu/menu-item-card.php — folder (36px placeholder icon) + arrow-right chevron

Markup change

core/icon is a dynamic (server-rendered) block, unlike the static outermost/icon-block. Every instance collapses from a two-div/inline-SVG block to a single self-closing comment, e.g.:

<!-- wp:icon {"icon":"lightspeed/dot","className":"has-text-color","style":{"color":{"text":"var(--wp--custom--color--phase--discover)"},"dimensions":{"width":"8px"}}} /-->

No flipHorizontal/rotation attributes were needed — none of the chevron instances had a non-zero transform in the original markup.

Icon mapping verification

Every icon assignment was verified by extracting each source <svg> and exact-path-matching against the real files in ls-plugin/assets/icons/lightspeed/, rather than relying on the icon-sourcing mapping document alone (which undercounted actual occurrences). Two ambiguous cases were confirmed directly:

• lightspeed/trend-up and lightspeed/trending-up are intentionally distinct slugs for a byte-identical shape — disambiguated by file context (about-mega-menu → trend-up, pricing-mega-menu → trending-up).
• lightspeed/palette and lightspeed/brain were corrected from an earlier, backwards manual identification — confirmed against the actual collection files as source of truth.

Test plan

• outermost/icon-block count is 0 across all 8 changed files (scripted check)
• wp:icon instance count matches the verified 81-instance mapping table exactly, per file
• Every wp:icon JSON attribute payload parses as valid JSON (scripted check across all 8 files)
• PHP block-rendering test (parse_blocks + render_block via wp eval-file) on all 8 files — zero errors, correct <svg>/.wp-block-icon count per file
• Manual visual QA in the Site Editor and live frontend (Studio, light and dark) for Work, Solutions, Pricing, Insights, About, and Services mega menus — icons, colours, and the Services per-phase layout all match pre-migration appearance
• Confirmed in the Site Editor that icons remain freely re-editable via the lightspeed collection picker

Part of LS-3229 (Batch 1 of 5). Next: Batch 2 (Homepage) on a branch stacked on top of this one.

[linear-code]

LS-3229

[Copilot]

🟢 Approval recommended

The changes are a straightforward, consistent block swap with no remaining outermost/icon-block usage in the modified files and no functional regressions evident in the updated markup.

Pull request overview

This PR migrates the navigation mega-menu icon markup away from the third-party outermost/icon-block to WordPress Core’s core/icon block, using the lightspeed/* icon collection registered in ls-plugin, reducing theme coupling to a plugin-provided block implementation.

Changes:

• Replaced all outermost/icon-block instances in the affected mega-menu template parts with wp:icon blocks referencing lightspeed/* icons.
• Updated the shared menu item card pattern to use wp:icon for both the placeholder icon and chevron.
• Preserved existing sizing and colour intent via style.dimensions.width and text colour styles where previously applied.

File summaries

File	Description
patterns/menu/menu-item-card.php	Swaps the pattern’s placeholder icon + chevron to Core Icon block equivalents.
parts/about-mega-menu.html	Replaces About mega-menu item icons/chevrons with wp:icon using lightspeed/*.
parts/insights-mega-menu.html	Replaces Insights mega-menu item icons/chevrons with wp:icon using lightspeed/*.
parts/mobile-menu.html	Migrates mobile Services lifecycle phase dots to wp:icon with per-phase colours.
parts/pricing-mega-menu.html	Replaces Pricing mega-menu item icons/chevrons with wp:icon using lightspeed/*.
parts/services-mega-menu.html	Migrates Services per-phase dots and chevrons to wp:icon with per-phase colours.
parts/solutions-mega-menu.html	Replaces Solutions mega-menu item icons/chevrons with wp:icon using lightspeed/*.
parts/work-mega-menu.html	Replaces Work mega-menu item icons/chevrons with wp:icon using lightspeed/*.

Review details

• Files reviewed: 8/8 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.