WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Widget::update()

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

In this article

Back to top

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_instancearrayrequired
New settings for this instance as input by the user via WP_Widget::form().
$old_instancearrayrequired
Old settings for this instance.

Return

array Settings to save or bool false to cancel saving.

Source

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

View all references View on Trac View on GitHub

Used byDescription
WP_Widget::update_callback()wp-includes/class-wp-widget.php

Handles changed settings (Do NOT override).

Changelog

VersionDescription
2.8.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.