用于创建模块菜单的 Drupal 钩子(Hook)

Question

我正在尝试为我的模块找到一种在安装时创建 anchor 链接的方法。

我目前的策略是创建一个自定义菜单，类似于主菜单、次菜单等并位于其中。在此菜单中，我希望有一个或多个由我的模块定义的链接。然后我希望我的自定义菜单自动有一个阻止哪些用户可以随意放置。

当我的模块被卸载时，我想要菜单和它的链接被删除。

任何人都可以给我一些指示来完成这个吗？

Answer 1

http://api.drupal.org/api/drupal/modules--system--system.api.php/function/hook_menu/7

/**
 * Implement hook_menu()
 */
function <module>_menu() {

  $items = array();
  $items['admin/<path>'] = array(
    'title' => '<Link title>',
    'description' => '<Link description>',
    'page callback' => '<function from your module>',
    'access arguments' => array('access administration pages'),
    'type' => MENU_NORMAL_ITEM,
    'weight' => 15,
    'menu_name' => 'primary-links'
  );
  return $items;
}

'menu_name' 会将链接放在相关菜单中

更新:要首先创建菜单，您必须使用 hook_install 或 hook_enable，它们将在首次安装时运行操作，或分别启用。

/**
 * Implement hook_install()
 */
 function <module>_install () {
    $menu = array(
        'menu_name' => 'test-menu',
        'title' => 'Test menu',
        'description' => 'A test menu'
    );

    menu_save($menu);
    cache_clear_all('*', 'cache_menu', TRUE);

    drupal_set_message($message = t('The module was successfully installed. '), $type = 'status');
}

上面的代码将创建一个菜单。

注:对于hook_install()要运行，您必须先禁用然后卸载您的模块，然后再重新启用。使用 hook_enable()每次都运行它。

然后您可以使用上面的 hook_menu() 描述以编程方式将项目添加到该菜单。两个数组中的 menu_name 必须明显匹配。

阅读您的评论后发现您需要创建菜单，而不是添加到现有菜单，我建议使用 menu_link_save() 可能更好。而不是在 hook_install() 调用中。

请注意，您还需要使用 hook_disable()或 hook_uninstall()以便之后删除菜单链接。