filter_block_content

函数


filter_block_content ( $text, $allowed_html = 'post', $allowed_protocols = array() )
参数
  • (string)
    $text
    Text that may contain block content.
    Required:
  • (array[]|string)
    $allowed_html
    Optional. 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’.
    Required:
    Default: ‘post’
  • (string[])
    $allowed_protocols
    Optional. Array of allowed URL protocols. Defaults to the result of wp_allowed_protocols().
    Required:
    Default: array()
返回值
  • (string) The filtered and sanitized content result.
定义位置
  • wp-includes/blocks.php
    , line 794
引入
5.3.1
弃用

Filters and sanitizes block content to remove non-allowable HTML
from parsed block attribute values.

function filter_block_content( $text, $allowed_html = 'post', $allowed_protocols = array() ) {
	$result = '';

	$blocks = parse_blocks( $text );
	foreach ( $blocks as $block ) {
		$block   = filter_block_kses( $block, $allowed_html, $allowed_protocols );
		$result .= serialize_block( $block );
	}

	return $result;
}