钩子文档

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.