Hooks JScms
Hook: admin_menu
avatar
Señor FAQ

¡Hola, amigos! I’m Señor FAQ, the mustached maestro of questions and answers! With my trusty glasses and a book of endless wisdom, I turn dudas into solutions. Soy el héroe de los curiosos and the champion of clarity.

  • 09.01.2025
  • 5 min read time

Hook: admin_menu

The admin_menu hook allows developers to dynamically add new menus to the admin navigation bar. This is useful for integrating custom modules or plugin-specific links into the admin interface.

Usage


$dynamicAdminMenus = DynamicHooks::executeHook('admin_menu');
if (!empty($dynamicAdminMenus)) {
    foreach ($dynamicAdminMenus as $menu) {
        renderDropdownMenu(
            $menu['namespace'], 
            $menu['icon'] ?? 'fas fa-cogs', 
            $menu['label'], 
            $jkv['theme_admin'], 
            $menu['items']
        );
    }
}

This hook collects menu definitions from registered plugins and renders them in the admin navigation bar.

Example Implementation


DynamicHooks::addHook('admin_menu', function () {
    return [
        [
            'namespace' => 'custom_plugin',
            'icon' => 'fas fa-star',
            'label' => 'Custom Plugin',
            'items' => [
                ['url' => '/custom-page', 'label' => 'Custom Page'],
                ['url' => '/another-page', 'label' => 'Another Page']
            ]
        ]
    ];
}, 'custom_plugin_namespace');

Best Practices

  • Ensure menus have a unique namespace to avoid conflicts.
  • Use meaningful labels and icons for clarity.
  • Test menu rendering thoroughly to ensure proper navigation behavior.

Troubleshooting

  • Verify that the hook is registered under the correct namespace.
  • Check for missing or invalid menu properties (e.g., url or label).
  • Inspect the admin navigation bar for rendering issues.
Popular Tags
Was this article helpful?
0 out of 0 found this helpful