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. |