HUSKY - WooCommerce Product Filter Professional

Tłumaczenie etykiet filtra produktów WooCommerce: Polylang, WPML, Loco

W wielojęzycznym sklepie filtr produktów często bywa przetłumaczony tylko w połowie: nazwy kolorów zmieniają język, ale tytuły bloków, przycisk Filtr (Filter) czy Wyczyść wszystko (Clear All) zostają w oryginale. Filtr wyświetla teksty z kilku źródeł i każde z nich tłumaczy się w innym miejscu. Ten poradnik pokazuje, jak przetłumaczyć etykiety filtra produktów WooCommerce za pomocą Polylang, WPML lub Loco Translate, źródło po źródle, z dokładną składnią, jakiej oczekuje wtyczka.

Skąd pochodzi każdy tekst filtra

Tekst w filtrzeSkąd pochodziGdzie go przetłumaczyć
Nazwy terminów: kategorie, kolory, rozmiaryTerminy WordPressW Twojej wtyczce wielojęzycznej, tak jak każdy termin kategorii lub atrybutu
Tytuły bloków bez własnej etykietyNazwa taksonomii, w przypadku atrybutów "Product Color" i tym podobneW Twojej wtyczce wielojęzycznej lub, lepiej, we własnej etykiecie (poniżej)
Teksty wpisane w ustawieniach filtra: własne etykiety, teksty przycisków, teksty zastępcze pól, teksty przełączników i Pokaż więcej (Show more), podpowiedzi, tytuły i opcje filtrów meta, tytuły sekcjiUstawienia HUSKYTłumaczenia etykiet taksonomii WPML (WPML taxonomies labels translations) w Zaawansowane (Advanced) → Kod (Code)
Wbudowane teksty interfejsu: Filtr (Filter), Resetuj (Reset), Wyczyść wszystko (Clear All), zakres cen (price range), Na stanie (In stock), Pokaż formularz filtra produktów (Show products filter form)Domena tekstowa woocommerce-products-filterWPML String Translation, Loco Translate lub pliki .po/.mo
Tytuł widżetu filtraWidżet WordPressTłumaczenie widżetów w Twojej wtyczce wielojęzycznej

Większość nieudanych prób polega na tym, że tekst tłumaczy się w złym miejscu, na przykład tytuł atrybutu w Loco Translate albo własną etykietę w WPML String Translation, gdzie wtyczka nigdy jej nie rejestruje.

Tłumaczenie etykiet filtra produktów WooCommerce w Polylang lub WPML

Tytuły filtrów i każdy tekst wpisany w ustawieniach wtyczki tłumaczy się za pomocą jednej tabeli wyszukiwania we wtyczce. Działa to tak samo dla WPML i Polylang; pole pojawia się tylko wtedy, gdy jedna z nich jest aktywna.

  1. Nadaj blokowi stały oryginał. Na karcie Struktura (Structure) kliknij koło zębate (dodatkowe opcje (additional options)) obok taksonomii i wypełnij Własna etykieta taksonomii (Taxonomy custom label), na przykład Color. Bez własnej etykiety oryginałem jest nazwa taksonomii, którą WordPress zwraca w bieżącym języku. W przypadku atrybutów WooCommerce buduje ją jako "Product Color", a wtyczka tłumacząca mogła ją już zmienić, więc wiersz napisany dla jednej postaci nie pasuje do drugiego języka.
  2. Otwórz Zaawansowane (Advanced) → Kod (Code) → Tłumaczenia etykiet taksonomii WPML (WPML taxonomies labels translations) i dodaj jeden wiersz na każdą etykietę i język: język, dwukropek, tekst oryginalny, daszek, tłumaczenie.
  3. Użyj właściwego kodu języka. W WPML jest to kod języka WPML (fr, de, pt-br). W Polylang jest to ustawienia regionalne języka (fr_FR, en_GB, uk), widoczne w kolumnie Ustawienia regionalne (Locale) na liście języków Polylang. Użycie en w witrynie Polylang działającej na en_GB to najczęstsza przyczyna braku jakichkolwiek zmian.
  4. Zapisz, potem wyczyść pamięć podręczną stron i sprawdź stronę w drugim języku.

