Changeset 60955

Timestamp:

10/17/2025 03:05:55 PM (5 weeks 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 ) ) {