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.
Return
(array) Updated settings to save.
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;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |