From b73447650925f02a5950366e0bd1957a3abde630 Mon Sep 17 00:00:00 2001
From: cbravobernal <cbravobernal@git.wordpress.org>
Date: Tue, 3 Sep 2024 16:33:15 +0000
Subject: [PATCH] Block bindings: Adds a filter to customize the output of a
 block bindings source.

Introduces a filter to the `block_bindings_source_value` to allow developers to
modify the value returned by any block binding source.

Props snehapatil02, cbravobernal, gziolo, santosguillamot, bacoords, codersantosh.
Fixes #61181.


Built from https://develop.svn.wordpress.org/trunk@58972


git-svn-id: http://core.svn.wordpress.org/trunk@58368 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 .../class-wp-block-bindings-source.php        | 31 +++++++++++++------
 wp-includes/version.php                       |  2 +-
 2 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/wp-includes/class-wp-block-bindings-source.php b/wp-includes/class-wp-block-bindings-source.php
index c1b479f20e..b71f020e28 100644
--- a/wp-includes/class-wp-block-bindings-source.php
+++ b/wp-includes/class-wp-block-bindings-source.php
@@ -2,7 +2,6 @@
 /**
  * Block Bindings API: WP_Block_Bindings_Source class.
  *
- *
  * @package WordPress
  * @subpackage Block Bindings
  * @since 6.5.0
@@ -60,8 +59,8 @@ final class WP_Block_Bindings_Source {
 	 *
 	 * @since 6.5.0
 	 *
-	 * @param string $name               The name of the source.
-	 * @param array  $source_properties  The properties of the source.
+	 * @param string $name              The name of the source.
+	 * @param array  $source_properties The properties of the source.
 	 */
 	public function __construct( string $name, array $source_properties ) {
 		$this->name = $name;
@@ -71,18 +70,32 @@ final class WP_Block_Bindings_Source {
 	}
 
 	/**
-	 * Retrieves the value from the source.
+	 * Calls the callback function specified in the `$get_value_callback` property
+	 * with the given arguments and returns the result. It can be modified with
+	 * `block_bindings_source_value` filter.
 	 *
 	 * @since 6.5.0
+	 * @since 6.7.0 `block_bindings_source_value` filter was added.
 	 *
-	 * @param array    $source_args     Array containing source arguments used to look up the override value, i.e. {"key": "foo"}.
-	 * @param WP_Block $block_instance  The block instance.
-	 * @param string   $attribute_name  The name of the target attribute.
-	 *
+	 * @param array    $source_args    Array containing source arguments used to look up the override value, i.e. {"key": "foo"}.
+	 * @param WP_Block $block_instance The block instance.
+	 * @param string   $attribute_name The name of the target attribute.
 	 * @return mixed The value of the source.
 	 */
 	public function get_value( array $source_args, $block_instance, string $attribute_name ) {
-		return call_user_func_array( $this->get_value_callback, array( $source_args, $block_instance, $attribute_name ) );
+		$value = call_user_func_array( $this->get_value_callback, array( $source_args, $block_instance, $attribute_name ) );
+		/**
+		 * Filters the output of a block bindings source.
+		 *
+		 * @since 6.7.0
+		 *
+		 * @param mixed    $value          The computed value for the source.
+		 * @param string   $name           The name of the source.
+		 * @param array    $source_args    Array containing source arguments used to look up the override value, i.e. { "key": "foo" }.
+		 * @param WP_Block $block_instance The block instance.
+		 * @param string   $attribute_name The name of an attribute.
+		 */
+		return apply_filters( 'block_bindings_source_value', $value, $this->name, $source_args, $block_instance, $attribute_name );
 	}
 
 	/**
diff --git a/wp-includes/version.php b/wp-includes/version.php
index e5692af8a0..50dbedda25 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.7-alpha-58971';
+$wp_version = '6.7-alpha-58972';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.