# load_script_textdomain()

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

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

## Сигнатура

```php
load_script_textdomain( string $handle, string $domain = 'default', string $path = '' ): string|false
```

## Описание

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

## Параметры

- `$handle` `string` — обязательный. Имя скрипта, для которого регистрируется домен перевода.
- `$domain` `string` — необязательный, по умолчанию `'default'`. Текстовый домен. Значение по умолчанию — 'default'.
- `$path` `string` — необязательный, по умолчанию `''`. Полный путь к каталогу, содержащему файлы переводов.

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

`string|false`

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

Файл: `wp-includes/l10n.php:1143`

```php
function load_script_textdomain( $handle, $domain = 'default', $path = '' ) {
	$wp_scripts = wp_scripts();

	if ( ! isset( $wp_scripts->registered[ $handle ] ) ) {
		return false;
	}

	$src = $wp_scripts->registered[ $handle ]->src;

	if ( ! preg_match( '|^(https?:)?//|', $src ) && ! ( $wp_scripts->content_url && str_starts_with( $src, $wp_scripts->content_url ) ) ) {
		$src = $wp_scripts->base_url . $src;
	}

	return _load_script_textdomain_from_src( $handle, $src, $domain, $path, false );
}
```

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

- 5.1.0 — The $domain parameter was made optional.
- 5.0.2 — Uses load_script_translations() to load translation data.
- 5.0.0 — Introduced.

## Связанные

Использует: [`_load_script_textdomain_from_src`](https://chugunov.pro/api-wordpress/functions/_load_script_textdomain_from_src/), [`wp_scripts`](https://chugunov.pro/api-wordpress/functions/wp_scripts/).
Используется в: `WP_Scripts::print_translations`.

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