Home › API reference › menu.inc

menu_links_clone

  1. drupal
    1. 7
Versions
7 menu_links_clone($links, $menu_name = NULL)

Clone an array of menu links.

Parameters

$links An array of menu links to clone.

$menu_name (optional) The name of a menu that the links will be cloned for. If not set, the cloned links will be in the same menu as the original set of links that were passed in.

Return value

An array of menu links with the same properties as the passed-in array, but with the link identifiers removed so that a new link will be created when any of them is passed in to menu_link_save().

See also

menu_link_save()

Related topics

Menu system
Define the navigation menus, and route page requests to code based on URLs.

▸ 2 functions call menu_links_clone()

▾ 2 functions call menu_links_clone()

shortcut_set_add_form_submit in drupal/modules/shortcut/shortcut.admin.inc
Submit handler for shortcut_set_add_form().
shortcut_set_switch_submit in drupal/modules/shortcut/shortcut.admin.inc
Submit handler for shortcut_set_switch().

Code

drupal/includes/menu.inc, line 2800

<?php
function menu_links_clone($links, $menu_name = NULL) {
  foreach ($links as &$link) {
    unset($link['mlid']);
    unset($link['plid']);
    if (isset($menu_name)) {
      $link['menu_name'] = $menu_name;
    }
  }
  return $links;
}
?>