FacetWP – Multilingual support

FacetWP Multilingual Support: Integracja z WPML i Polylang

FacetWP to potężne narzędzie do tworzenia dynamicznych filtrów dla WordPressa, które może świetnie współpracować z wtyczkami do tworzenia wielojęzycznych stron. W szczególności, integracja z WPML (WordPress Multilingual) oraz Polylang umożliwia użytkownikom łatwe dostosowanie swoich treści w różnych językach. W tym artykule omówimy, jak prawidłowo skonfigurować FacetWP w połączeniu z tymi wtyczkami oraz jakie praktyki należy stosować, aby zoptymalizować wielojęzyczną funkcjonalność na stronie.

Konfiguracja FacetWP z WPML

Aby rozpocząć użytkowanie FacetWP w środowisku wielojęzycznym, pierwszym krokiem jest zainstalowanie odpowiedniego dodatku Multilingual. Umożliwia on integrację tłumaczeń z FacetWP, a wsparcie dla WPML obejmuje standardowe tłumaczenia oraz dynamiczne napisy, jak teksty wskazującego przycisku.

Ustawienia WPML dla FacetWP

Aby WPML działał prawidłowo z FacetWP, kluczowym krokiem jest poprawne skonfigurowanie ustawień tłumaczeń typów postów i taksonomii. Użytkownicy powinni:

• Przejść do sekcji wpml > Ustawienia > Ustawienia treści wielojęzycznej.
• Zaznaczyć opcję „pokaż tylko przetłumaczone elementy” dla każdego używanego typu postu i taksonomii.

Ważne jest, aby dokładnie wypełnić tłumaczenia w WPML, zwłaszcza przed rozpoczęciem korzystania z FacetWP, aby uniknąć pojawiania się wyników z oryginalnym językiem postów w przetłumaczonych wynikach.

Rodzaje postów i taksonomii

FacetWP kategorije i taksonomie muszą być dokładnie przypisane do odpowiednich tłumaczeń. W przypadku użycia zaawansowanych pól niestandardowych (ACF), również one muszą mieć aktywne tłumaczenia w każdym języku. Niezbędne jest zatem dodanie wsparcia wielojęzycznego również dla tych pól, aby umożliwić pełną funkcjonalność wyszukiwania i filtrowania.

Problemy i ich rozwiązywanie

Podczas pracy z WPML mogą pojawić się różne problemy, takie jak brakujące posty, terminy czy dane w FacetWP. Użytkownicy powinni:

• Upewnić się, że ich instalacja WordPressa dysponuje odpowiednią pamięcią (minimum 128 MB, jednak 256 MB rekomendowane).
• Wykonać czyszczenie pamięci podręcznej i bazy danych WPML za pomocą dostępnych opcji w sekcji wsparcia.

Konfiguracja FacetWP z Polylang

FacetWP wspiera także tłumaczenia Polylang. Po aktywacji tej wtyczki ważne jest przejście przez kreatora konfiguracji, aby przypisać właściwe języki do treści. Prawidłowe przypisanie języków jest kluczowe dla prawidłowego działania filtrów FacetWP.

Unikanie problemów z Polylang Pro

Jednym z istotnych problemów, które należy unikać, jest korzystanie z funkcji dzielonych slugów w Polylang Pro. Ta funkcjonalność może prowadzić do problemów z wyświetlaniem opcji w facetach na stronach z językiem nie-domyślnym. Zalecane jest używanie unikalnych slugów dla tłumaczeń, co pozwala na sprawną integrację z Filtrami FacetWP.

Integracja z SearchWP

Dla osób korzystających z SearchWP na wielojęzycznych stronaach z WPML lub Polylang, niezbędne jest zainstalowanie odpowiednich rozszerzeń integracyjnych. Pomagają one ograniczyć wyniki wyszukiwania do aktywnego języka strony. Bez tych rozszerzeń mogą pojawić się rozbieżności między filtrami, ich licznikami a listami postów.

Tłumaczenie interfejsu użytkownika i etykiet filtrów

W przypadku FacetWP, należy również pamiętać o tłumaczeniu etykiet filtrów oraz ciągów tekstowych w interfejsie użytkownika. Można to zrealizować przy użyciu hooka facetwp_i18n, który pozwala na tłumaczenie dynamicznych napisów, a także etykiet filtrów. Ważne jest rozróżnienie między etykietami a nazwami filtrów, ponieważ etykiety pojawiają się jako nagłówki w interfejsie FacetWP.

Rozwiązywanie problemów z indeksowaniem

Podczas korzystania z Polylang lub WPML, mogą wystąpić problemy z błędnym indeksowaniem treści. W takich przypadkach, gdy widzimy błąd “Tablica indeksów jest pusta”, wystarczy zainstalować dodatek Multilingual i przeprowadzić reindeksację. Kluczowe jest także upewnienie się, że wszystkie posty mają przypisany język, aby FacetWP mogło właściwie filtrować.

W pewnych sytuacjach występują problemy z filtracją postów, które nie mają ustawionego języka. Zdarza się, że na stronach kryją się posty, które nie są przetłumaczone bądź nie są używane w środowisku WPML lub Polylang. W takich wypadkach warto dodać odpowiedni kod PHP do funkcji motywu, aby wyłączyć parametr języka z odświeżania AJAX FacetWP.

Pomoc w rozwiązywaniu błędów językowych

Jeżeli napotkasz problem z niewłaściwą identyfikacją języka postów w FacetWP, można to naprawić, dodając odpowiednie fragmenty kodu do pliku functions.php motywu. Działanie tego kodu polega na wymuszeniu zmiany języka na ten, który jest aktywny w FacetWP, dzięki czemu unikniesz przypadkowego przestawiania języków w wynikach.

Wnioski

Zastosowanie FacetWP w wielojęzycznych projektach WordPress wymaga odpowiedniej konfiguracji z wtyczkami WPML i Polylang. Kluczowe aspekty to poprawne ustawienie typów postów, taksonomii oraz zapewnienie tłumaczenia dynamicznych elementów interfejsu. Znajomość możliwych problemów i ich rozwiązań oraz stosowanie najlepszych praktyk pomoże w pełni wykorzystać możliwości FacetWP jako narzędzia do filtrowania treści na wielojęzycznych stronach internetowych.