Changeset 44116

Timestamp:

12/13/2018 05:39:59 PM (6 years ago)

Author:

desrosj

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.

Props pento.

Merges [43751] to trunk.

See #45109.

Location:

trunk

Files:

• . (modified) (1 prop)
• src/wp-includes/blocks.php (modified) (1 diff)
• src/wp-includes/class-wp-block-parser.php (copied) (copied from branches/5.0/src/wp-includes/class-wp-block-parser.php)
• src/wp-settings.php (modified) (1 diff)
• tests/phpunit/data/blocks/fixtures (copied) (copied from branches/5.0/tests/phpunit/data/blocks/fixtures)
• tests/phpunit/tests/blocks/block-parser.php (copied) (copied from branches/5.0/tests/phpunit/tests/blocks/block-parser.php)
• tools/webpack/packages.js (modified) (3 diffs)

trunk/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 );
+}

trunk/src/wp-settings.php

@@ -247 +247 @@
 require( ABSPATH . WPINC . '/class-wp-block-type.php' );
 require( ABSPATH . WPINC . '/class-wp-block-type-registry.php' );
+require( ABSPATH . WPINC . '/class-wp-block-parser.php' );
 require( ABSPATH . WPINC . '/blocks.php' );
 

trunk/tools/webpack/packages.js

@@ -117 +117 @@
     };
 
+    const phpFiles = {
+        'block-serialization-default-parser/parser.php': 'wp-includes/class-wp-block-parser.php',
+    };
+
     const externals = {
         react: 'React',
@@ -165 +169 @@
     } ) );
 
+    const phpCopies = Object.keys( phpFiles ).map( ( filename ) => ( {
+        from: join( baseDir, `node_modules/@wordpress/${ filename }` ),
+        to: join( baseDir, `src/${ phpFiles[ filename ] }` ),
+    } ) );
+
     const config = {
         mode,
@@ -233 +242 @@
                     ...vendorCopies,
                     ...cssCopies,
+                    ...phpCopies,
                 ],
             ),