get_comment_delimited_block_content() – Function

Returns the content of a block, including comment delimiters.

Parameters

$block_namestring|nullrequired: Block name. Null if the block name is unknown, e.g. Classic blocks have their name set to null.
$block_attributesarrayrequired: Block attributes.
$block_contentstringrequired: Block save content.

Return

string Comment-delimited block content.

Source

function get_comment_delimited_block_content( $block_name, $block_attributes, $block_content ) {
	if ( is_null( $block_name ) ) {
		return $block_content;
	}

	$serialized_block_name = strip_core_block_namespace( $block_name );
	$serialized_attributes = empty( $block_attributes ) ? '' : serialize_block_attributes( $block_attributes ) . ' ';

	if ( empty( $block_content ) ) {
		return sprintf( '<!-- wp:%s %s/-->', $serialized_block_name, $serialized_attributes );
	}

	return sprintf(
		'<!-- wp:%s %s-->%s<!-- /wp:%s -->',
		$serialized_block_name,
		$serialized_attributes,
		$block_content,
		$serialized_block_name
	);
}

View all references View on Trac View on GitHub

Uses	Description
strip_core_block_namespace()`wp-includes/blocks.php`	Returns the block name to use for serialization. This will remove the default “core/” namespace from a block name.
serialize_block_attributes()`wp-includes/blocks.php`	Given an array of attributes, returns a string in the serialized attributes format prepared for post content.

Used by	Description
insert_hooked_blocks_into_rest_response()`wp-includes/blocks.php`	Hooks into the REST API response for the core/navigation block and adds the first and last inner blocks.
update_ignored_hooked_blocks_postmeta()`wp-includes/blocks.php`	Updates the wp_postmeta with the list of ignored hooked blocks where the inner blocks are stored as post content.
traverse_and_serialize_block()`wp-includes/blocks.php`	Traverses a parsed block tree and applies callbacks before and after serializing it.
serialize_block()`wp-includes/blocks.php`	Returns the content of a block, including comment delimiters, serializing all attributes from the given parsed block.

Changelog

Version	Description
5.3.1	Introduced.

get_comment_delimited_block_content( string|null $block_name, array $block_attributes, string $block_content ): string

In this article

Parameters

Return

Source

Changelog

User Contributed Notes

get_comment_delimited_block_content( string|null $block_name, array $block_attributes, string $block_content ): string

In this article

Parameters

Return

Source

Related

Changelog

User Contributed Notes