WP_Widget_Custom_HTML::update() WordPress Method
The WP_Widget_Custom_HTML::update() method is used to update the settings for a Custom HTML widget. This method accepts an array of new settings, sanitizes them, and then updates the widget settings with the new values.
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; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.8.1 | Introduced. |