wp_kses_normalize_entities() WordPress Function
The wp_kses_normalize_entities() function is used to normalize entities in an HTML string. This function is used by the kses HTML filtering library.
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 &
$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;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.5.0 | Added $context parameter. |
| 1.0.0 | Introduced. |