wp_kses_bad_protocol_once2() │ WP 1.0.0

Callback for wp_kses_bad_protocol_once() expression.

This function processes URL protocols, checks to see if they're in the list of allowed protocols or not, and returns different data depending on the answer.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

string. Sanitized content.

Использование

wp_kses_bad_protocol_once2( $scheme, $allowed_protocols );
$scheme(строка) (обязательный)
URI scheme to check against the list of allowed protocols.
$allowed_protocols(string[]) (обязательный)
Array of allowed URL protocols.

Список изменений

С версии 1.0.0 Введена.

Код wp_kses_bad_protocol_once2() WP 7.1

wp-includes/kses.php 
function wp_kses_bad_protocol_once2( $scheme, $allowed_protocols ) {
	$scheme = wp_kses_decode_entities( $scheme );
	$scheme = preg_replace( '/\s/', '', $scheme );
	$scheme = wp_kses_no_null( $scheme );
	$scheme = strtolower( $scheme );

	$allowed = array_any( (array) $allowed_protocols, fn( $protocol ) => strtolower( $protocol ) === $scheme );

	if ( $allowed ) {
		return "$scheme:";
	} else {
		return '';
	}
}