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

Timestamp:

11/12/2018 02:26:18 AM (8 years ago)

Author:

pento

Message:

Block Editor: Update @wordpress dependencies to the latest version.

Changes of note:

• Includes the new Annotations API package.
• wp-polyfill-ecmascript.js is renamed to wp-polyfill.js.
• strip_dynamic_blocks() has been removed in favour of excerpt_remove_blocks().
• The PHP block parser is now syncing from the block-serialization-default-parser package.
• do_blocks() uses the new parser.
• The do_block filter has been removed from do_blocks(), in favour of a render_block filter in render_block().

See #45145, #45190, #45264, #45282.

File:

• branches/5.0/src/wp-includes/blocks.php (modified) (4 diffs)

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

@@ -115 +115 @@
 
 /**
- * Remove all dynamic blocks from the given content.
- *
- * @since 5.0.0
- *
- * @param string $content Content of the current post.
- * @return string
- */
-function strip_dynamic_blocks( $content ) {
-        return _recurse_strip_dynamic_blocks( parse_blocks( $content ) );
-}
-
-/**
- * Helper function for strip_dynamic_blocks(), to recurse through the block tree.
- *
- * @since 5.0.0
- * @access private
- *
- * @param array $blocks Array of blocks from parse_blocks().
- * @return string HTML from the non-dynamic blocks.
- */
-function _recurse_strip_dynamic_blocks( $blocks ) {
-        $clean_content  = '';
-        $dynamic_blocks = get_dynamic_block_names();
-
-        foreach ( $blocks as $block ) {
-                if ( ! in_array( $block['blockName'], $dynamic_blocks ) ) {
-                        if ( $block['innerBlocks'] ) {
-                                $clean_content .= _recurse_strip_dynamic_blocks( $block['innerBlocks'] );
-                        } else {
-                                $clean_content .= $block['innerHTML'];
-                        }
-                }
-        }
-
-        return $clean_content;
+ * Parses blocks out of a content string, and renders those appropriate for the excerpt.
+ *
+ * As the excerpt should be a small string of text relevant to the full post content,
+ * this function renders the blocks that are most likely to contain such text.
+ *
+ * @since 5.0.0
+ *
+ * @param string $content The content to parse.
+ * @return string The parsed and filtered content.
+ */
+function excerpt_remove_blocks( $content ) {
+        $allowed_blocks = array(
+                // Classic blocks have their blockName set to null.
+                null,
+                'core/columns',
+                'core/freeform',
+                'core/heading',
+                'core/html',
+                'core/list',
+                'core/media-text',
+                'core/paragraph',
+                'core/preformatted',
+                'core/pullquote',
+                'core/quote',
+                'core/table',
+                'core/verse',
+        );
+        /**
+         * Filters the list of blocks that can contribute to the excerpt.
+         *
+         * If a dynamic block is added to this list, it must not generate another
+         * excerpt, as this will cause an infinite loop to occur.
+         *
+         * @since 4.4.0
+         *
+         * @param array $allowed_blocks The list of allowed blocks.
+         */
+        $allowed_blocks = apply_filters( 'excerpt_allowed_blocks', $allowed_blocks );
+        $blocks = parse_blocks( $content );
+        $output = '';
+         foreach ( $blocks as $block ) {
+                if ( in_array( $block['blockName'], $allowed_blocks, true ) ) {
+                        $output .= render_block( $block );
+                }
+        }
+         return $output;
+}
+
+/**
+ * Renders a single block into a HTML string.
+ *
+ * @since 5.0.0
+ *
+ * @global WP_Post $post The post to edit.
+ *
+ * @param array $block A single parsed block object.
+ * @return string String of rendered HTML.
+ */
+function render_block( $block ) {
+        global $post;
+
+        $block_type    = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );
+        $is_dynamic    = $block['blockName'] && null !== $block_type && $block_type->is_dynamic();
+        $block_content = '';
+        $index         = 0;
+
+        foreach ( $block['innerContent'] as $chunk ) {
+                $block_content .= is_string( $chunk ) ? $chunk : render_block( $block['innerBlocks'][ $index++ ] );
+        }
+
+        if ( $is_dynamic ) {
+                $attributes    = is_array( $block['attrs'] ) ? (array) $block['attrs'] : array();
+                $global_post   = $post;
+                $block_content = $block_type->render( $attributes, $block_content );
+                $post          = $global_post;
+        }
+
+        /**
+         * Filters the content of a single block.
+         *
+         * @since 5.0.0
+         *
+         * @param string $block_content The block content about to be appended.
+         * @param array  $block         The full block, including name and attributes.
+         */
+        return apply_filters( 'render_block', $block_content, $block );
 }
 
@@ -157 +208 @@
  * @since 5.0.0
  *
- * @param  string $content Post content.
- * @return array  Array of parsed block objects.
+ * @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
@@ -207 +243 @@
 
         $blocks = parse_blocks( $content );
-        return _recurse_do_blocks( $blocks, $blocks );
+        $output = '';
+
+        foreach ( $blocks as $block ) {
+                $output .= render_block( $block );
+        }
+
+        return $output;
 }
 
@@ -232 +274 @@
 
 /**
- * Helper function for do_blocks(), to recurse through the block tree.
- *
- * @since 5.0.0
- * @access private
- *
- * @param array $blocks     Array of blocks from parse_blocks().
- * @param array $all_blocks The top level array of blocks.
- * @return string The block HTML.
- */
-function _recurse_do_blocks( $blocks, $all_blocks ) {
-        global $post;
-
-        /*
-         * Back up global post, to restore after render callback.
-         * Allows callbacks to run new WP_Query instances without breaking the global post.
-         */
-        $global_post = $post;
-
-        $rendered_content = '';
-        $dynamic_blocks   = get_dynamic_block_names();
-
-        foreach ( $blocks as $block ) {
-                $block = (array) $block;
-                if ( in_array( $block['blockName'], $dynamic_blocks ) ) {
-                        // Find registered block type. We can assume it exists since we use the
-                        // `get_dynamic_block_names` function as a source for pattern matching.
-                        $block_type = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );
-
-                        // Replace dynamic block with server-rendered output.
-                        $block_content = $block_type->render( (array) $block['attrs'], $block['innerHTML'] );
-                } else if ( $block['innerBlocks'] ) {
-                        $block_content = _recurse_do_blocks( $block['innerBlocks'], $blocks );
-                } else {
-                        $block_content = $block['innerHTML'];
-                }
-
-                /**
-                 * Filters the content of a single block.
-                 *
-                 * During the_content, each block is parsed and added to the output individually. This filter allows
-                 * that content to be altered immediately before it's appended.
-                 *
-                 * @since 5.0.0
-                 *
-                 * @param string $block_content The block content about to be appended.
-                 * @param array  $block         The full block, including name and attributes.
-                 * @param array  $all_blocks    The array of all blocks being processed.
-                 */
-                $rendered_content .= apply_filters( 'do_block', $block_content, $block, $all_blocks );
-
-                // Restore global $post.
-                $post = $global_post;
-        }
-
-        // Strip remaining block comment demarcations.
-        $rendered_content = preg_replace( '/<!--\s+\/?wp:.*?-->/m', '', $rendered_content );
-
-        return $rendered_content;
-}
-
-/**
  * Returns the current version of the block format that the content string is using.
  *