Wtyczka WPML CMS Navigation - 1.5.8

WPML CMS Navigation to dodatek do wtyczki tłumaczeniowej WPML, który dokłada stronom WordPress trzy gotowe, wielojęzyczne elementy nawigacyjne: okruszki (breadcrumbs), rozwijane menu oraz nawigację w pasku bocznym. Wszystkie znają strukturę językową WPML i pokazują ścieżkę w języku odwiedzającego, bez budowania osobnych menu dla każdego języka. Dodatek powstał dla właścicieli wielojęzycznych witryn na WPML i deweloperów pracujących na klasycznych motywach PHP.

Funkcje i możliwości WPML CMS Navigation

WPML CMS Navigation dostarcza trzy elementy nawigacyjne – wielojęzyczne okruszki (breadcrumbs), rozwijane menu wielopoziomowe oraz nawigację w pasku bocznym pokazującą strony powiązane. Cała trójka korzysta z mapy tłumaczeń WPML, więc ścieżki i powiązania wyświetlają się w języku przeglądanej wersji strony. Bez utrzymywania osobnych menu dla każdego języka.

W praktyce to jeden zestaw elementów na całą witrynę. Odwiedzający przełącza język i widzi tę samą strukturę nawigacji – tyle że etykiety i powiązania trafiają na właściwą wersję językową.

• Okruszki wielojęzyczne – generują ścieżkę pokazującą położenie odwiedzającego w hierarchii witryny, z etykietami w aktualnym języku i konfigurowalnym separatorem.
• Rozwijane menu wielopoziomowe – daje szybki dostęp do sekcji witryny, zwykle osadzane w nagłówku motywu.
• Nawigacja w pasku bocznym – listuje strony powiązane z aktualnie oglądaną, na przykład strony-dzieci i strony tej samej sekcji.
• Sterowanie per-strona z edytora – pozwala wykluczyć stronę z nawigacji bocznej, pokazać lub ukryć jej strony-dzieci oraz przypisać sekcję.
• Ustawienia globalne – panel WPML → Navigation, gdzie ustawia się m.in. symbol rozdzielający ślad okruszków.
• Świadomość mapy tłumaczeń WPML – jeden zestaw elementów dla wszystkich języków, bez utrzymywania osobnych menu na język.
• Personalizacja przez CSS – plik cms-navigation.css kopiuje się do motywu i dostosowuje wygląd elementów.

Okruszki i rozwijane menu świadome języka

Okruszki budują ślad od strony głównej do bieżącej podstrony, a etykiety na tym śladzie pochodzą z aktualnej wersji językowej WPML. Symbol rozdzielający poziomy (separator) ustawia się centralnie w panelu WPML → Navigation – jedna zmiana obejmuje całą witrynę naraz.

Rozwijane menu działa wielopoziomowo i odzwierciedla strukturę treści w danym języku. Zamiast osobnego dropdownu dla każdej wersji, menu renderuje się raz. WPML dba o to, by pozycje pokazywały się w języku odwiedzającego.

Nawigacja w pasku bocznym i strony powiązane

Nawigacja w pasku bocznym pokazuje strony powiązane z aktualnie oglądaną – strony-dzieci oraz strony należące do tej samej sekcji witryny. To pomaga orientować się w rozbudowanej hierarchii, gdzie sama lista pozycji menu nie wystarcza, by zrozumieć, gdzie znajduje się odwiedzający.

Sidebar dobiera powiązania na podstawie struktury stron i mapy tłumaczeń, więc po przełączeniu języka listuje odpowiedniki w nowej wersji. Element osadza się w pliku motywu albo dodaje jako gotowy widget.

Sterowanie nawigacją per-strona z poziomu edytora

W edytorze strony pojawia się sekcja „CMS Navigation”, która daje kontrolę nad zachowaniem nawigacji dla konkretnej strony. Z tego panelu redaktor wyklucza bieżącą stronę z nawigacji bocznej, decyduje o pokazaniu lub ukryciu jej stron-dzieci oraz przypisuje sekcję, pod którą strona ma się wyświetlać.

Dzięki temu redaktorzy zarządzają zawartością sidebaru bez ingerencji w kod. Deweloper raz osadza element, a dalsze decyzje o widoczności stron zapadają już w panelu edytora.

Osadzanie elementów WPML CMS Navigation w motywie

