WordPress中注册菜单与调用菜单的方法详解

框架(架构)  /  管理员 发布于 7年前   278

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

您可能感兴趣的文章:

• WordPress中自定义后台管理界面配色方案的小技巧
• 给WordPress的编辑后台添加提示框的代码实例分享
• WordPress中给文章添加自定义字段及后台编辑功能区域
• 整理的一些实用WordPress后台MySQL操作命令
• 关于bluehost空间上wordpress后台变为英文的解决方案
• 在WordPress中获取数据库字段内容和添加主题设置菜单
• WordPress开发中自定义菜单的相关PHP函数使用简介
• 以JavaScript来实现WordPress中的二级导航菜单的方法
• WordPress导航菜单的滚动和淡入淡出效果的实现要点
• WordPress中制作导航菜单的PHP核心方法讲解
• wordpress主题支持自定义菜单及修改css样式实现方法
• 在WordPress的后台中添加顶级菜单和子菜单的函数详解