# register_block_bindings_source()

URL: https://chugunov.pro/api-wordpress/functions/register_block_bindings_source/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 6.5.0.

## Сигнатура

```php
register_block_bindings_source( string $source_name, array $source_properties ): WP_Block_Bindings_Source|false
```

## Описание

Регистрация источника состоит из задания имени этого источника и функции обратного вызова, определяющей, как получить значение из этого источника и передать его в атрибут блока.
После регистрации источника любой блок, поддерживающий Block Bindings API, может использовать значение из него, задав своему атрибуту metadata.bindings значение, ссылающееся на этот источник.
Обратите внимание, что register_block_bindings_source() следует вызывать из обработчика, прикреплённого к хуку init.

## Параметры

- `$source_name` `string` — обязательный. Имя источника. Должно быть строкой, содержащей префикс пространства имён, например
  
  my-plugin/my-custom-source. Может содержать только строчные буквенно-цифровые символы, косую черту / и дефисы.
- `$source_properties` `array` — обязательный. Массив аргументов, используемых для регистрации источника.
  
  label stringМетка источника.
  
  get_value_callback callableФункция обратного вызова, выполняемая при обработке источника во время рендеринга блока.
  
  Функция обратного вызова должна иметь следующую сигнатуру: function( $source_args, $block_instance, $attribute_name ): mixed
  
  @param array $source_args Массив с аргументами источника, используемыми для поиска переопределяющего значения, например {"key": "foo"}.
  
  @param WP_Block $block_instance Экземпляр блока.
  
  @param string $attribute_name Имя атрибута.
  
  Функция обратного вызова имеет тип возвращаемого значения mixed; она может вернуть строку, чтобы переопределить исходное значение блока, null, false для удаления атрибута и т. д.
  
  uses_context string[]Необязательный. Массив значений, добавляемых в uses_context блока, необходимых источнику.

## Возвращаемое значение

`WP_Block_Bindings_Source|false` — false

## Исходный код

Файл: `wp-includes/block-bindings.php:94`

```php
function register_block_bindings_source( string $source_name, array $source_properties ) {
	return WP_Block_Bindings_Registry::get_instance()->register( $source_name, $source_properties );
}
```

## История изменений

- 6.5.0 — Introduced.

## Связанные

Использует: `WP_Block_Bindings_Registry::get_instance`.
Используется в: [`_register_block_bindings_post_data_source`](https://chugunov.pro/api-wordpress/functions/_register_block_bindings_post_data_source/), [`_register_block_bindings_term_data_source`](https://chugunov.pro/api-wordpress/functions/_register_block_bindings_term_data_source/), [`_register_block_bindings_pattern_overrides_source`](https://chugunov.pro/api-wordpress/functions/_register_block_bindings_pattern_overrides_source/), [`_register_block_bindings_post_meta_source`](https://chugunov.pro/api-wordpress/functions/_register_block_bindings_post_meta_source/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/register_block_bindings_source/