Dla sklepu po angielsku z francuskim i niemieckim, w WPML:

fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe

To samo w Polylang:

fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe

Język domyślny nie wymaga żadnych wierszy: bez dopasowania wyświetlany jest oryginał.

Jak działa dopasowanie

  • Oryginał musi być tekstem, który blok pokazałby bez tłumaczenia: własną etykietą albo, jeśli jej nie ma, nazwą taksonomii. Spacje na końcach i wielkość liter nie mają znaczenia, a etykiety w dowolnym alfabecie działają.
  • Każdy wiersz wymaga prefiksu języka. Wiersz taki jak Containertyp^Container type jest ignorowany.
  • Oryginał może zawierać dwukropek, ale nie daszek: pierwszy znak ^ go kończy.
  • To tabela, a nie ustawienie przypisane do pola. Jeden wiersz tłumaczy dany tekst wszędzie tam, gdzie przechodzi on przez filtr: w tytule bloku, w tytule w panelu wybranych filtrów, w przycisku lub w tekście zastępczym.

Ta sama tabela tłumaczy teksty wpisane w ustawieniach: Tekst przycisku filtra (Filter button text) i Tekst przycisku resetowania (Reset button text), tytuł filtra cen, teksty zastępcze wyszukiwania tekstowego, SKU i autora, teksty przełączników, teksty Pokaż więcej (Show more) i Pokaż mniej (Show less), podpowiedzi, tytuły i opcje filtrów meta i ACF oraz tytuły sekcji. Zapisz wiersz dokładnie z tekstem, który wpisałeś, na przykład fr:Sort by price^Trier par prix.

Jeden skutek uboczny ma znaczenie dla własnego CSS: każdy blok dostaje też klasę zbudowaną z wyświetlanego tytułu, więc woof_container_couleur na stronie francuskiej i woof_container_color na angielskiej. Stylizuj bloki za pomocą klasy zbudowanej ze sluga taksonomii, takiej jak .woof_container_pa_color, która jest taka sama w każdym języku.

Teksty interfejsu: Loco Translate, WPML String Translation i pliki .po

Wbudowane teksty wtyczki to zwykłe ciągi WordPress w domenie tekstowej woocommerce-products-filter. Wpływają na nie dwa ustawienia: Tekst przycisku filtra (Filter button text) i Tekst przycisku resetowania (Reset button text). Gdy te pola są puste, przyciski używają tłumaczalnych wartości domyślnych Filtr (Filter) i Resetuj (Reset); gdy wpiszesz własny tekst, staje się on tekstem z ustawień i trafia do opisanej wyżej tabeli wyszukiwania.

WPML. Przeskanuj wtyczkę w WPML → Lokalizacja motywu i wtyczek (Theme and plugins localization), a następnie przetłumacz ciągi z domeny woocommerce-products-filter w Tłumaczenie ciągów (String Translation).

Loco Translate, zwykły wybór także w przypadku Polylang, którego lista ciągów nie obejmuje ciągów wtyczek:

  1. Przejdź do Loco Translate → Wtyczki (Plugins), otwórz HUSKY i dodaj nowy język.
  2. Wybierz lokalizację Niestandardowa (Custom) lub Systemowa (System), a nie własny folder languages wtyczki. Aktualizacje wtyczki zastępują ten folder, a w wersji 3.4.6 wtyczka nie wczytuje z niego plików tłumaczeń.
  3. Przed synchronizacją otwórz Loco Translate → Ustawienia (Settings) i zwiększ Pomiń pliki PHP większe niż (Skip PHP files larger than) do co najmniej 200 KB. Główny plik wtyczki ma około 145 KB i zawiera ciągi takie jak Wyczyść wszystko (Clear All), zakres cen (price range), nazwy sortowania w panelu wybranych filtrów i Pokaż formularz filtra produktów (Show products filter form). Przy domyślnym limicie 100 KB Loco pomija ten plik, tych ciągów brakuje, a synchronizacja usuwa je z istniejącego tłumaczenia.
  4. Zsynchronizuj, przetłumacz, zapisz. Loco kompiluje plik .mo obok pliku .po.

