【下载文档:  WordPress中注册菜单与调用菜单的方法详解.txt 】

---

WordPress中注册菜单与调用菜单的方法详解
register_nav_menus()（注册菜单）
register_nav_menus() 函数用来注册一个菜单，菜单指的是 WordPress 3.0+ 的菜单管理器，注册之后用户就可以在菜单管理器里拖动生成导航菜单了。
用法
register_nav_menus( $locations );
参数
$locations
（数组）（必须）要注册的菜单，键值为菜单 ID，键名为菜单名称，可以一次创建多个。
默认值：None
返回值
该函数无返回值。
例子
/**
*建立菜单
*http://www.endskin.com/register_nav_menus/
*/
function Bing_register_nav_menus(){
register_nav_menus( array(
'header_menu' => __( '顶部菜单', 'Bing' ),
'footer_menu' => __( '页脚菜单', 'Bing' )
));
}
add_action( 'init', 'Bing_register_nav_menus' );
其它
该函数位于：wp-includes/nav-menu.php
wp_nav_menu()（菜单调用）
下面就来说一下怎么调用用户添加好后的菜单。
调用菜单主要使用 wp_nav_menu() 函数，wp_nav_menu() 函数的参数比较多，所以功能非常强大，这里会一个一个的讲解。
用法
wp_nav_menu( $args );
参数
参数只有一个 $args，但这是一个数组，通过给数组添加参数，可以定制更多细节，下边是默认值：
$defaults = array(
'theme_location' => '',
'menu' => '',
'container' => 'div',
'container_class' => '',
'container_id' => '',
'menu_class' => 'menu',
'menu_id' => '',
'echo' => true,
'fallback_cb' => 'wp_page_menu',
'before' => '',
'after' => '',
'link_before' => '',
'link_after' => '',
'items_wrap' => '

%3$s

',
'depth' => 0,
'walker' => ''
);
wp_nav_menu( $defaults );
详解：
theme_locaton
（字符串）（可选）要调用的菜单的名字，比如 header_menu，如果没指定，则默认显示第一个注册的菜单。
默认值：None
menu
（字符串）（可选）使用导航菜单的名称调用菜单，可以是 ID、别名和名字（按顺序匹配）。
默认值：None
container
（字符串）（可选）导航菜单的容器类型，只支持 div 和 nav 标签，如果是其它值，ul 父节点的标签将不会显示。也可以设置成 False 去掉 ul 父节点。
默认值：div
container_class
（字符串）（可选）ul 父节点的 class 属性。
默认值：menu-{menu slug}-container
container_id
（字符串）（可选）ul 父节点的 id 属性。
默认值：None
menu_class
（字符串）（可选）ul 节点的 class 属性。
默认值：None
menu_id
（字符串）（可选）ul 节点的 id 属性。
默认值：菜单别名
echo
（布尔）（可选）返回导航菜单的 Html 代码还是直接打印输出，如果你想把导航菜单代码存到变量里请设置成 False.
默认值：True（直接打印输出）
fallback_cb
（回调函数）（可选）后台没有设置此菜单时默认显示的内容。
默认值：wp_page_menu
before
（字符串）（可选）显示在每个菜单链接前的文本。
默认值：None
after
（字符串）（可选）显示在每个菜单链接后的文本。
默认值：None
link_before
（字符串）（可选）显示在每个菜单链接文本前的文本。
默认值：None
link_after
（字符串）（可选）显示在每个菜单链接文本后的文本。
默认值：None
items_wrap
（字符串）（可选）替换 ul 的 class 属性。
默认值：None
depth
（整形）（可选）
显示菜单的深度，当数值为 0 时显示所有深度的菜单。
默认值：0
walker
（对象）（可选）菜单的结构对象。
默认值：new Walker_Nav_Menu
例子
'header_menu', 'container' => false, 'items_wrap' => '

%3$s

', 'fallback_cb' => 'Bing_menu_null_fallback' ) ); ?>
其它
此函数位于：wp-includes/nav-menu-template.php