W3cubDocs

wp_kses_normalize_entities( string $string, string $context = 'html' )

Converts and fixes HTML entities.

Description

This function normalizes HTML entities. It will convert AT&T to the correct AT&T, : to :, &#XYZZY; to &#XYZZY; and so on.

When $context is set to ‘xml’, HTML entities are converted to their code points. For example, AT&T…&#XYZZY; is converted to AT&T…&#XYZZY;.

Parameters

$string

(string) (Required) Content to normalize entities.

$context

(string) (Optional) Context for normalization. Can be either 'html' or 'xml'.

Default value: 'html'

Return

(string) Content with normalized entities.

Source

File: wp-includes/kses.php

function wp_kses_normalize_entities( $string, $context = 'html' ) {
	// Disarm all entities by converting & to &amp;
	$string = str_replace( '&', '&amp;', $string );

	// Change back the allowed entities in our list of allowed entities.
	if ( 'xml' === $context ) {
		$string = preg_replace_callback( '/&amp;([A-Za-z]{2,8}[0-9]{0,2});/', 'wp_kses_xml_named_entities', $string );
	} else {
		$string = preg_replace_callback( '/&amp;([A-Za-z]{2,8}[0-9]{0,2});/', 'wp_kses_named_entities', $string );
	}
	$string = preg_replace_callback( '/&amp;#(0*[0-9]{1,7});/', 'wp_kses_normalize_entities2', $string );
	$string = preg_replace_callback( '/&amp;#[Xx](0*[0-9A-Fa-f]{1,6});/', 'wp_kses_normalize_entities3', $string );

	return $string;
}

Used By

Used By	Description
wp-includes/formatting.php: esc_url()	Checks and cleans a URL.
wp-includes/formatting.php: _wp_specialchars()	Converts a number of special characters into their HTML entities.
wp-includes/kses.php: wp_kses()	Filters text content and strips out disallowed HTML.

Changelog

Version	Description
5.5.0	Added `$context` parameter.
1.0.0	Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_kses_normalize_entities