钩子文档

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.