钩子文档

widgets.php

💡 云策文档标注

概述

widgets.php 是一个 WordPress 动作钩子,在编辑侧边栏中显示的小部件时早期触发。它主要用于处理小部件相关的 AJAX 操作和自定义器集成。

关键要点

  • widgets.php 是一个动作钩子,触发时机为编辑侧边栏小部件时早期。
  • 该钩子与多个 AJAX 处理函数和自定义器方法相关联,用于小部件的删除、保存和更新。
  • 自 WordPress 2.8.0 版本引入,是核心功能的一部分。

相关函数

  • wp_ajax_delete_inactive_widgets():通过 AJAX 处理移除非活动小部件。
  • wp_ajax_save_widget():通过 AJAX 处理保存小部件。
  • WP_Customize_Widgets::wp_ajax_update_widget():异步更新小部件设置。
  • WP_Customize_Widgets::customize_controls_init():确保所有小部件加载到自定义器中。

📄 原文内容

Fires early when editing the widgets displayed in sidebars.

Source

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

Changelog

Version Description
2.8.0 Introduced.