钩子文档

delete_widget

查看官方原文 ↗

💡 云策文档标注

概述

delete_widget 是一个 WordPress 动作钩子，在小部件被标记为删除后立即触发，用于执行相关清理或自定义操作。

关键要点

触发时机：在小部件被标记为删除后立即执行。
参数：$widget_id（小部件ID）、$sidebar_id（侧边栏ID）、$id_base（小部件基础ID）。
源调用：do_action( 'delete_widget', $widget_id, $sidebar_id, $id_base )。
相关函数：WP_REST_Widgets_Controller::delete_item() 和 wp_ajax_save_widget() 使用此钩子。
版本历史：从 WordPress 4.4.0 版本引入。

📄 原文内容

Fires immediately after a widget has been marked for deletion.

Parameters

$widget_idstring: ID of the widget marked for deletion.
$sidebar_idstring: ID of the sidebar the widget was deleted from.
$id_basestring: ID base for the widget.

Source

do_action( 'delete_widget', $widget_id, $sidebar_id, $id_base );

View all references View on Trac View on GitHub

Used by	Description
WP_REST_Widgets_Controller::delete_item()`wp-includes/rest-api/endpoints/class-wp-rest-widgets-controller.php`	Deletes a widget.
wp_ajax_save_widget()`wp-admin/includes/ajax-actions.php`	Handles saving a widget via AJAX.

Changelog

Version	Description
4.4.0	Introduced.