serialize_block( array $block ): string

Returns the content of a block, including comment delimiters, serializing all attributes from the given parsed block.

Contents

Description

This should be used when preparing a block to be saved to post content.
Prefer render_block when preparing a block for display. Unlike render_block, this does not evaluate a block’s render_callback, and will instead preserve the markup as parsed.

Top ↑

Parameters

$block array Required
A representative array of a single parsed block object. See WP_Block_Parser_Block.

Top ↑

Return

string String of rendered HTML.

Top ↑

Source

File: wp-includes/blocks.php. View all references 

function serialize_block( $block ) {
	$block_content = '';

	$index = 0;
	foreach ( $block['innerContent'] as $chunk ) {
		$block_content .= is_string( $chunk ) ? $chunk : serialize_block( $block['innerBlocks'][ $index++ ] );
	}

	if ( ! is_array( $block['attrs'] ) ) {
		$block['attrs'] = array();
	}

	return get_comment_delimited_block_content(
		$block['blockName'],
		$block['attrs'],
		$block_content
	);
}

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
_inject_theme_attribute_in_block_template_content() wp-includes/block-template-utils.php

Parses wp_template content and injects the active theme’s stylesheet as a theme attribute into each wp_template_part
_remove_theme_attribute_in_block_template_content() wp-includes/block-template-utils.php

Parses a block template and removes the theme attribute from each template part.
filter_block_content() wp-includes/blocks.php

Filters and sanitizes block content to remove non-allowable HTML from parsed block attribute values.
serialize_block() wp-includes/blocks.php

Returns the content of a block, including comment delimiters, serializing all attributes from the given parsed block.

Top ↑

Changelog

Changelog
Version Description
5.3.1 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Muhammad Saqib Sarwar —

    A sample code to understand how this works. I am using https://developer.wordpress.org/cli/commands/eval-file/ to execute this.

    /*
 * Create a block programmatically and serialize it.
 */
$block_name = 'core/paragraph';
$innerHTML  = 'Sample paragraph text.';

$converted_block = new WP_Block_Parser_Block( $block_name, array(), array(), $innerHTML, array( $innerHTML ) );
WP_CLI::log( print_r( $converted_block, true ) );

$serialized_block = serialize_block( (array) $converted_block );
WP_CLI::log( $serialized_block );

You must log in before being able to contribute a note or feedback.