You appear to be a bot. Output may be restricted

Description

Updates widget settings asynchronously.

Allows the Customizer to update a widget using its form, but return the new instance info via Ajax instead of saving it to the options table. Most code here copied from wp_ajax_save_widget().

Usage

WP_Customize_Widgets::wp_ajax_update_widget();

Parameters

Returns

void

Source

File name: wordpress/wp-includes/class-wp-customize-widgets.php
Lines:

  public function wp_ajax_update_widget() {

    if ( ! is_user_logged_in() ) {
      wp_die( 0 );
    }

    check_ajax_referer( 'update-widget', 'nonce' );

    if ( ! current_user_can( 'edit_theme_options' ) ) {
      wp_die( -1 );
    }

    if ( empty( $_POST['widget-id'] ) ) {
      wp_send_json_error( 'missing_widget-id' );
    }

    
/** 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' );

    $widget_id = $this->WP_Customize_Widgets::get_post_value( 'widget-id' );
    $parsed_id = $this->WP_Customize_Widgets::parse_widget_id( $widget_id );
    $id_base   = $parsed_id['id_base'];

    $is_updating_widget_template = (
      isset( $_POST[ 'widget-' . $id_base ] )
      &&
      is_array( $_POST[ 'widget-' . $id_base ] )
      &&
      preg_match( '/__i__|%i%/', key( $_POST[ 'widget-' . $id_base ] ) )
    );
    if ( $is_updating_widget_template ) {
      wp_send_json_error( 'template_widget_not_updatable' );
    }

    $updated_widget = $this->WP_Customize_Widgets::call_widget_update( $widget_id ); // => {instance,form}
    if ( is_wp_error( $updated_widget ) ) {
      wp_send_json_error( $updated_widget->get_error_code() );
    }

    $form     = $updated_widget['form'];
    $instance = $this->WP_Customize_Widgets::sanitize_widget_js_instance( $updated_widget['instance'], $id_base );

    wp_send_json_success( compact( 'form', 'instance' ) );
  }
 

 View on GitHub View on Trac