性价比最高的香港ASP、PHP主机提供商
做网站,就上凡科建站

WordPress wp_nav_menu()菜单输出菜单描述

Loading
0
Comodo SLL证书促销 - 免费ssl证书申请_ssl证书购买_ev ssl证书_https证书购买 - GDCA_数安时代

wp_nav_menu() 函数可以非常方便地输出WordPress菜单,我们可以回顾一下之前的文章《WordPress导航菜单函数register_nav_menus() 和 wp_nav_menu() 》,文章提到 wp_nav_menu() 有一个参数 walker ,它可以用来挂载我们自己的函数,从而输入自定义的内容。今天,我们就是使用这个 walker 来输出菜单描述。

首先我们来设置菜单描述

在 外观>菜单 设置页面,点击右上角的 “显示选项”勾选“图像描述”:

wp_nav_menu-1-wpdaxue_com

然后展开某个菜单项,就可以看到“图像描述”,我们可以进行编辑和保存。

wp_nav_menu-2-wpdaxue_com

现在我们要做的就是在菜单中直接输出“图像描述”所填的内容。如下图所示:

wp_nav_menu-3-wpdaxue_com

在主题的functions.php 中添加下面的代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
/**
 * 添加输出菜单描述的 Walker 类
 * https://www.wpdaxue.com/wp_nav_menu-output-description.html
 */
class description_walker extends Walker_Nav_Menu
{
	function start_el(&$output, $item, $depth, $args)
	{
		global $wp_query;
		$indent = ( $depth ) ? str_repeat( "\t", $depth ) : '';
 
		$class_names = $value = '';
 
		$classes = empty( $item->classes ) ? array() : (array) $item->classes;
 
		$class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item ) );
		$class_names = ' class="'. esc_attr( $class_names ) . '"';
 
		$output .= $indent . '<li id="menu-item-'. $item->ID . '"' . $value . $class_names .'>';
 
		$attributes  = ! empty( $item->attr_title ) ? ' title="'  . esc_attr( $item->attr_title ) .'"' : '';
		$attributes .= ! empty( $item->target )     ? ' target="' . esc_attr( $item->target     ) .'"' : '';
		$attributes .= ! empty( $item->xfn )        ? ' rel="'    . esc_attr( $item->xfn        ) .'"' : '';
		$attributes .= ! empty( $item->url )        ? ' href="'   . esc_attr( $item->url        ) .'"' : '';
 
		$prepend = '<strong>';
		$append = '</strong>';
		$description  = ! empty( $item->description ) ? '<span>'.esc_attr( $item->description ).'</span>' : '';
 
		if($depth != 0)
		{
			$description = $append = $prepend = "";
		}
 
		$item_output = $args->before;
		$item_output .= '<a'. $attributes .'>';
		$item_output .= $args->link_before .$prepend.apply_filters( 'the_title', $item->title, $item->ID ).$append;
		$item_output .= $description.$args->link_after;
		$item_output .= '</a>';
		$item_output .= $args->after;
 
		$output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
	}
}

在菜单函数 wp_nav_menu() 中调用这个 walker 类

1
2
3
4
5
6
7
8
9
<?php
wp_nav_menu( 
	array( 
		'theme_location' => 'primary', 
		'menu_class' => 'nav-menu', 
		'walker' => new description_walker() //注意前面要有 new
		) 
	); 
?>

菜单输出的html结构大致如下:

1
2
3
4
5
6
7
<div class="menu-container">
<ul class="nav-menu">
<li><a href="https://www.wpdaxue.com/"><strong>大学首页</strong><span>WordPress大学首页</span></a></li>
<li><a href="https://www.wpdaxue.com/about"><strong>关于我们</strong><span>关于WordPress大学</span></a></li>
<li><a href="https://www.wpdaxue.com/archives"><strong>文章存档</strong><span>WordPress大学所有文章存档</span></a></li>
</ul>
</div>

你可以根据自己的需要添加相应的 CSS 来定义样式。也可以修改前面的 walker 类的输出结构。

参考资料:http://www.kriesi.at/archives/improve-your-wordpress-navigation-menu-output

支付宝扫码打赏 微信打赏

如果文章对你有帮助,欢迎点击上方按钮打赏作者

MetInfo | 最适合企业网站建设的cms系统

关于 倡萌

一个疯狂的 WordPress 爱好者,喜欢折腾 WordPress 主题,分享 WordPress 资源。如果你也喜欢 WordPress,欢迎和我一起交流!

精彩推荐

WP_Query 参数:文章、页面和文章类型

WP_Query 参数:文章、页面和文章类型

介绍50个 WordPress 动作挂钩

介绍50个 WordPress 动作挂钩

6 条评论

  1. if($depth != 0)
    {
    $description = $append = $prepend = “”;
    }
    这段控制输出菜单层数,0为顶层,去掉这段代码为全部都添加了
    :cool:

  2. 二级菜单要怎么办!!!!!

  3. 很多品牌网站都会在菜单中添加个描述,这个函数正好解决了,完美

  4. 发现只有一级菜单能输出描述,二级菜单怎么办?

  5. 一直没搞清楚那个描述是干什么的,找到答案了

发表评论