Description
Axismundi Navigation Icons is an authoring plugin: it adds a “Navigation Icon”
panel to the block sidebar for navigation items, where you type a Material
Symbols ligature name (e.g. home, article, category, sell, tag,
folder). The icon is inserted before the item label.
Supported blocks:
- Navigation Link (
core/navigation-link) — also covers the page / post /
category / tag / custom link variants, which are the same block. Page links
default topages, category links tocategory, and tag links tolabel
when no custom icon is authored. - Submenu (
core/navigation-submenu). - Home Link (
core/home-link) — shows thehomeicon by default, with a
“Show home icon” toggle to opt out. - Page List (
core/page-list) — shows thepagesicon by default for generated
page items when the list is placed inside a Navigation block, with a “Show item
icons” toggle to opt out.
A core/navigation style variation, “Vertical item”, stacks the icon above the
label (M3 Navigation Bar / Rail vertical item) and moves the active indicator
onto a 56×32 icon slot; the unstyled default keeps the icon beside the label.
The Axismundi theme keeps the Material Design 3 navigation spec and the item
baseline (pill, state layer, active indicator), the Material Symbols font
(registered in theme.json) and the .material-symbols-outlined box contract
(icons.css). This plugin owns the icon data and its insertion, the item-layout
style variation, the front-end icon-click delegation, and — for the items it
restructures — the submenu disclosure arrow.
Installation
- Install and activate an Axismundi-family theme.
- Upload and activate this plugin.
- Select a navigation item, open the “Navigation Icon” panel in the sidebar,
and type a Material Symbols name (or toggle the home icon).
FAQ
-
Can this plugin be used without the Axismundi theme?
-
The icon name is still inserted, but the glyph renders only when the active
theme provides the Material Symbols font and the.material-symbols-outlined
contract. Without it the ligature name degrades gracefully to plain text. -
Where can I find icon names?
-
Browse fonts.google.com/icons and use the lowercase name, e.g.
shopping_cart.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Axismundi Navigation Icons” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Axismundi Navigation Icons” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.3
- Render the icon styling in the block-editor canvas, where core outputs the
navigation block as a div rather than a nav. - Refine open submenu icon rows to Material menu metrics.
0.1.2
- Align open submenu icon rows with Material menu metrics while leaving
always-open inline navigation unchanged.
0.1.1
- Prepare the package for WordPress.org Plugin Check by removing the hidden
distribution manifest and relying on WordPress.org translation loading.
0.1.0
- “Navigation Icon” sidebar control for Navigation Link, Submenu and Home Link
blocks (type a Material Symbols name, or toggle the fixed Home icon). - Page, post, category, tag, custom-link and submenu blocks get semantic default
icons (pages / article / category / label / link_2 / pages) when none is
authored; an explicit empty value opts out, with a reset to the default. - Page List icons are opt-in with a block-level toggle so standalone page lists
stay untouched by default. - A “Vertical item” core/navigation style variation: icon above the label with
the active indicator on a 56×32 icon slot. The default layout keeps the icon
beside the label. render_blockrestructures an icon-bearing item into an icon box + body at the- level; a small front-end script forwards an icon click to the item link,
and the plugin renders the submenu disclosure arrow for restructured triggers. - Editor canvas previews show authored icons, vertical-item layout and Page List
icon previews without duplicating the full front-end render transform. - The icon-box contract (1em box, overflow clip, ligature fallback) is inherited
from the Axismundi theme’s icons.css.