Automatic_Upgrader_Skin::feedback( string|array|WP_Error $feedback, mixed $args )

Stores a message about the upgrade.


Parameters

$feedback string|array|WP_Error Required
Message data.
$args mixed Optional
text replacements.

Top ↑

Source

File: wp-admin/includes/class-automatic-upgrader-skin.php. View all references

public function feedback( $feedback, ...$args ) {
	if ( is_wp_error( $feedback ) ) {
		$string = $feedback->get_error_message();
	} elseif ( is_array( $feedback ) ) {
		return;
	} else {
		$string = $feedback;
	}

	if ( ! empty( $this->upgrader->strings[ $string ] ) ) {
		$string = $this->upgrader->strings[ $string ];
	}

	if ( strpos( $string, '%' ) !== false ) {
		if ( ! empty( $args ) ) {
			$string = vsprintf( $string, $args );
		}
	}

	$string = trim( $string );

	// Only allow basic HTML in the messages, as it'll be used in emails/logs rather than direct browser output.
	$string = wp_kses(
		$string,
		array(
			'a'      => array(
				'href' => true,
			),
			'br'     => true,
			'em'     => true,
			'strong' => true,
		)
	);

	if ( empty( $string ) ) {
		return;
	}

	$this->messages[] = $string;
}


Top ↑

Changelog

Changelog
Version Description
5.9.0 Renamed $data to $feedback for PHP 8 named parameter support.
3.7.0 Introduced.

Top ↑

User Contributed Notes

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