# script_module_data_{$module_id}

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

Тип: хук-фильтр.
Появился в версии: 6.7.0.

## Сигнатура

```php
apply_filters( "script_module_data_{$module_id}", array $data )
```

## Описание

Модулям скриптов могут требоваться данные, необходимые для инициализации или обязательно доступные сразу при загрузке страницы. Это подходящие случаи применения таких данных.
Динамическая часть имени хука, $module_id, соответствует идентификатору модуля скрипта, с которым связаны данные.
Это лучше всего подходит для передачи важных данных, которые должны быть доступны модулю для инициализации или сразу при загрузке страницы. Это не заменяет REST API или получение данных со стороны клиента.
Пример:
add_filter(
'script_module_data_MyScriptModuleID',
function ( array $data ): array {
$data['dataForClient'] = 'ok';
return $data;
}
);Если фильтр не возвращает данных (пустой массив), в страницу ничего не встраивается.
Данные для данного модуля скрипта, если они предоставлены, будут сериализованы в JSON внутри тега script с идентификатором вида wp-script-module-data-{$module_id}.
Данные можно прочитать на стороне клиента примерно так:
Пример:
const dataContainer = document.getElementById( 'wp-script-module-data-MyScriptModuleID' );
let data = {};
if ( dataContainer ) {
try {
data = JSON.parse( dataContainer.textContent );
} catch {}
}
// data.dataForClient === 'ok';
initMyScriptModuleWithData( data );

## Динамические части имени

- `{$module_id}` — Динамическая часть имени хука, $module_id, соответствует идентификатору модуля скрипта, с которым связаны данные.

## Параметры

- `$data` `array` — обязательный. Данные, связанные с модулем скрипта.

## Фильтруемое значение

Данные, связанные с модулем скрипта.

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

Файл: `wp-includes/class-wp-script-modules.php:1079`

```php
$data = apply_filters( "script_module_data_{$module_id}", array() );
```

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

- 6.7.0 — Introduced.

## Связанные

Используется в: `WP_Script_Modules::print_script_module_data`.

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