Elementy WPML CMS Navigation osadza się w motywie jednolinijkowymi funkcjami PHP – okruszki przez icl_navigation_breadcrumb, rozwijane menu przez icl_navigation_menu, a pasek boczny przez icl_navigation_sidebar. Nawigację boczną da się też dodać jako gotowy widget WordPress, bez dotykania kodu. Wygląd elementów dostosowuje się, kopiując plik cms-navigation.css do motywu.

Hooki PHP w plikach motywu

Trzy action hooki o prefiksie icl_navigation_ to punkt osadzania w klasycznym motywie PHP. Okruszki wstawia icl_navigation_breadcrumb w pliku header.php lub w szablonach takich jak single.php, page.php czy archive.php. Rozwijane menu uruchamia icl_navigation_menu, zwykle w header.php.

Każdy hook to pojedyncze wywołanie funkcji w odpowiednim miejscu szablonu. Taki model integracji jest przewidywalny dla deweloperów – mają dostęp do plików motywu i sami decydują, gdzie dokładnie element ma się renderować.

Widget paska bocznego bez kodu

Nawigacja w pasku bocznym ma wariant gotowego widgetu WordPress, dostępnego w sekcji Wygląd → Widgety. To jedyny z trzech elementów, który wchodzi bez edycji kodu – wystarczy przeciągnąć widget do strefy bocznej motywu.

Okruszki i rozwijane menu nie mają odpowiednika widgetu. Ich osadzenie wymaga wstawienia funkcji PHP do szablonu.

Personalizacja wyglądu przez CSS

Dodatek dostarcza dwa pliki CSS w katalogu wtyczki. Plik cms-navigation-base.css odpowiada za działanie rozwijanego menu i nie podlega modyfikacji, ponieważ steruje mechaniką dropdownu. Plik cms-navigation.css kopiuje się do motywu i dostosowuje pod własny wygląd.

Rozdzielenie warstwy funkcjonalnej od stylistycznej pozwala zmieniać wygląd elementów bez ryzyka zepsucia ich działania. Dopasowanie do motywu to praca frontendowa na pliku cms-navigation.css.

Typowe wdrożenia WPML CMS Navigation

WPML CMS Navigation sprawdza się na wielojęzycznych witrynach o głębokiej, hierarchicznej strukturze – serwisach korporacyjnych, bazach wiedzy i dokumentacji z wieloma zagnieżdżonymi sekcjami. Okruszki pokazują położenie odwiedzającego w aktualnym języku, sidebar listuje strony powiązane, a panel w edytorze pozwala redaktorom sterować nawigacją boczną bez ingerencji w kod.

Serwisy o głębokiej strukturze i bazy wiedzy

W dwujęzycznym serwisie korporacyjnym z układem „Produkty → Kategoria → Podstrona” odwiedzający łatwo gubi orientację, a osobne menu dla każdego języka to podwójna praca. Okruszki osadzone w nagłówku pokazują ścieżkę zawsze w aktualnym języku, a pasek boczny listuje strony-dzieci bieżącej sekcji – nawigacja zostaje spójna po przełączeniu języka.

W wielojęzycznej bazie wiedzy lub dokumentacji z dziesiątkami zagnieżdżonych artykułów widget paska bocznego sam pokazuje powiązane strony danej sekcji w języku odwiedzającego. Rozwijane menu sprawdza się tam, gdzie witryna ma wiele działów wymagających wielopoziomowej nawigacji w nagłówku.

Nawigacja boczna zarządzana przez redaktorów

Na witrynie informacyjnej deweloper osadza pasek boczny jednorazowo, a dalsze decyzje o jego zawartości przejmują redaktorzy. Z panelu „CMS Navigation” w edytorze decydują per-strona, czy dana strona ma się pojawiać w nawigacji, czy listować jej strony-dzieci i pod jaką sekcją ma się znaleźć.

Taki podział pracy odciąża zespół techniczny. Kod motywu zostaje nietknięty, a redakcja steruje widocznością treści w nawigacji bocznej. W bazie wiedzy panel pozwala na przykład wykluczyć strony pomocnicze z listy powiązań.

Dla jakich witryn WPML CMS Navigation sprawdza się najlepiej

WPML CMS Navigation jest naturalnym wyborem dla właścicieli wielojęzycznych witryn już używających WPML oraz dla deweloperów budujących na klasycznych motywach PHP, gdzie elementy osadza się action-hookami. Nie pasuje natomiast do czystych motywów blokowych (Full Site Editing) ani do stron, którym zależy głównie na okruszkach z danymi strukturalnymi pod SEO.

Witryny na WPML i klasyczne motywy PHP

