WordPress中注册菜单与调用菜单的方法详解
register_nav_menus()(注册菜单)
register_nav_menus()函数用来注册一个菜单,菜单指的是WordPress3.0+的菜单管理器,注册之后用户就可以在菜单管理器里拖动生成导航菜单了。
用法
register_nav_menus($locations);
参数
$locations
(数组)(必须)要注册的菜单,键值为菜单ID,键名为菜单名称,可以一次创建多个。
默认值:None
返回值
该函数无返回值。
例子
/** *建立菜单 *http://www.endskin.com/register_nav_menus/ */ functionBing_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'=>'<ulid="%1$s"class="%2$s">%3$s</ul>', '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-{menuslug}-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
(对象)(可选)菜单的结构对象。
默认值:newWalker_Nav_Menu
例子
<?phpwp_nav_menu(array('theme_location'=>'header_menu','container'=>false,'items_wrap'=>'<ulid="topmenu">%3$s</ul>','fallback_cb'=>'Bing_menu_null_fallback'));?>
其它
此函数位于:wp-includes/nav-menu-template.php