On this page
wp_ajax_delete_inactive_widgets()
Ajax handler for removing inactive widgets.
Source
File: wp-admin/includes/ajax-actions.php. View all references
function wp_ajax_delete_inactive_widgets() {
check_ajax_referer( 'remove-inactive-widgets', 'removeinactivewidgets' );
if ( ! current_user_can( 'edit_theme_options' ) ) {
wp_die( -1 );
}
unset( $_POST['removeinactivewidgets'], $_POST['action'] );
/** This action is documented in wp-admin/includes/ajax-actions.php */
do_action( 'load-widgets.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
/** This action is documented in wp-admin/includes/ajax-actions.php */
do_action( 'widgets.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
/** This action is documented in wp-admin/widgets.php */
do_action( 'sidebar_admin_setup' );
$sidebars_widgets = wp_get_sidebars_widgets();
foreach ( $sidebars_widgets['wp_inactive_widgets'] as $key => $widget_id ) {
$pieces = explode( '-', $widget_id );
$multi_number = array_pop( $pieces );
$id_base = implode( '-', $pieces );
$widget = get_option( 'widget_' . $id_base );
unset( $widget[ $multi_number ] );
update_option( 'widget_' . $id_base, $widget );
unset( $sidebars_widgets['wp_inactive_widgets'][ $key ] );
}
wp_set_sidebars_widgets( $sidebars_widgets );
wp_die();
}
Hooks
- do_action( 'load-widgets.php' )
-
Fires early when editing the widgets displayed in sidebars.
- do_action( 'sidebar_admin_setup' )
-
Fires early before the Widgets administration screen loads, after scripts are enqueued.
- do_action( 'widgets.php' )
-
Fires early when editing the widgets displayed in sidebars.
Related
Uses
| Uses | Description |
|---|---|
| wp_get_sidebars_widgets() wp-includes/widgets.php | Retrieve full list of sidebars and their widget instance IDs. |
| wp_set_sidebars_widgets() wp-includes/widgets.php | Set the sidebar widget option to update sidebars. |
| current_user_can() wp-includes/capabilities.php | Returns whether the current user has the specified capability. |
| check_ajax_referer() wp-includes/pluggable.php | Verifies the Ajax request to prevent processing requests external of the blog. |
| wp_die() wp-includes/functions.php | Kills WordPress execution and displays HTML page with an error message. |
| do_action() wp-includes/plugin.php | Calls the callback functions that have been added to an action hook. |
| update_option() wp-includes/option.php | Updates the value of an option that was already added. |
| get_option() wp-includes/option.php | Retrieves an option value based on an option name. |
Changelog
| Version | Description |
|---|---|
| 4.4.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_ajax_delete_inactive_widgets