Функция get_translations_for_domain() в WordPress с примерами

Функция get_translations_for_domain() в WordPress позволяет получать объект перевода для указанного текстового домена. Эта функция полезна для работы с переводами, так как возвращает экземпляр объекта Translations, который содержит все переводы для данного домена.

get_translations_for_domain( string $domain ): Translations|NOOP_Translations

Параметры

• $domain (string, обязательный): Текстовый домен. Уникальный идентификатор для получения переведенных строк.

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

• Translations|NOOP_Translations: Возвращает объект Translations, если переводы загружены, или объект NOOP_Translations, если переводы отсутствуют.

Описание

Функция get_translations_for_domain() работает с загруженными файлами перевода (файлы .mo). Если для указанного домена перевода есть файл .mo, функция вернет объект класса MO, содержащий переводы. Если файла перевода нет, будет возвращен объект класса NOOP_Translations.

Пример объекта MO:

MO Object
(
    [_nplurals] => 3
    [filename:MO:private] => /path/to/your/wordpress/wp-content/languages/plugins/woocommerce-ru_RU.mo
    [entries] => Array()
    [headers] => Array()
)

Пример объекта NOOP_Translations:

NOOP_Translations Object (
    [entries] => Array()
    [headers] => Array()
)

Пример 1: Получение данных о переводах для плагина WooCommerce

В этом примере мы получим данные о переводах для плагина WooCommerce, текстовый домен которого — woocommerce.

$data = get_translations_for_domain('woocommerce');

print_r($data);

Пример 2: Вывод оригинальных строк и их переводов

В этом примере мы проитерируемся по записям перевода и выведем оригинальные строки и их переводы.

$data = get_translations_for_domain('woocommerce');

if ($data instanceof MO && $data->entries) {
    foreach ($data->entries as $entry) {
        echo "Оригинальная строка: {$entry->singular} \n";
        echo "Переведенная строка: {$entry->translations[0]} \n\n";
    }
} else {
    echo "Переводы не найдены для домена woocommerce.";
}

Результат

Если переводы доступны, выведется список оригинальных строк и их переводов:

Оригинальная строка: Add to cart
Переведенная строка: Добавить в корзину

Оригинальная строка: Checkout
Переведенная строка: Оформление заказа

Заключение

Функция get_translations_for_domain() предоставляет простой способ получения переводов для конкретного текстового домена в WordPress. Она возвращает объект перевода, который можно использовать для извлечения оригинальных строк и их переводов. Эта функция может быть полезной для разработчиков плагинов и тем, которые хотят управлять переводами более эффективно и точно.