钩子文档

rest_after_save_widget

💡 云策文档标注

概述

rest_after_save_widget 是一个 WordPress 动作钩子,在通过 REST API 创建或更新小部件后触发,主要用于开发者在小部件保存后执行自定义操作。

关键要点

  • 触发时机:当小部件通过 REST API 被创建或更新后立即执行。
  • 参数说明:包括小部件 ID、侧边栏 ID、WP_REST_Request 对象和创建标志。
  • 相关函数:与 WP_REST_Widgets_Controller::save_widget() 方法关联,用于保存小部件数据。
  • 版本历史:自 WordPress 5.8.0 版本引入。

代码示例

do_action( 'rest_after_save_widget', $id, $sidebar_id, $request, $creating );

📄 原文内容

Fires after a widget is created or updated via the REST API.

Parameters

$idstring
ID of the widget being saved.
$sidebar_idstring
ID of the sidebar containing the widget being saved.
$requestWP_REST_Request
Request object.
$creatingbool
True when creating a widget, false when updating.

Source

do_action( 'rest_after_save_widget', $id, $sidebar_id, $request, $creating );

Changelog

Version Description
5.8.0 Introduced.