Перевод подписей фильтра товаров WooCommerce: Polylang, WPML, Loco
На многоязычном сайте фильтр товаров часто оказывается переведен наполовину: названия цветов переключаются на другой язык, а заголовки блоков, кнопка Фильтр (Filter) или Очистить все (Clear All) остаются на языке оригинала. Фильтр выводит тексты из нескольких источников, и каждый из них переводится в своем месте. Это руководство показывает, как перевести подписи фильтра товаров WooCommerce с помощью Polylang, WPML или Loco Translate, источник за источником, с точным синтаксисом, который ожидает плагин.
Откуда берется каждый текст фильтра
| Текст в фильтре | Откуда он берется | Где его переводить |
|---|---|---|
| Названия терминов: категории, цвета, размеры | Термины WordPress | Ваш плагин мультиязычности, как и для любой категории или термина атрибута |
| Заголовки блоков без пользовательской подписи | Название таксономии, для атрибутов — «Product Color» и так далее | Ваш плагин мультиязычности или, лучше, пользовательская подпись (см. ниже) |
| Тексты, которые вы ввели в настройках фильтра: пользовательские подписи, тексты кнопок, плейсхолдеры, тексты переключателя и Показать больше (Show more), подсказки, заголовки и варианты фильтров по мета-полям, заголовки секций | Настройки HUSKY | Переводы подписей таксономий для WPML (WPML taxonomies labels translations) на вкладке Продвинутые (Advanced) → Код (Code) |
| Встроенные строки интерфейса: Фильтр (Filter), Сбросить (Reset), Очистить все (Clear All), диапазон цен (price range), В наличии (In stock), Показать форму фильтра товаров (Show products filter form) | Текстовый домен woocommerce-products-filter | WPML String Translation, Loco Translate или файлы .po/.mo |
| Заголовок виджета фильтра | Виджет WordPress | Перевод виджетов в вашем плагине мультиязычности |
Большинство неудачных попыток связано с тем, что текст переводят не там, где нужно: например, заголовок атрибута в Loco Translate или пользовательскую подпись в WPML String Translation, где плагин ее никогда не регистрирует.
Перевод подписей фильтра товаров WooCommerce через Polylang или WPML
Заголовки фильтров и все тексты, введенные в настройках плагина, переводятся с помощью одной таблицы соответствий внутри плагина. Она работает одинаково для WPML и Polylang; поле появляется, только когда активен один из них.
- Задайте блоку фиксированный оригинал. На вкладке Структура (Structure) нажмите на значок шестеренки (дополнительные опции (additional options)) рядом с таксономией и заполните поле Пользовательская подпись таксономии (Taxonomy custom label), например
Color. Без пользовательской подписи оригиналом служит название таксономии, которое WordPress возвращает на текущем языке. Для атрибутов WooCommerce формирует его как «Product Color», а плагин перевода мог его уже изменить, поэтому строка, написанная для одной формы, не совпадет на другом языке. - Откройте Продвинутые (Advanced) → Код (Code) → Переводы подписей таксономий для WPML (WPML taxonomies labels translations) и добавьте по одной строке на каждую подпись и язык: язык, двоеточие, исходный текст, символ ^, перевод.
- Используйте правильный код языка. В WPML это код языка WPML (
fr,de,pt-br). В Polylang это локаль языка (fr_FR,en_GB,uk), как она указана в столбце Локаль (Locale) списка языков Polylang. Кодenна сайте Polylang с языкомen_GB— самая частая причина того, что ничего не меняется. - Сохраните настройки, затем очистите кэш страниц и проверьте страницу на другом языке.
Для магазина на английском с французским и немецким языками, на WPML:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
То же самое на Polylang:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
Для языка по умолчанию строки не нужны: если совпадения нет, показывается оригинал.
Как работает поиск соответствия
- Оригинал должен совпадать с текстом, который блок показал бы без перевода: это пользовательская подпись или, если ее нет, название таксономии. Пробелы по краям и регистр букв не имеют значения, а подписи на любом алфавите работают.
- Каждая строка должна начинаться с префикса языка. Строка вида
Containertyp^Container typeигнорируется. - Оригинал может содержать двоеточие, но не символ ^: первый же
^завершает его. - Это таблица, а не настройка отдельного поля. Одна строка переводит этот текст везде, где он проходит через фильтр: в заголовке блока, в заголовке панели выбранных фильтров, в кнопке или плейсхолдере.
Та же таблица переводит и тексты, которые вы ввели в настройках: Текст кнопки «Фильтр» (Filter button text) и Текст кнопки сброса (Reset button text), заголовок фильтра по цене, плейсхолдеры текстового поиска, поиска по SKU и по автору, тексты переключателя, тексты Показать больше (Show more) и Показать меньше (Show less), подсказки, заголовки и варианты фильтров по мета-полям и ACF, а также заголовки секций. Напишите строку с тем самым текстом, который вы ввели, например fr:Sort by price^Trier par prix.
Один побочный эффект важен для собственного CSS: каждый блок также получает класс, построенный из отображаемого заголовка, например woof_container_couleur на французской странице и woof_container_color на английской. Стилизуйте блоки по классу, построенному из слага таксономии, такому как .woof_container_pa_color: он одинаков на всех языках.
Строки интерфейса: Loco Translate, WPML String Translation и файлы .po
Встроенные тексты плагина — обычные строки WordPress в текстовом домене woocommerce-products-filter. На них влияют две настройки: Текст кнопки «Фильтр» (Filter button text) и Текст кнопки сброса (Reset button text). Пока эти поля пусты, кнопки используют переводимые значения по умолчанию Фильтр (Filter) и Сбросить (Reset); как только вы вводите собственный текст, он становится текстом настроек и попадает в таблицу соответствий, описанную выше.
WPML. Просканируйте плагин в разделе WPML → Локализация тем и плагинов (Theme and plugins localization), затем переведите строки домена woocommerce-products-filter в Перевод строк (String Translation).
Loco Translate — обычный выбор и для Polylang, в списке строк которого нет строк плагинов:
- Перейдите в Loco Translate → Плагины (Plugins), откройте HUSKY и добавьте новый язык.
- Выберите расположение Свое (Custom) или Системное (System), а не папку
languagesсамого плагина. Обновления плагина заменяют эту папку, а в версии 3.4.6 плагин не загружает из нее файлы перевода. - Перед синхронизацией откройте Loco Translate → Настройки (Settings) и увеличьте значение Пропускать PHP-файлы размером более (Skip PHP files larger than) минимум до 200 КБ. Главный файл плагина занимает около 145 КБ и содержит такие строки, как Очистить все (Clear All), диапазон цен (price range), названия сортировок в панели выбранных фильтров и Показать форму фильтра товаров (Show products filter form). При лимите по умолчанию в 100 КБ Loco пропускает этот файл, эти строки отсутствуют, а синхронизация удаляет их из уже существующего перевода.
- Синхронизируйте, переведите, сохраните. Loco компилирует файл .mo рядом с файлом .po.
Готовые файлы перевода для многих языков находятся на странице переводов. Каким бы инструментом вы ни пользовались, имя файла должно заканчиваться точной локалью вашего сайта, например woocommerce-products-filter-de_DE.mo, а сам файл должен лежать в wp-content/languages/plugins/ или в пользовательской папке Loco. В FAQ работа с WPML есть краткое описание синтаксиса таблицы.
Отдельные строки через хук для каждого языка
Некоторые тексты проще задать в коде, особенно когда один и тот же текст должен отличаться в зависимости от языка. В версии 3.4.6 доступны такие хуки:
- woof_filter_title: получает каждый текст, проходящий через таблицу соответствий, уже после таблицы, поэтому может изменить любой заголовок блока, кнопку или плейсхолдер.
- woof_clear_all_text: ссылка Очистить все (Clear All) панели выбранных фильтров.
- woof_start_filtering_btn_txt: кнопка Показать форму фильтра товаров (Show products filter form).
woof_ext_custom_title_by_instock,woof_ext_custom_title_by_onsales,woof_ext_custom_title_by_featured,woof_ext_custom_title_by_backorder: подписи чекбоксов «В наличии», «Распродажа», «Рекомендуемые» и «Предзаказ».
/*
* Product filter: per-language texts set in code.
* Child theme functions.php or a code snippets plugin.
*/
function my_filter_lang() {
if (function_exists('pll_current_language')) {
return pll_current_language(); // Polylang: language slug, e.g. "fr"
}
return apply_filters('wpml_current_language', null); // WPML: language code
}
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
$texts = array(
'en' => array('Formations' => 'Bands'),
'de' => array('Formations' => 'Besetzungen'),
);
return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);
add_filter('woof_clear_all_text', function ($text) {
return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});
Обратите внимание: язык здесь — это слаг Polylang (fr), а не локаль, которая используется в таблице соответствий.
Термины, порядок терминов и образцы в других языках
Фильтр выводит термины текущего языка, которые возвращает WordPress. Если значение отображается на исходном языке, сам термин еще не переведен: переведите его в WPML (атрибуты — через WooCommerce Multilingual) или в Polylang. Если он переведен, но по-прежнему показывается старое название, очистите кэш страниц и Кэшировать термины (Cache terms) плагина кнопкой очистить кэш терминов (clear terms cache) на вкладке Продвинутые (Advanced) → Опции (Options).
Переведенные термины — это отдельные термины со своим порядком. Чтобы сохранить порядок языка по умолчанию, откройте список терминов (Товары (Products) → Категории (Categories) или Товары (Products) → Атрибуты (Attributes) → Настроить термины (Configure terms)), переключите язык админки и расставьте термины заново. Цвета и изображения типов Color и Image нужно задавать только у терминов языка по умолчанию: переведенный термин без собственного цвета или изображения использует цвет или изображение своего оригинала.
Чек-лист
- У каждого блока, заголовок которого нужно перевести, есть Пользовательская подпись таксономии (Taxonomy custom label), а строки в Переводы подписей таксономий для WPML (WPML taxonomies labels translations) в точности повторяют эту подпись.
- Префикс языка — это код языка WPML в WPML и полная локаль в Polylang.
- Тексты, введенные в полях настроек, находятся в таблице соответствий; встроенные строки переведены в домене
woocommerce-products-filter. - Файлы Loco лежат в расположении «Свое» или «Системное», а лимит размера PHP-файлов был увеличен до синхронизации.
- Собственный CSS обращается к блокам по слагу таксономии, а не по заголовку.
- Кэш страниц и кэш терминов были очищены перед проверкой второго языка.
Если подпись по-прежнему не меняется, создайте тему на форуме поддержки HUSKY, указав ссылку на страницу на втором языке, используемый плагин перевода и добавленные вами строки.