Gotowe pliki tłumaczeń dla wielu języków są na stronie tłumaczeń. Niezależnie od narzędzia nazwa pliku musi kończyć się dokładnym kodem regionalnym Twojej witryny, na przykład woocommerce-products-filter-de_DE.mo, a plik należy do wp-content/languages/plugins/ lub do niestandardowego folderu Loco. FAQ praca z WPML zawiera krótką wersję składni tabeli.

Pojedyncze ciągi przez hooki, osobno dla każdego języka

Niektóre teksty łatwiej ustawić w kodzie, zwłaszcza gdy ten sam tekst ma się różnić w zależności od języka. W wersji 3.4.6 dostępne są te hooki:

  • woof_filter_title: otrzymuje każdy tekst przechodzący przez tabelę wyszukiwania, już po niej, więc może zmienić dowolny tytuł bloku, przycisk lub tekst zastępczy.
  • woof_clear_all_text: link Wyczyść wszystko (Clear All) w panelu wybranych filtrów.
  • woof_start_filtering_btn_txt: przycisk Pokaż formularz filtra produktów (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: etykiety pól wyboru Na stanie, Promocja, Wyróżnione i zamówienia oczekujące.
/*
 * 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;
});

Zwróć uwagę, że językiem jest tu slug Polylang (fr), a nie ustawienia regionalne używane w tabeli wyszukiwania.

Terminy, kolejność terminów i próbki w innych językach

Filtr wypisuje terminy bieżącego języka, które zwraca WordPress. Jeśli wartość pojawia się w języku oryginału, sam termin nie jest jeszcze przetłumaczony: przetłumacz go w WPML (atrybuty przez WooCommerce Multilingual) lub w Polylang. Jeśli jest przetłumaczony, a mimo to widać starą nazwę, wyczyść pamięć podręczną stron oraz Określenia cache (Cache terms) wtyczki przyciskiem wyczyść pamięć podręczną okresleń (clear terms cache) w Zaawansowane (Advanced) → Opcje (Options).

Przetłumaczone terminy to osobne terminy z własną kolejnością. Aby zachować kolejność języka domyślnego, otwórz listę terminów (Produkty (Products) → Kategorie (Categories) lub Produkty (Products) → Atrybuty (Attributes) → Konfiguruj terminy (Configure terms)), przełącz język administracji i ułóż terminy ponownie. Kolory i obrazy typów Kolor i Obraz trzeba ustawić tylko w terminach języka domyślnego: przetłumaczony termin bez własnego koloru lub obrazu używa tego z oryginału.

Lista kontrolna

  • Każdy blok, który potrzebuje przetłumaczonego tytułu, ma Własna etykieta taksonomii (Taxonomy custom label), a wiersze w Tłumaczenia etykiet taksonomii WPML (WPML taxonomies labels translations) powtarzają tę etykietę dokładnie.
  • Prefiksem języka jest kod języka WPML w WPML i pełne ustawienia regionalne w Polylang.
  • Teksty wpisane w polach ustawień są w tabeli wyszukiwania; wbudowane ciągi tłumaczy się w domenie woocommerce-products-filter.
  • Pliki Loco są w lokalizacji Niestandardowa lub Systemowa, a limit rozmiaru PHP został zwiększony przed synchronizacją.
  • Własny CSS wskazuje bloki po slugu taksonomii, a nie po tytule.
  • Pamięć podręczna stron i pamięć podręczna terminów zostały wyczyszczone przed testowaniem drugiego języka.

Jeśli etykieta nadal nie chce się zmienić, załóż wątek na forum wsparcia HUSKY, podając link do strony w drugim języku, używaną wtyczkę tłumaczącą i dodane wiersze.