让WordPress主题支持自定义菜单功能详解

下面来详细讲解如何在主题中，添加这个功能。也很简单，只需要在两个地方，添加两小段代码即可！

register_nav_menus

首先，需要在主题的 functions.php 文件中，声明一下存在这个功能。只需要添加下面一段代码即可：

if(function_exists('register_nav_menus')){
register_nav_menus( array(
'header-menu' => __( 'topnav' )
) );
}

这段代码首先判断当前主题是否支持这个功能，然后注册一个名称为 topnav 的自定义菜单。也就是上面在 主题位置 面板中看到的自定义菜单名称。
实现 WordPress 自定义菜单功能这个功能有两个函数 register_nav_menu 和 register_nav_menus 顾名思义，第一个函数用于创建一个自定义菜单，第二个函数用于创建多个自定义菜单。两个函数使用大同小异，下面也是根据第二个函数进行讲解。
register_nav_menus 使用方法也很简单，只需要传递一个数组参数即可。

register_nav_menus( $locations ); 
这个数组是必选参数，定义自定义菜单的位置标记（键名）和位置描述（键值）。例如：
<pre class="prettyprint">
register_nav_menus( array(
'header-menu' => __( 'topnav' )，
'footer_menu' => 'My Custom Footer Menu'
) );

上面的这段代码，定义了两个自定义菜单，它们的标记（可以随便起）分别为：header-menu、footer_menu。它们后面对应的描述，将会显示在后台的 主题位置 面板上，供你选择。在 ‘header-menu’ => __( ‘topnav’ ) 这句代码中，我加了__() 这个函数，它是用于跨语言翻译用的。

wp_nav_menu

之后，在主题中添加自定义菜单。在主题中合适的位置，添加下面的函数：

<?php wp_nav_menu( array( 'theme_location' => 'header-menu' )); ?>

这句代码使用了 wp_nav_menu 函数。这个函数也是传递一个数组作为参数，但是这个数字里面的键名比较多。下面根据官方文档的说明选择几个重要的做了一个简单的翻译：

<?php $defaults = array(
'theme_location' => '',
'menu' => '',
'container' => 'div',
'container_class' => 'menu-{menu slug}-container',
'container_id' => '',
'menu_class' => 'menu',
'menu_id' => '',
'echo' => true,
'fallback_cb' => 'wp_page_menu',
'before' => '',
'after' => '',
'link_before' => '',
'link_after' => '',
'items_wrap' => '<ul id="%1$s">%3$s</ul>',
'depth' => 0,
'walker' => ''
); ?>

<?php wp_nav_menu( $defaults ); ?>

‘theme_location’ => 可选，值为之前在functions.php中 register_nav_menus 传递的数组参数中的键名，进行绑定。默认：无
‘container’ => 可选，决定是否要对生成的 自定义菜单（ul） 进行包裹，以及使用什么包裹。如果不需要，传递参数 false。默认：div
‘container_class’ => 可选，为上面包裹的容器添加 class 属性。下面的 container_id 功能类似。
‘before’ => 可选，在输出的列表中的 a 标签之前添加文本信息。after 功能类似。
‘link_before’ => 可选，在输出的列表中的链接文字前面加上文字（注意与上面的区别）。link_after 功能类似。
‘items_wrap’ => 可选，设置包裹自定义菜单的标签形式。默认：<ul id=”%1$s”>%3$s</ul>，通常不要修改 。

这样，刚刚我添加的那一句代码的意思很明确了，就是在这里调用名为 header-menu 的自定义菜单位置。而这个自定义菜单位置的名称为 topnav，在 WordPress 后台中，我新建了一个名为 “顶部导航” 的菜单，然后与这个 topnav 进行了关联。那么这句代码就调用了我设置的 “顶部导航” 菜单的内容。
我们不仅仅可以用它来做导航，还可以像上面那样，在多个位置添加多个自定义菜单。例如可以在底部加一个自定义菜单，这样在后台就可以设置底部的链接等等，功能非常强大。
不过需要注意一点，WordPress 目前的较新版本 3.4.2 被爆出一个 BUG ，不支持 自定义菜单。当然很快就出了补丁。如果你使用 3.4.2 版本的时候，自定义菜单无法使用，可以自行搜索一下解决方法。

以下主题模板内调用代码举例：

if( is_home()) {

// 链接菜单

if ( has_nav_menu( 'flink_menu' ) ) {

wp_nav_menu( array(

'menu' => 'flink_menu',

'theme_location' => 'flink_menu',

'depth' => -1,

'container' => '',

'container_class' => '',

'menu_id' => 'flink_menu',

'menu_class' => 'breadcrumbs',

'items_wrap' => '<ul id="%1$s" class="%2$s"><li class="active"><span class="glyphicon glyphicon-list-alt"></span> '.__('友情链接','dmeng').'</li> %3$s</ul>',

'walker' => new Dmeng_Bootstrap_Menu()

) );
}
}