1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
<?php
namespace Yoast\WP\SEO\Helpers;
use WP_Block_Parser_Block;
/**
* A helper object for blocks.
*/
class Blocks_Helper {
/**
* Holds the Post_Helper instance.
*
* @var Post_Helper
*/
private $post;
/**
* Constructs a Blocks_Helper instance.
*
* @codeCoverageIgnore It handles dependencies.
*
* @param Post_Helper $post The post helper.
*/
public function __construct( Post_Helper $post ) {
$this->post = $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() ) {
return [];
}
$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() ) {
return [];
}
$collection = [];
$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 );
}
}
return $collection;
}
}
|