钩子文档

rest_pre_insert_nav_menu_item

💡 云策文档标注

概述

rest_pre_insert_nav_menu_item 是一个 WordPress REST API 钩子,用于在通过 REST API 插入菜单项之前过滤菜单项数据。它允许开发者在菜单项保存到数据库前修改或验证其内容。

关键要点

  • 这是一个过滤器钩子,应用于菜单项插入或更新前的准备阶段。
  • 接收两个参数:$prepared_nav_item(准备插入数据库的菜单项对象)和 $request(WP_REST_Request 对象)。
  • 在 WP_REST_Menu_Items_Controller::prepare_item_for_database() 方法中被调用,用于菜单项的创建或更新操作。
  • 自 WordPress 5.9.0 版本引入。

📄 原文内容

Filters a menu item before it is inserted via the REST API.

Parameters

$prepared_nav_itemobject
An object representing a single menu item prepared for inserting or updating the database.
$requestWP_REST_Request
Request object.

Source

return apply_filters( 'rest_pre_insert_nav_menu_item', $prepared_nav_item, $request );

Changelog

Version Description
5.9.0 Introduced.