Dodatek pochodzi z pakietu WPML Multilingual CMS, więc dla osoby prowadzącej witrynę na WPML to sposób dołożenia spójnej, językowo-świadomej nawigacji bez sięgania po wtyczkę od innego dostawcy.

Dla kogo WPML CMS Navigation sprawdza się najlepiej:

• Właściciele wielojęzycznych witryn WordPress już korzystających z WPML.
• Strony o rozbudowanej, hierarchicznej strukturze treści – portale, bazy wiedzy, katalogi z wieloma zagnieżdżonymi sekcjami.
• Deweloperzy i agencje pracujący na klasycznych motywach PHP z plikami header.php i sidebar.php.
• Projekty, w których nawigacja boczna ma być sterowana per-strona przez redaktorów z poziomu edytora.

Dla kogo WPML CMS Navigation nie jest najlepszym wyborem

Model osadzania oparty na funkcjach PHP w plikach motywu i widgetach klasycznych wyznacza granice zastosowania. W czystym środowisku blokowym oraz tam, gdzie liczą się przede wszystkim okruszki pod wyniki Google, lepiej sprawdzą się inne narzędzia.

Dla kogo WPML CMS Navigation nie jest najlepszym wyborem:

• Witryny na motywach blokowych i Full Site Editing bez plików PHP motywu – natywny model osadzania (hooki w szablonach) tu nie pasuje; właściwsza jest nawigacja blokowa WordPressa.
• Strony nastawione głównie na okruszki z danymi strukturalnymi pod SEO (rich snippets) – pełniejsze rozwiązanie dają tu Yoast SEO, Rank Math, Breadcrumb NavXT czy SEOPress, które generują znaczniki schema.org BreadcrumbList.
• Użytkownicy nieużywający i nieplanujący WPML – dodatek nie działa samodzielnie i bez rdzenia WPML jest bezużyteczny.
• Osoby unikające jakiejkolwiek edycji motywu – poza widgetem paska bocznego okruszki i rozwijane menu wymagają wstawienia kodu PHP do szablonów.

Wymagania techniczne i kompatybilność

WPML CMS Navigation wymaga działającego rdzenia WPML Multilingual CMS i jest dostępny wyłącznie w tym pakiecie – nie w tańszym Multilingual Blog ani osobno. Dziedziczy wymagania środowiskowe WPML: WordPress 4.7 lub nowszy oraz rekomendowane PHP 7.4 lub nowsze, z pełnym wsparciem PHP 8.3 od wydania WPML 4.6.12. Na PHP 8.4 pojawiają się niefunkcjonalne ostrzeżenia deprecation.

Wymagany pakiet WPML Multilingual CMS

Uwaga: WPML CMS Navigation nie jest samodzielną wtyczką. Działa wyłącznie z zainstalowanym rdzeniem WPML Multilingual CMS i przychodzi jako dodatek w tym pakiecie – tańszy plan Multilingual Blog go nie obejmuje.

Sam dodatek nie publikuje osobnej tabeli wymagań – przejmuje wymagania środowiskowe rdzenia WPML, z którym współpracuje. Dlatego poniższe parametry odnoszą się do środowiska całego pakietu WPML.

Środowisko WordPress i PHP

Dodatek działa na WordPress 4.7 i nowszych, a producent deklaruje zakres zgodności do wersji 7.0; zalecana jest aktualna wersja WordPress. Po stronie PHP rekomendowane jest 7.4 lub nowsze, a od wydania WPML 4.6.12 z lipca 2024 roku pakiet ma pełne wsparcie PHP 8.3. Wsparcie PHP 7.0 i 7.1 zostało wycofane.

Block themes, dane strukturalne i PHP 8.4

WPML CMS Navigation opiera się na funkcjach PHP w plikach motywu i na widgetach klasycznych, więc w czystych motywach blokowych i środowisku Full Site Editing jego natywny model osadzania nie ma zastosowania. Dokumentacja producenta nie opisuje ścieżki dla FSE, a dla takich witryn właściwsza jest nawigacja blokowa WordPressa.

Dokumentacja nie potwierdza też generowania danych strukturalnych schema.org BreadcrumbList – do czasu potwierdzenia należy zakładać brak natywnej obsługi rich snippets. Witrynom, którym zależy na okruszkach pod wyniki Google, ten kierunek lepiej zapewniają wtyczki SEO.

Na PHP 8.4 pojawiają się ostrzeżenia o tworzeniu dynamicznych właściwości w pliku cache.class.php. Według wsparcia WPML to komunikaty niefunkcjonalne, które nie wpływają na działanie, a ich naprawa jest planowana w kolejnych wydaniach.