# wp_localize_script()

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

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

## Сигнатура

```php
wp_localize_script( string $handle, string $object_name, $l10n ): bool
```

## Описание

Works only if the script has already been registered.

Accepts an associative array `$l10n` and creates a JavaScript object:

```
"$object_name": {
key: value,
key: value,
...
}
```

[See also](#see-also)
- [WP_Scripts::localize()](https://developer.wordpress.org/reference/classes/WP_Scripts/localize/)

## Параметры

- `$handle` `string` — обязательный. Дескриптор скрипта, к которому будут прикреплены данные.
- `$object_name` `string` — обязательный. Имя объекта JavaScript. Передаётся напрямую, поэтому должно быть корректной JS-переменной.
  
  Пример: '/[a-zA-Z0-9_]+/'.

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

`bool`

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

Файл: `wp-includes/functions-wp-scripts.php:320`

```php
function wp_localize_script( $handle, $object_name, $l10n ) {
	$wp_scripts = wp_scripts();

	return $wp_scripts->localize( $handle, $object_name, $l10n );
}
```

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

- 2.2.0 — Introduced.

## Связанные

Использует: [`wp_scripts`](https://chugunov.pro/api-wordpress/functions/wp_scripts/), `WP_Scripts::localize`.
Используется в: `WP_Site_Health::enqueue_scripts`, [`wp_localize_community_events`](https://chugunov.pro/api-wordpress/functions/wp_localize_community_events/), [`the_custom_header_markup`](https://chugunov.pro/api-wordpress/functions/the_custom_header_markup/), `WP_Customize_Nav_Menus::enqueue_scripts`, `WP_Customize_Background_Image_Control::enqueue`, `WP_Plugins_List_Table::prepare_items`, `WP_MS_Themes_List_Table::prepare_items`, `WP_Plugin_Install_List_Table::prepare_items`, `WP_Customize_Manager::enqueue_control_scripts`, [`wp_enqueue_media`](https://chugunov.pro/api-wordpress/functions/wp_enqueue_media/), `WP_Customize_Header_Image_Control::enqueue`, [`wp_just_in_time_script_localization`](https://chugunov.pro/api-wordpress/functions/wp_just_in_time_script_localization/).

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