WP_Widget_Pages::update() WordPress Method

The WP_Widget_Pages::update() method is used to update the settings for a particular widget instance. This is called when the user saves the widget form in the admin area. The new settings are passed as an array of name => value pairs.

WP_Widget_Pages::update( array $new_instance, array $old_instance ) #

Handles updating settings for the current Pages 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.


Top ↑

Return

(array) Updated settings to save.


Top ↑

Source

File: wp-includes/widgets/class-wp-widget-pages.php

	public function update( $new_instance, $old_instance ) {
		$instance          = $old_instance;
		$instance['title'] = sanitize_text_field( $new_instance['title'] );
		if ( in_array( $new_instance['sortby'], array( 'post_title', 'menu_order', 'ID' ), true ) ) {
			$instance['sortby'] = $new_instance['sortby'];
		} else {
			$instance['sortby'] = 'menu_order';
		}

		$instance['exclude'] = sanitize_text_field( $new_instance['exclude'] );

		return $instance;
	}


Top ↑

Changelog

Changelog
VersionDescription
2.8.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.