Переклад текстів фільтра товарів 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), заголовок фільтра за ціною, плейсхолдери пошуку за текстом, артикулом і автором, тексти перемикачів, тексти Показати більше (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. У поширених запитаннях робота з 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: написи прапорців «В наявності», «Зі знижкою», «Рекомендовані» та «Очікується надходження» (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 лежать у розташуванні «Власне» (Custom) або «Системне» (System), а ліміт розміру PHP-файлів було збільшено перед синхронізацією.
- Власний CSS звертається до блоків за слагом таксономії, а не за заголовком.
- Кеш сторінок і кеш термінів було очищено перед тестуванням другої мови.
Якщо напис і далі не змінюється, створіть тему на форумі підтримки HUSKY і додайте посилання на сторінку другою мовою, плагін перекладу, який ви використовуєте, та рядки, які ви додали.