钩子文档

customize_nav_menu_available_items

💡 云策文档标注

概述

customize_nav_menu_available_items 是一个 WordPress 过滤器钩子,用于在自定义菜单编辑器中筛选可用的菜单项。它允许开发者修改菜单项的数组,基于对象类型、名称和页码进行自定义处理。

关键要点

  • 这是一个过滤器钩子,用于修改自定义菜单中可用的菜单项数组。
  • 参数包括 $items(菜单项数组)、$object_type(对象类型)、$object_name(对象名称)和 $page(当前页码)。
  • 常用于 WP_Customize_Nav_Menus::load_available_items_query() 方法中,以执行查询并加载菜单项。
  • 自 WordPress 4.3.0 版本引入。

代码示例

$items = apply_filters( 'customize_nav_menu_available_items', $items, $object_type, $object_name, $page );

📄 原文内容

Filters the available menu items.

Parameters

$itemsarray
The array of menu items.
$object_typestring
The object type.
$object_namestring
The object name.
$pageint
The current page number.

Source

$items = apply_filters( 'customize_nav_menu_available_items', $items, $object_type, $object_name, $page );

Changelog

Version Description
4.3.0 Introduced.