namespace Yoast\WP\SEO\Helpers;
use WP_Block_Parser_Block;
* A helper object for blocks.
* Holds the Post_Helper instance.
* Constructs a Blocks_Helper instance.
* @codeCoverageIgnore It handles dependencies.
* @param Post_Helper $post The post helper.
public function __construct( Post_Helper $post ) {
* Returns all blocks in a given post.
* @param int $post_id The post id.
* @return array The blocks in a block-type => WP_Block_Parser_Block[] format.
public function get_all_blocks_from_post( $post_id ) {
if ( ! $this->has_blocks_support() ) {
$post = $this->post->get_post( $post_id );
return $this->get_all_blocks_from_content( $post->post_content );
* Returns all blocks in a given content.
* @param string $content The content.
* @return array The blocks in a block-type => WP_Block_Parser_Block[] format.
public function get_all_blocks_from_content( $content ) {
if ( ! $this->has_blocks_support() ) {
$blocks = \parse_blocks( $content );
return $this->collect_blocks( $blocks, $collection );
* Checks if the installation has blocks support.
* @codeCoverageIgnore It only checks if a WordPress function exists.
* @return bool True when function parse_blocks exists.
protected function has_blocks_support() {
return \function_exists( 'parse_blocks' );
* Collects an array of blocks into an organised collection.
* @param WP_Block_Parser_Block[] $blocks The blocks.
* @param array $collection The collection.
* @return array The blocks in a block-type => WP_Block_Parser_Block[] format.
private function collect_blocks( $blocks, $collection ) {
foreach ( $blocks as $block ) {
if ( ! isset( $collection[ $block['blockName'] ] ) || ! \is_array( $collection[ $block['blockName'] ] ) ) {
$collection[ $block['blockName'] ] = [];
$collection[ $block['blockName'] ][] = $block;
if ( isset( $block['innerBlocks'] ) ) {
$collection = $this->collect_blocks( $block['innerBlocks'], $collection );