wp_get_nav_menus
云策文档标注
概述
wp_get_nav_menus 是一个 WordPress 过滤器,用于修改返回的导航菜单对象数组。它基于 get_terms() 函数,允许开发者自定义菜单对象的检索结果。
关键要点
- 这是一个过滤器 Hook,名称为 'wp_get_nav_menus',用于过滤导航菜单对象。
- 参数包括 $menus(WP_Term[] 数组)和 $args(数组),分别表示菜单对象和检索参数。
- 源实现使用 apply_filters 调用 get_terms($args) 来获取菜单对象。
- 自 WordPress 3.0.0 版本引入,相关函数 wp_get_nav_menus() 用于返回所有导航菜单对象。
原文内容
Filters the navigation menu objects being returned.
Description
See also
Parameters
$menusWP_Term[]-
An array of menu objects.
$argsarray-
An array of arguments used to retrieve menu objects.
Source
return apply_filters( 'wp_get_nav_menus', get_terms( $args ), $args );
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Introduced. |