translate() │ WP 2.2.0

Отримує переклад вказаного тексту.

Якщо переклад отримати не вдалося або не вдалося завантажити файл перекладу, буде повернено оригінальний текст.

Це функція низького рівня і не призначена для прямого використання! Використовуйте обгортки: _e() .

Працює на основі:
get_translations_for_domain() ,
MO()

Основа для:
esc_html_e() ,
esc_html__() ,
_e() ,
__()

Хуки з функції

gettext

gettext_(domain)

Повертає

Строку. Оригінальний або перекладений текст.

Використання

translate($text, $domain);

$text (рядок) (обов’язковий): Текст, який потрібно перекласти.
$domain (рядок): Область визначення перекладу (.mo файл із перекладом).

За замовчуванням: ‘default’

Приклади

#1 Демо

$domain = 'my-textdomain';
$text = 'Some text to translate';

echo translate($text, $domain);

список змін

З версії 2.2.0	Введено.
З версії 5.5.0	Introduced gettext-{$domain} filter.

translate `() translate` ^{WP 6.0.2}

wp-includes/l10n.php

function translate( $text, $domain = 'default' ) {
	$translations = get_translations_for_domain($domain);
	$translation = $translations->translate($text);

	/**
	 * Filters text with its translation.
	 *
	 * @ Since 2.0.11
	 *
	 * @param string $translation Translated text.
	 * @param string $text Text to translate.
	 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
	 */
	$translation = apply_filters( 'gettext', $translation, $text, $domain);

	/**
	 * Filters text with its translation for a domain.
	 *
	 * The dynamic portion of hook name, `$domain`, refers to the text domain.
	 *
	 * @ Since 5.5.0
	 *
	 * @param string $translation Translated text.
	 * @param string $text Text to translate.
	 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
	 */
	$translation = apply_filters( "gettext_{$domain}", $translation, $text, $domain);

	return $translation;
}