wp_kses_normalize_entities( string $content, 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

$content

(Required) Content to normalize entities.

$context

(Optional) Context for normalization. Can be either 'html' or 'xml'.<br> Default 'html'.

Default value: 'html'

Return

(string) Content with normalized entities.

Source

File: wp-includes/kses.php

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

	// Change back the allowed entities in our entity whitelist
	$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;
}

Expand Source Code View on GitHub

Used By

Used By
Used By	Description
wp-includes/kses.php: wp_kses()	Filters text content and strips out disallowed HTML.
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.

Changelog

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