WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_kses_normalize_entities()

wp_kses_normalize_entities( string $content, string $context = ‘html’ ): string

In this article

Back to top

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

$contentstringrequired
Content to normalize entities.
$contextstringoptional
Context for normalization. Can be either 'html' or 'xml'.
Default 'html'.

Default:'html'

Return

string Content with normalized entities.

Source

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

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

	return $content;
}

View all references View on Trac View on GitHub

Used byDescription
esc_url()wp-includes/formatting.php

Checks and cleans a URL.

_wp_specialchars()wp-includes/formatting.php

Converts a number of special characters into their HTML entities.

wp_kses()wp-includes/kses.php

Filters text content and strips out disallowed HTML.

Changelog

VersionDescription
5.5.0Added $context parameter.
1.0.0Introduced.

User Contributed Notes

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