Changeset 57514

Timestamp:

02/01/2024 12:52:54 PM (6 months ago)

Author:

youknowriad

Message:

Editor: Add the Block Bindings API.

This introduces the Block Bindings API for WordPress.

The API allows developers to connects block attributes to different sources. In this PR, two such sources are included: "post meta" and "pattern". Attributes connected to sources can have their HTML replaced by values coming from the source in a way defined by the binding.

Props czapla, lgladdy, gziolo, sc0ttkclark, swissspidy, artemiosans, kevin940726, fabiankaegy, santosguillamot, talldanwp, wildworks.
Fixes #60282.

Location:

trunk

Files:

• src/wp-includes/block-bindings (added)
• src/wp-includes/block-bindings.php (modified) (1 diff)
• src/wp-includes/block-bindings/sources (added)
• src/wp-includes/block-bindings/sources/pattern.php (added)
• src/wp-includes/block-bindings/sources/post-meta.php (added)
• src/wp-includes/class-wp-block-bindings-registry.php (modified) (1 diff)
• src/wp-includes/class-wp-block.php (modified) (2 diffs)
• src/wp-settings.php (modified) (1 diff)
• tests/phpunit/includes/functions.php (modified) (2 diffs)
• tests/phpunit/tests/block-bindings/block-bindings.php (added)
• tests/phpunit/tests/block-bindings/register.php (modified) (2 diffs)

trunk/src/wp-includes/block-bindings.php

@@ -20 +20 @@
  * @since 6.5.0
  *
- * @param string   $source_name       The name of the source.
+ * @param string   $source_name       The name of the source. It must be a string containing a namespace prefix, i.e.
+ *                                    `my-plugin/my-custom-source`. It must only contain lowercase alphanumeric
+ *                                    characters, the forward slash `/` and dashes.
  * @param array    $source_properties {
  *     The array of arguments that are used to register a source.

trunk/src/wp-includes/class-wp-block-bindings-registry.php

@@ -43 +43 @@
      * @since 6.5.0
      *
-     * @param string   $source_name       The name of the source.
+     * @param string   $source_name       The name of the source. It must be a string containing a namespace prefix, i.e.
+     *                                    `my-plugin/my-custom-source`. It must only contain lowercase alphanumeric
+     *                                    characters, the forward slash `/` and dashes.
      * @param array    $source_properties {
      *     The array of arguments that are used to register a source.

trunk/src/wp-includes/class-wp-block.php

@@ -193 +193 @@
 
     /**
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
      * Generates the render output for the block.
      *
@@ -286 +484 @@
             }
         }
+
+
+
+
 
         /**

trunk/src/wp-settings.php

@@ -377 +377 @@
 require ABSPATH . WPINC . '/class-wp-script-modules.php';
 require ABSPATH . WPINC . '/script-modules.php';
+
+
 require ABSPATH . WPINC . '/interactivity-api.php';
 

trunk/tests/phpunit/includes/functions.php

@@ -340 +340 @@
  */
 function _unhook_block_registration() {
+
     require __DIR__ . '/unregister-blocks-hooks.php';
     remove_action( 'init', 'register_core_block_types_from_metadata' );
@@ -345 +346 @@
     remove_action( 'init', 'register_block_core_widget_group' );
     remove_action( 'init', 'register_core_block_types_from_metadata' );
+
+
+
+
 }
 tests_add_filter( 'init', '_unhook_block_registration', 1000 );

trunk/tests/phpunit/tests/block-bindings/register.php

@@ -18 +18 @@
 
     /**
+
+
+
+
+
+
+
+
+
+
+
+
+
      * Tear down after each test.
      *
@@ -24 +37 @@
     public function tear_down() {
         foreach ( get_all_registered_block_bindings_sources() as $source_name => $source_properties ) {
-            if ( str_starts_with( $source_name, 'test/' ) ) {
-                unregister_block_bindings_source( $source_name );
-            }
+            unregister_block_bindings_source( $source_name );
         }