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

Converts and fixes HTML entities.


Description 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;.


Top ↑

Parameters Parameters

$string

(string) (Required) Content to normalize entities.

$context

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

Default value: 'html'


Top ↑

Return Return

(string) Content with normalized entities.


Top ↑

Source Source

File: wp-includes/kses.php

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

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

	return $string;
}


Top ↑

Changelog Changelog

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

Top ↑

User Contributed Notes User Contributed Notes

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