钩子文档

pre_wp_setup_nav_menu_item

💡 云策文档标注

概述

pre_wp_setup_nav_menu_item 是一个 WordPress 过滤器,用于在 wp_setup_nav_menu_item() 函数执行前拦截其输出。通过返回非空值,可以跳过默认处理并直接返回自定义值。

关键要点

  • 过滤器名称:pre_wp_setup_nav_menu_item
  • 作用:短路径 wp_setup_nav_menu_item() 的输出,返回非空值将替代默认处理
  • 参数:$modified_menu_item(修改后的菜单项对象或 null,默认 null)和 $menu_item(待修改的菜单项对象)
  • 引入版本:WordPress 6.3.0
  • 相关函数:wp_setup_nav_menu_item(),用于装饰菜单项对象的共享导航属性

代码示例

$pre_menu_item = apply_filters( 'pre_wp_setup_nav_menu_item', null, $menu_item );

📄 原文内容

Filters whether to short-circuit the wp_setup_nav_menu_item() output.

Description

Returning a non-null value from the filter will short-circuit wp_setup_nav_menu_item() , returning that value instead.

Parameters

$modified_menu_itemobject|null
Modified menu item. Default null.
$menu_itemobject
The menu item to modify.

Source

$pre_menu_item = apply_filters( 'pre_wp_setup_nav_menu_item', null, $menu_item );

Changelog

Version Description
6.3.0 Introduced.