On this page
WP_Widget_Custom_HTML::update( array $new_instance, array $old_instance ): array
Handles updating settings for the current Custom HTML widget instance.
Parameters
$new_instancearray Required-
New settings for this instance as input by the user via WP_Widget::form().
$old_instancearray 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. View all references
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;
}
Related
Uses
| Uses | Description |
|---|---|
| wp_kses_post() wp-includes/kses.php | Sanitizes content for allowed HTML tags for post content. |
| sanitize_text_field() wp-includes/formatting.php | Sanitizes a string from user input or from the database. |
| current_user_can() wp-includes/capabilities.php | Returns whether the current user has the specified capability. |
Changelog
| Version | Description |
|---|---|
| 4.8.1 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_widget_custom_html/update