Changeset 56587 for trunk/src/wp-includes/blocks.php

Timestamp:

09/14/2023 01:23:13 PM (3 years ago)

Author:

Bernhard Reiter

Message:

General: Add block_hooks field to block type registration, REST API.

In order to implement Block Hooks, we need to add a new block_hooks field to the WP_Block_Type class, as well as to block registration related functions, the block types REST API controller, etc.

Props gziolo.
Fixes #59346. See #59313.

File:

• trunk/src/wp-includes/blocks.php (modified) (2 diffs)

trunk/src/wp-includes/blocks.php

@@ -343 +343 @@
  * @since 6.1.0 Added support for `render` field.
  * @since 6.3.0 Added `selectors` field.
+ * @since 6.4.0 Added support for `blockHooks` field.
  *
  * @param string $file_or_folder Path to the JSON file with metadata definition for
@@ -514 +515 @@
         }
 
+        if ( ! empty( $metadata['blockHooks'] ) ) {
+                /**
+                 * Map camelCased position string (from block.json) to snake_cased block type position.
+                 *
+                 * @var array
+                 */
+                $position_mappings = array(
+                        'before'     => 'before',
+                        'after'      => 'after',
+                        'firstChild' => 'first_child',
+                        'lastChild'  => 'last_child',
+                );
+
+                $settings['block_hooks'] = array();
+                foreach ( $metadata['blockHooks'] as $anchor_block_name => $position ) {
+                        // Avoid infinite recursion (hooking to itself).
+                        if ( $metadata['name'] === $anchor_block_name ) {
+                                _doing_it_wrong(
+                                        __METHOD__,
+                                        __( 'Cannot hook block to itself.', 'gutenberg' ),
+                                        '6.4.0'
+                                );
+                                continue;
+                        }
+
+                        if ( ! isset( $position_mappings[ $position ] ) ) {
+                                continue;
+                        }
+
+                        $settings['block_hooks'][ $anchor_block_name ] = $position_mappings[ $position ];
+                }
+        }
+
         if ( ! empty( $metadata['render'] ) ) {
                 $template_path = wp_normalize_path(