Changeset 43751 for branches/5.0/src/wp-includes/blocks.php

Timestamp:

10/18/2018 04:39:40 AM (2 years ago)

Author:

pento

Message:

Blocks: Introduce the block parser.

The WP_Block_Parser class, and the accompanying parse_blocks() helper function, can be used to parse an array of blocks out of a content string.

WP_Block_Parser is copied from the @wordpress/block-serialization-default-parser package. To ensure it stays in sync with the JavaScript parser, changes should be implemented in the package first, then the package version should be upgraded to include the changes.

See #45109.

File:

• branches/5.0/src/wp-includes/blocks.php (modified) (1 diff)

branches/5.0/src/wp-includes/blocks.php

@@ -113 +113 @@
     return $dynamic_block_names;
 }
+
+/**
+ * Parses blocks out of a content string.
+ *
+ * @since 5.0.0
+ *
+ * @param  string $content Post content.
+ * @return array  Array of parsed block objects.
+ */
+function parse_blocks( $content ) {
+    /*
+     * If there are no blocks in the content, return a single block, rather
+     * than wasting time trying to parse the string.
+     */
+    if ( ! has_blocks( $content ) ) {
+        return array(
+            array(
+                'blockName'   => null,
+                'attrs'       => array(),
+                'innerBlocks' => array(),
+                'innerHTML'   => $content,
+            ),
+        );
+    }
+
+    /**
+     * Filter to allow plugins to replace the server-side block parser
+     *
+     * @since 5.0.0
+     *
+     * @param string $parser_class Name of block parser class
+     */
+    $parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' );
+
+    $parser = new $parser_class();
+    return $parser->parse( $content );
+}