функция
since 5.3.1
filter_block_content()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
filter_block_content( string $text, array[]|string $allowed_html = 'post', string[] $allowed_protocols = array() ): stringОписание
Фильтрует и очищает содержимое блока, удаляя недопустимый HTML из значений атрибутов разобранного блока.
Параметры
$text
string
обязательный
Текст, который может содержать содержимое блоков.
$allowed_html
array[]|string
необязательный
= 'post'
Массив разрешённых HTML-элементов и атрибутов либо имя контекста, например 'post'. Список допустимых имён контекстов см. в wp_kses_allowed_html(). Значение по умолчанию 'post'.
$allowed_protocols
string[]
необязательный
= array()
Массив разрешённых URL-протоколов.
По умолчанию — результат работы wp_allowed_protocols().
Возвращаемое значение
string
Исходный код
wp-includes/blocks.php:2061
function filter_block_content( $text, $allowed_html = 'post', $allowed_protocols = array() ) {
$result = '';
if ( str_contains( $text, '<!--' ) && str_contains( $text, '--->' ) ) {
$text = preg_replace_callback( '%<!--(.*?)--->%', '_filter_block_content_callback', $text );
}
$blocks = parse_blocks( $text );
foreach ( $blocks as $block ) {
$block = filter_block_kses( $block, $allowed_html, $allowed_protocols );
$result .= serialize_block( $block );
}
return $result;
}История изменений
| Версия | Описание |
|---|---|
| 5.3.1 | Introduced. |
