<h2>Редактирование файла: block-bindings.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/old/wp-includes/block-bindings.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?php
/**
 * Block Bindings API
 *
 * Contains functions for managing block bindings in WordPress.
 *
 * @package WordPress
 * @subpackage Block Bindings
 * @since 6.5.0
 */

/**
 * Registers a new block bindings source.
 *
 * Registering a source consists of defining a **name** for that source and a callback function specifying
 * how to get a value from that source and pass it to a block attribute.
 *
 * Once a source is registered, any block that supports the Block Bindings API can use a value
 * from that source by setting its `metadata.bindings` attribute to a value that refers to the source.
 *
 * Note that `register_block_bindings_source()` should be called from a handler attached to the `init` hook.
 *
 *
 * ## Example
 *
 * ### Registering a source
 *
 * First, you need to define a function that will be used to get the value from the source.
 *
 *     function my_plugin_get_custom_source_value( array $source_args, $block_instance, string $attribute_name ) {
 *       // Your custom logic to get the value from the source.
 *       // For example, you can use the `$source_args` to look up a value in a custom table or get it from an external API.
 *       $value = $source_args[&#039;key&#039;];
 *
 *       return &quot;The value passed to the block is: $value&quot;
 *     }
 *
 * The `$source_args` will contain the arguments passed to the source in the block&#039;s
 * `metadata.bindings` attribute. See the example in the &quot;Usage in a block&quot; section below.
 *
 *     function my_plugin_register_block_bindings_sources() {
 *       register_block_bindings_source( &#039;my-plugin/my-custom-source&#039;, array(
 *         &#039;label&#039;              =&gt; __( &#039;My Custom Source&#039;, &#039;my-plugin&#039; ),
 *         &#039;get_value_callback&#039; =&gt; &#039;my_plugin_get_custom_source_value&#039;,
 *       ) );
 *     }
 *     add_action( &#039;init&#039;, &#039;my_plugin_register_block_bindings_sources&#039; );
 *
 * ### Usage in a block
 *
 * In a block&#039;s `metadata.bindings` attribute, you can specify the source and
 * its arguments. Such a block will use the source to override the block
 * attribute&#039;s value. For example:
 *
 *     &lt;!-- wp:paragraph {
 *       &quot;metadata&quot;: {
 *         &quot;bindings&quot;: {
 *           &quot;content&quot;: {
 *             &quot;source&quot;: &quot;my-plugin/my-custom-source&quot;,
 *             &quot;args&quot;: {
 *               &quot;key&quot;: &quot;you can pass any custom arguments here&quot;
 *             }
 *           }
 *         }
 *       }
 *     } --&gt;
 *     &lt;p&gt;Fallback text that gets replaced.&lt;/p&gt;
 *     &lt;!-- /wp:paragraph --&gt;
 *
 * @since 6.5.0
 *
 * @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.
 *
 *     @type string   $label              The label of the source.
 *     @type callable $get_value_callback A callback executed when the source is processed during block rendering.
 *                                        The callback should have the following signature:
 *
 *                                        `function( $source_args, $block_instance, $attribute_name ): mixed`
 *                                            - @param array    $source_args    Array containing source arguments
 *                                                                              used to look up the override value,
 *                                                                              i.e. {&quot;key&quot;: &quot;foo&quot;}.
 *                                            - @param WP_Block $block_instance The block instance.
 *                                            - @param string   $attribute_name The name of an attribute.
 *                                        The callback has a mixed return type; it may return a string to override
 *                                        the block&#039;s original value, null, false to remove an attribute, etc.
 *     @type string[] $uses_context       Optional. Array of values to add to block `uses_context` needed by the source.
 * }
 * @return WP_Block_Bindings_Source|false Source when the registration was successful, or `false` on failure.
 */
function register_block_bindings_source( string $source_name, array $source_properties ) {
	return WP_Block_Bindings_Registry::get_instance()-&gt;register( $source_name, $source_properties );
}

/**
 * Unregisters a block bindings source.
 *
 * @since 6.5.0
 *
 * @param string $source_name Block bindings source name including namespace.
 * @return WP_Block_Bindings_Source|false The unregistered block bindings source on success and `false` otherwise.
 */
function unregister_block_bindings_source( string $source_name ) {
	return WP_Block_Bindings_Registry::get_instance()-&gt;unregister( $source_name );
}

/**
 * Retrieves the list of all registered block bindings sources.
 *
 * @since 6.5.0
 *
 * @return WP_Block_Bindings_Source[] The array of registered block bindings sources.
 */
function get_all_registered_block_bindings_sources() {
	return WP_Block_Bindings_Registry::get_instance()-&gt;get_all_registered();
}

/**
 * Retrieves a registered block bindings source.
 *
 * @since 6.5.0
 *
 * @param string $source_name The name of the source.
 * @return WP_Block_Bindings_Source|null The registered block bindings source, or `null` if it is not registered.
 */
function get_block_bindings_source( string $source_name ) {
	return WP_Block_Bindings_Registry::get_instance()-&gt;get_registered( $source_name );
}

/**
 * Retrieves the list of block attributes supported by block bindings.
 *
 * @since 6.9.0
 *
 * @param string $block_type The block type whose supported attributes are being retrieved.
 * @return array The list of block attributes that are supported by block bindings.
 */
function get_block_bindings_supported_attributes( $block_type ) {
	$block_bindings_supported_attributes = array(
		&#039;core/paragraph&#039;          =&gt; array( &#039;content&#039; ),
		&#039;core/heading&#039;            =&gt; array( &#039;content&#039; ),
		&#039;core/image&#039;              =&gt; array( &#039;id&#039;, &#039;url&#039;, &#039;title&#039;, &#039;alt&#039;, &#039;caption&#039; ),
		&#039;core/button&#039;             =&gt; array( &#039;url&#039;, &#039;text&#039;, &#039;linkTarget&#039;, &#039;rel&#039; ),
		&#039;core/post-date&#039;          =&gt; array( &#039;datetime&#039; ),
		&#039;core/navigation-link&#039;    =&gt; array( &#039;url&#039; ),
		&#039;core/navigation-submenu&#039; =&gt; array( &#039;url&#039; ),
	);

	$supported_block_attributes =
		isset( $block_type, $block_bindings_supported_attributes[ $block_type ] ) ?
			$block_bindings_supported_attributes[ $block_type ] :
			array();

	/**
	 * Filters the supported block attributes for block bindings.
	 *
	 * @since 6.9.0
	 *
	 * @param string[] $supported_block_attributes The block&#039;s attributes that are supported by block bindings.
	 * @param string   $block_type                 The block type whose attributes are being filtered.
	 */
	$supported_block_attributes = apply_filters(
		&#039;block_bindings_supported_attributes&#039;,
		$supported_block_attributes,
		$block_type
	);

	/**
	 * Filters the supported block attributes for block bindings.
	 *
	 * The dynamic portion of the hook name, `$block_type`, refers to the block type
	 * whose attributes are being filtered.
	 *
	 * @since 6.9.0
	 *
	 * @param string[] $supported_block_attributes The block&#039;s attributes that are supported by block bindings.
	 */
	$supported_block_attributes = apply_filters(
		&quot;block_bindings_supported_attributes_{$block_type}&quot;,
		$supported_block_attributes
	);

	return $supported_block_attributes;
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fold%2Fwp-includes">← Назад к списку файлов</a></p>