Tiger_Admin_Nav

@api

Tiger_Admin_Nav — the admin sidebar's TOP-LEVEL nav registry (the module hook).

Sibling of Tiger_Admin_Settings: where that adds a page under the Settings submenu, this adds a top-level item to the admin sidebar. A module contributes one from its Bootstrap — no core file to edit, ACL-gated + activation-gated for free (an inactive module never bootstraps, so its item never registers). The PUMA admin-menu partial merges these in ahead of Settings:

Tiger_Admin_Nav::register([ 'key' => 'docs_help', // unique; dedupes 'label' => 'Help', 'icon' => 'fa-circle-question', 'href' => '/docs/admin/help', 'match' => '/docs/admin/help', // path prefix that marks it active (default: href) 'resource' => 'Docs_AdminController', // ACL resource — the item hides if denied 'order' => 90, // sort weight among registered items (lower first) ]);

Methods

register()

register(array $item)

Register (or replace, by key) a top-level nav item. Requires key, label, href.

  • $item array — item definition (key, label, href, and optional icon/match/resource/order)

items()

items()

The registered items as sidebar nav-item arrays (label/href/match/icon/resource), sorted by order then label. ACL filtering happens in the menu partial, live per role.

Returns array<int,array>

clear()

clear()

Reset the registry (tests).