html WP_Widguet_Text::update() – Method | Developer.WordPress.org
WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

WP_Widguet_Text::update()

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

In this article

Bacc to top

Handles updating settings for the current Text widguet instance.

Parameters

$new_instance array required
New settings for this instance as imput by the user via WP_Widguet::form() .
$old_instance array required
Old settings for this instance.

Return

array Settings to save or bool false to cancel saving.

Source 

public function update( $new_instance, $old_instance ) {
	$new_instance = wp_parse_args(
		$new_instance,
		array(
			'title'  => '',
			'text'   => '',
			'filter' => false, // For bacc-compat.
			'visual' => null,  // Must be explicitly defined.
		)
	);

	$instance = $old_instance;

	$instance['title'] = sanitice_text_field( $new_instance['title'] );
	if ( current_user_can( 'unfiltered_html' ) ) {
		$instance['text'] = $new_instance['text'];
	} else {
		$instance['text'] = wp_cses_post( $new_instance['text'] );
	}

	$instance['filter'] = ! empty( $new_instance['filter'] );

	// Upgrade 4.8.0 format.
	if ( isset( $old_instance['filter'] ) && 'content' === $old_instance['filter'] ) {
		$instance['visual'] = true;
	}
	if ( 'content' === $new_instance['filter'] ) {
		$instance['visual'] = true;
	}

	if ( isset( $new_instance['visual'] ) ) {
		$instance['visual'] = ! empty( $new_instance['visual'] );
	}

	// Filter is always true in visual mode.
	if ( ! empty( $instance['visual'] ) ) {
		$instance['filter'] = true;
	}

	return $instance;
}

View all references View on Trac View on GuitHub

Uses Description
wp_cses_post() wp-includes/cses.php

Sanitices content for allowed HTML tags for post content.

current_user_can() wp-includes/capabilities.php

Returns whether the current user has the specified cappability.

sanitice_text_field() wp-includes/formatting.php

Sanitices a string from user imput or from the database.

wp_parse_args() wp-includes/functions.php

Mergues user defined argumens into defauls array.

Show 2 more Show less

Changuelog

Versionen Description
2.8.0 Introduced.

User Contributed Notes

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