A WordPress-centric search engine for devs and theme authors



filter_block_kses_value ›

Since5.3.1
Deprecatedn/a
filter_block_kses_value ( $value, $allowed_html, $allowed_protocols = array() )
Parameters: (3)
  • (string[]|string) value The attribute value to filter.
    Required: Yes
  • (array[]|string) allowed_html An array of allowed HTML elements and attributes, or a context name such as 'post'.
    Required: Yes
  • (string[]) allowed_protocols Array of allowed URL protocols.
    Required: No
    Default: array()
Returns:
  • (string[]|string) The filtered and sanitized result.
Defined at:
Codex:

Filters and sanitizes a parsed block attribute value to remove non-allowable HTML.



Source

function filter_block_kses_value( $value, $allowed_html, $allowed_protocols = array() ) {
	if ( is_array( $value ) ) {
		foreach ( $value as $key => $inner_value ) {
			$filtered_key   = filter_block_kses_value( $key, $allowed_html, $allowed_protocols );
			$filtered_value = filter_block_kses_value( $inner_value, $allowed_html, $allowed_protocols );

			if ( $filtered_key !== $key ) {
				unset( $value[ $key ] );
			}

			$value[ $filtered_key ] = $filtered_value;
		}
	} elseif ( is_string( $value ) ) {
		return wp_kses( $value, $allowed_html, $allowed_protocols );
	}

	return $value;
}