load-widgets.php

查看官方原文 ↗

💡 云策文档标注

概述

load-widgets.php 是一个 WordPress 动作钩子，在编辑侧边栏中显示的小部件时早期触发。它主要用于处理小部件相关的后台操作，如保存、删除和自定义器中的加载。

钩子名称：load-widgets.php，但注意命名规范建议使用下划线（WordPress.NamingConventions.ValidHookName.UseUnderscores）。
触发时机：在编辑侧边栏小部件时早期执行，常用于初始化或处理 AJAX 请求。
相关函数：包括 wp_ajax_delete_inactive_widgets()、wp_ajax_save_widget()、WP_Customize_Widgets::wp_ajax_update_widget() 和 WP_Customize_Widgets::customize_controls_init()，用于处理小部件的删除、保存、更新和自定义器加载。
版本历史：自 WordPress 2.8.0 版本引入。

📄 原文内容

Fires early when editing the widgets displayed in sidebars.

do_action( 'load-widgets.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

Used by	Description
wp_ajax_delete_inactive_widgets()`wp-admin/includes/ajax-actions.php`	Handles removing inactive widgets via AJAX.
wp_ajax_save_widget()`wp-admin/includes/ajax-actions.php`	Handles saving a widget via AJAX.
WP_Customize_Widgets::wp_ajax_update_widget()`wp-includes/class-wp-customize-widgets.php`	Updates widget settings asynchronously.
WP_Customize_Widgets::customize_controls_init()`wp-includes/class-wp-customize-widgets.php`	Ensures all widgets get loaded into the Customizer.

Version	Description
2.8.0	Introduced.