# load_theme_textdomain()

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

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

## Сигнатура

```php
load_theme_textdomain( string $domain, string|false $path = false ): bool
```

## Описание

Если текущая локаль присутствует в виде .mo-файла в корневом каталоге темы, она будет включена в переведённые строки функцией $domain.
.mo-файлы должны называться точно по имени локали.

## Параметры

- `$domain` `string` — обязательный. Текстовый домен. Уникальный идентификатор для получения переведённых строк.
- `$path` `string|false` — необязательный, по умолчанию `false`. Путь к каталогу, содержащему .mo-файл.

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

`bool`

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

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

```php
function load_theme_textdomain( $domain, $path = false ) {
	/** @var WP_Textdomain_Registry $wp_textdomain_registry */
	/** @var array<string, WP_Translations|NOOP_Translations> $l10n */
	global $wp_textdomain_registry, $l10n;

	if ( ! is_string( $domain ) ) {
		return false;
	}

	if ( ! $path ) {
		$path = get_template_directory();
	}

	$wp_textdomain_registry->set_custom_path( $domain, $path );

	// If just-in-time loading was triggered before, reset the entry so it can be tried again.
	if ( isset( $l10n[ $domain ] ) && $l10n[ $domain ] instanceof NOOP_Translations ) {
		unset( $l10n[ $domain ] );
	}

	return true;
}
```

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

- 6.7.0 — Translations are no longer immediately loaded, but handed off to the just-in-time loading mechanism.
- 4.6.0 — The function now tries to load the .mo file from the languages directory first.
- 1.5.0 — Introduced.

## Связанные

Использует: `WP_Textdomain_Registry::set_custom_path`, [`get_template_directory`](https://chugunov.pro/api-wordpress/functions/get_template_directory/).
Используется в: [`load_child_theme_textdomain`](https://chugunov.pro/api-wordpress/functions/load_child_theme_textdomain/), `WP_Theme::load_textdomain`.

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