wp_add_nav_menu_item
云策文档标注
概述
wp_add_nav_menu_item 是一个 WordPress 动作钩子,在新增导航菜单项后立即触发,用于在菜单项添加时执行自定义操作。
关键要点
- 触发时机:在新增导航菜单项后立即执行。
- 参数:接收 $menu_id(菜单ID)、$menu_item_db_id(菜单项数据库ID)和 $args(菜单项参数数组)。
- 相关函数:与 wp_update_nav_menu_item() 关联,用于保存或创建菜单项属性。
- 版本历史:自 WordPress 4.4.0 版本引入。
原文内容
Fires immediately after a new navigation menu item has been added.
Description
See also
Parameters
$menu_idint-
ID of the updated menu.
$menu_item_db_idint-
ID of the new menu item.
$argsarray-
An array of arguments used to update/add the menu item.
Source
do_action( 'wp_add_nav_menu_item', $menu_id, $menu_item_db_id, $args );
Changelog
| Version | Description |
|---|---|
| 4.4.0 | Introduced. |