# filter_block_content()

URL: https://chugunov.pro/api-wordpress/functions/filter_block_content/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 5.3.1.

## Сигнатура

```php
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`

```php
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.

## Связанные

Использует: [`filter_block_kses`](https://chugunov.pro/api-wordpress/functions/filter_block_kses/), [`serialize_block`](https://chugunov.pro/api-wordpress/functions/serialize_block/), [`parse_blocks`](https://chugunov.pro/api-wordpress/functions/parse_blocks/).
Используется в: [`wp_pre_kses_block_attributes`](https://chugunov.pro/api-wordpress/functions/wp_pre_kses_block_attributes/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/filter_block_content/