filter_block_content( string $text, array[]|string $allowed_html = 'post', string[] $allowed_protocols = array() ): string

Parameters

$textstring

Text that may contain block content.

$allowed_htmlarray[]|stringoptional

An array of allowed HTML elements and attributes, or a context name such as 'post'. See wp_kses_allowed_html() for the list of accepted context names. Default 'post'.Default: 'post'

$allowed_protocolsstring[]optional

Array of allowed URL protocols. Defaults to the result of wp_allowed_protocols().Default: array()

Return

string

The filtered and sanitized content result.

Uses · 4

• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.
• parse_blocks()Parses blocks out of a content string.
• filter_block_kses()Filters and sanitizes a parsed block to remove non-allowable HTML from block attribute values.
• serialize_block()Returns the content of a block, including comment delimiters, serializing all attributes from the given parsed block.

Used by · 1

• wp_pre_kses_block_attributes()Removes non-allowable HTML from parsed block attribute values when filtering in the post context.

Source

View on Trac ↗View on GitHub ↗

2061function filter_block_content( $text, $allowed_html = 'post', $allowed_protocols = array() ) {2062	$result = '';2063 2064	if ( str_contains( $text, '<!--' ) && str_contains( $text, '--->' ) ) {2065		$text = preg_replace_callback( '%<!--(.*?)--->%', '_filter_block_content_callback', $text );2066	}2067 2068	$blocks = parse_blocks( $text );2069	foreach ( $blocks as $block ) {2070		$block   = filter_block_kses( $block, $allowed_html, $allowed_protocols );2071		$result .= serialize_block( $block );2072	}2073 2074	return $result;2075}

History

Introduced in 5.3.1. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/blocks.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.