wp_get_nav_menu_object
云策文档标注
概述
本文档介绍了 wp_get_nav_menu_object 函数相关的过滤器,用于在获取导航菜单对象时进行自定义处理。核心是 wp_get_nav_menu_object 过滤器,允许开发者修改返回的菜单对象。
关键要点
- wp_get_nav_menu_object 过滤器在 wp_get_nav_menu_object() 函数中调用,用于过滤检索到的 nav_menu 分类法术语。
- 过滤器参数包括 $menu_obj(WP_Term 对象或 false)和 $menu(菜单 ID、slug、名称或对象)。
- 该过滤器自 WordPress 4.3.0 版本引入,位于 wp-includes/nav-menu.php 文件中。
代码示例
return apply_filters( 'wp_get_nav_menu_object', $menu_obj, $menu );
原文内容
Filters the nav_menu term retrieved for wp_get_nav_menu_object() .
Parameters
$menu_objWP_Term|false-
Term from nav_menu taxonomy, or false if nothing had been found.
$menuint|string|WP_Term-
The menu ID, slug, name, or object passed to wp_get_nav_menu_object() .
More Arguments from wp_get_nav_menu_object( … $menu )
Menu ID, slug, name, or object.
Source
return apply_filters( 'wp_get_nav_menu_object', $menu_obj, $menu );
Changelog
| Version | Description |
|---|---|
| 4.3.0 | Introduced. |