joseconti/klytos-menus-and-navigation

Klytos Menus & Navigation

Menu Item Structure

[
    'id'       => string,    // Auto-generated hex ID
    'label'    => string,    // Display text
    'url'      => string,    // Link URL (default '#')
    'target'   => string,    // '_self' or '_blank'
    'icon'     => string,    // Icon name (optional)
    'order'    => int,       // Sort order
    'children' => array,     // Nested items (recursive)
]

---

Via MCP (Primary)

klytos_get_menu — Get current menu

klytos_set_menu — Replace entire menu

{
    "items": [
        {"label": "Home", "url": "/", "order": 0},
        {"label": "Services", "url": "/services/", "order": 1, "children": [
            {"label": "Marketing", "url": "/services/marketing/", "order": 0},
            {"label": "Design", "url": "/services/design/", "order": 1}
        ]},
        {"label": "About", "url": "/about/", "order": 2},
        {"label": "Contact", "url": "/contact/", "order": 3}
    ]
}

klytos_add_menu_item — Add single item

{"label": "Blog", "url": "/blog/", "order": 4}

klytos_remove_menu_item — Remove by ID

{"id": "abc123"}

---

Via Plugin Code

$menu = klytos_app()->getMenuManager();

$menu->get();                              // Get menu
$menu->set([...items...]);                 // Replace all
$menu->addItem(['label' => 'Blog', 'url' => '/blog/', 'order' => 3]);
$menu->removeItem('abc123');               // Remove by ID
$html = $menu->toHtml('/');                // Generate HTML

---

Associating Items with Pages

Use the page's URL path as the menu item URL:

| Page slug | Menu URL | |---|---| | about | /about/ | | services/marketing | /services/marketing/ | | External | https://example.com | | Anchor | #section |

---

Generated CSS Classes

| Class | Element | Description | |---|---|---| | .klytos-nav | <nav> | Container | | .klytos-menu | <ul> | Main list | | .klytos-menu-item | <li> | Item | | .has-children | <li> | Has submenu | | .klytos-submenu | <ul> | Nested list |

<nav class="klytos-nav">
    <ul class="klytos-menu">
        <li class="klytos-menu-item"><a href="/">Home</a></li>
        <li class="klytos-menu-item has-children">
            <a href="/services/">Services</a>
            <ul class="klytos-submenu">
                <li class="klytos-menu-item"><a href="/services/marketing/">Marketing</a></li>
            </ul>
        </li>
    </ul>
</nav>

Submenus: display: none by default, shown on .has-children:hover.

---

Source Files

• Menu manager: core/menu-manager.php
• MCP tools: core/mcp/tools/menu-tools.php