钩子文档

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.