menu_link_get_preferred

function menu_link_get_preferred

menu_link_get_preferred($path = NULL, $selected_menu = NULL)

Looks up the preferred menu link for a given system path.

Parameters

$path: The path; for example, 'node/5'. The function will find the corresponding menu link ('node/5' if it exists, or fallback to 'node/%').

$selected_menu: The name of a menu used to restrict the search for a preferred menu link. If not specified, all the menus returned by menu_get_active_menu_names() will be used.

Return value

A fully translated menu link, or FALSE if no matching menu link was found. The most specific menu link ('node/5' preferred over 'node/%') in the most preferred menu (as defined by 登录查看完整内容