Changeset 60955 for trunk/src/wp-includes/block-bindings/post-data.php

Timestamp:

10/17/2025 03:05:55 PM (12 months ago)

Author:

cbravobernal

Message:

Block Bindings: Use field instead of key in post-data source.

After the UI refactor, source args can contain anything, and using whatever fits better for each source is encouraged.
Instead of using a post-meta based key argument. post-data will use field as an argument, which fits better to post related use cases.

Props cbravobernal, bernhard-reiter.
Fixes #64112.

File:

• trunk/src/wp-includes/block-bindings/post-data.php (modified) (2 diffs)

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

@@ -15 +15 @@
  *
  * @param array    $source_args    Array containing arguments used to look up the source value.
- *                                 Example: array( "key" => "foo" ).
+ *                                 Example: array( "field" => "foo" ).
  * @param WP_Block $block_instance The block instance.
  * @return mixed The value computed for the source.
  */
 function _block_bindings_post_data_get_value( array $source_args, $block_instance ) {
-        if ( empty( $source_args['key'] ) ) {
-                return null;
+        if ( empty( $source_args['field'] ) ) {
+                // Backward compatibility for when the source argument was called `key` in Gutenberg plugin.
+                if ( empty( $source_args['key'] ) ) {
+                        return null;
+                }
+                $field = $source_args['key'];
+        } else {
+                $field = $source_args['field'];
         }
 
@@ -54 +60 @@
         }
 
-        if ( 'date' === $source_args['key'] ) {
+        if ( 'date' === $field ) {
                 return esc_attr( get_the_date( 'c', $post_id ) );
         }
 
-        if ( 'modified' === $source_args['key'] ) {
+        if ( 'modified' === $field ) {
                 // Only return the modified date if it is later than the publishing date.
                 if ( get_the_modified_date( 'U', $post_id ) > get_the_date( 'U', $post_id ) ) {