W3cubDocs

/WordPress

WP_Widget_Custom_HTML::update( array $new_instance, array $old_instance )

Handles updating settings for the current Custom HTML widget instance.

Parameters

$new_instance

(array) (Required) New settings for this instance as input by the user via WP_Widget::form().

$old_instance

(array) (Required) Old settings for this instance.

Return

(array) Settings to save or bool false to cancel saving.

Source

File: wp-includes/widgets/class-wp-widget-custom-html.php 

public function update( $new_instance, $old_instance ) {
		$instance          = array_merge( $this->default_instance, $old_instance );
		$instance['title'] = sanitize_text_field( $new_instance['title'] );
		if ( current_user_can( 'unfiltered_html' ) ) {
			$instance['content'] = $new_instance['content'];
		} else {
			$instance['content'] = wp_kses_post( $new_instance['content'] );
		}
		return $instance;
	}

Uses

Uses Description
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/formatting.php: sanitize_text_field()

Sanitizes a string from user input or from the database.
wp-includes/kses.php: wp_kses_post()

Sanitizes content for allowed HTML tags for post content.

Changelog

Version Description
4.8.1 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_widget_custom_html/update