parse_blocks( string $content ): array[]

Parameters

$contentstring

Post content.

Return

array[]

Array of block structures.

• ...$0array

  An associative array of a single parsed block object. See WP_Block_Parser_Block.

  • $blockNamestring

    Name of block.

  • $attrsarray

    Attributes from block comment delimiters.

  • $innerBlocksarray[]

    List of inner blocks. An array of arrays that have the same structure as this one.

  • $innerHTMLstring

    HTML from inside block comment delimiters.

  • $innerContentarray

    List of string fragments and null markers where inner blocks were found.

Hooks fired · 1

One hook fires while parse_blocks() runs, in this order:

1. 1
   apply_filters( block_parser_class )filterline 2224 (+8 into the body)

   Filter to allow plugins to replace the server-side block parser.

Uses · 1

• apply_filters()Calls the callback functions that have been added to a filter hook.

Used by · 21

• WP_Navigation_Block_Renderer::get_inner_blocks_from_navigation_post()Gets the inner blocks for the navigation block from the navigation post.
• WP_REST_Block_Patterns_Controller::prepare_item_for_response()Prepare a raw block pattern before it gets output in a REST API response.
• WP_REST_Templates_Controller::prepare_item_for_response()Prepare a single template output for response
• WP_Widget_Block::get_dynamic_classname()Calculates the classname to use in the block widget's container HTML.
• _inject_theme_attribute_in_block_template_content()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()Parses a block template and removes the theme attribute from each template part.
• apply_block_hooks_to_content()Runs the hooked blocks algorithm on the given content.
• block_core_navigation_get_fallback_blocks()Retrieves the appropriate fallback to be used on the front of the site when there is no menu assigned to the Nav block.
• block_core_navigation_insert_hooked_blocks_into_rest_response()Hooks into the REST API response for the core/navigation block and adds the first and last inner blocks.
• block_core_navigation_update_ignore_hooked_blocks_meta()Updates the post meta with the list of ignored hooked blocks when the navigation is created or updated via the REST API.
• do_blocks()Parses dynamic blocks out of `post_content` and re-renders them.
• excerpt_remove_blocks()Parses blocks out of a content string, and renders those appropriate for the excerpt.

Source

View on Trac ↗View on GitHub ↗

2216function parse_blocks( $content ) {2217	/**2218	 * Filter to allow plugins to replace the server-side block parser.2219	 *2220	 * @since 5.0.02221	 *2222	 * @param string $parser_class Name of block parser class.2223	 */2224	$parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' );2225 2226	$parser = new $parser_class();2227	return $parser->parse( $content );2228}

History

Introduced in 5.0.0. 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 6.7.7 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.