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

Updates a particular instance of a widget.

Description

This function should check that $new_instance is set correctly. The newly-calculated value of $instance should be returned. If false is returned, the instance won’t be saved/updated.

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/class-wp-widget.php

public function update( $new_instance, $old_instance ) {
		return $new_instance;
	}

Used By	Description
wp-includes/class-wp-widget.php: WP_Widget::update_callback()	Handles changed settings (Do NOT override).

Changelog

Version	Description
2.8.0	Introduced.

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