钩子文档

rest_after_insert_nav_menu_item

💡 云策文档标注

概述

rest_after_insert_nav_menu_item 是一个 WordPress Hook,在通过 REST API 完全创建或更新单个菜单项后触发。它允许开发者在菜单项操作完成后执行自定义代码。

关键要点

  • 触发时机:在通过 REST API 创建或更新单个菜单项后立即执行。
  • 参数:$nav_menu_item(插入或更新的菜单项对象)、$request(WP_REST_Request 请求对象)、$creating(布尔值,创建时为 true,更新时为 false)。
  • 相关函数:与 WP_REST_Menu_Items_Controller 的 create_item() 和 update_item() 方法关联。
  • 版本历史:自 WordPress 5.9.0 版本引入。

📄 原文内容

Fires after a single menu item is completely created or updated via the REST API.

Parameters

$nav_menu_itemobject
Inserted or updated menu item object.
$requestWP_REST_Request
Request object.
$creatingbool
True when creating a menu item, false when updating.

Source

do_action( 'rest_after_insert_nav_menu_item', $nav_menu_item, $request, true );

Changelog

Version Description
5.9.0 Introduced.