Moduł Language Flags dla Magento 2
Opis / Moduł Language Flags dla Magento 2
MAGENTO 2 · WIELE RYNKÓW · NAWIGACJA
Pomóż klientowi wybrać właściwy język i rynek.
Kowal Language Flags
Zastąp standardowy przełącznik czytelną listą flag i etykiet. Połącz widoki sklepu, inne websites i zewnętrzne adresy w jednym miejscu nawigacji.
Store Views · Websites i URL · Dropdown lub inline
JAK TO DZIAŁA W PRAKTYCE
01 · Wybierasz cele
Konfigurujesz widoki sklepu, websites lub własne adresy.
02 · Dodajesz flagi i etykiety
Korzystasz z gotowych ikon albo własnych plików.
03 · Klient wybiera wersję
Przełącznik kieruje do wybranego języka lub rynku.
Co zyskuje Twój sklep?
Poznaj funkcje, zastosowanie i ustawienia modułu.
Jeden switcher dla wielu scenariuszy językowych
Kowal_LanguageFlags rozwiązuje problem mało czytelnego przełącznika języka w Magento 2. Zamiast standardowej listy kodów store view klient widzi intuicyjny switcher z flagami, nazwami języków i możliwością przechodzenia nie tylko między store views, ale również między websites oraz zewnętrznymi sklepami.
To rozwiązanie jest przydatne szczególnie tam, gdzie:
- jeden sklep obsługuje kilka wersji językowych;
- różne rynki działają jako osobne websites;
- część ruchu ma trafić do innej instancji Magento;
- potrzebny jest jeden spójny switcher dla różnych typów docelowych adresów.
Co daje moduł
- flagi dla store views;
- flagi dla innych websites w tej samej instancji Magento;
- flagi dla dowolnych URL-i, np. do osobnego sklepu Magento;
- własne etykiety i skrócone oznaczenia języków;
- dwa warianty prezentacji:
dropdowniinline; - obsługę natywnego switchera Magento oraz widgetu.
Korzyści biznesowe
- szybsze rozpoznanie wersji językowej przez klienta;
- mniej błędów przy wyborze rynku lub języka;
- bardziej profesjonalna prezentacja sklepu wielojęzycznego;
- możliwość wygodnego łączenia wielu storefrontów w jednym punkcie nawigacji;
- krótsza droga do wdrożenia niż budowa dedykowanego komponentu od zera.
Korzyści techniczne
- konfiguracja z poziomu panelu administracyjnego;
- zgodność z natywnym mechanizmem Magento dla store view switch;
- jedna konfiguracja dla switchera natywnego i widgetu;
- domyślny zestaw gotowych flag SVG kopiowany do
pub/media/language_flags/podczas instalacji; - brak potrzeby budowy osobnej tabeli danych na start;
- możliwość wdrożenia przez Composer.
Gotowy zestaw flag
Moduł zawiera zestaw gotowych ikon SVG 24x18, które mogą być automatycznie skopiowane do pub/media/language_flags/ podczas bin/magento setup:upgrade.
Dostępne flagi:
Flagi 1–10
atAustriabeBelgiabgBułgariacyCyprczCzechydeNiemcydkDaniaeeEstoniaesHiszpaniaeuUnia Europejska
Flagi 11–20
fiFinlandiafrFrancjagrGrecjahrChorwacjahuWęgryieIrlandiaitWłochyltLitwaluLuksemburglvŁotwa
Flagi 21–30
mtMaltanlHolandiaplPolskaptPortugaliaroRumuniaseSzwecjasiSłoweniaskSłowacjaukWielka BrytaniausStany Zjednoczone
Dla kogo
Moduł jest przeznaczony dla:
- sklepów Magento 2 działających na wielu rynkach;
- instalacji z wieloma store views i websites;
- projektów, w których część wersji językowych działa poza głównym storefrontem;
- zespołów, które chcą wdrożyć czytelny switcher bez przebudowy core Magento.
Przykładowe zastosowania
Jeden Magento, wiele store views
Sklep posiada wersje:
PLENDE
Każda z nich może mieć przypisaną osobną flagę i etykietę.
Jeden Magento, wiele websites
Sklep korzysta z osobnych websites dla różnych krajów, np.:
- Polska
- Niemcy
- Francja
Moduł pozwala pokazać te websites w tym samym switcherze co lokalne store views.
Rozproszone storefronty
Część rynków działa w innej instancji Magento lub pod inną domeną. W takiej sytuacji Custom URL Flags pozwalają dołączyć je do wspólnego przełącznika.
Efekt wdrożenia
Klient dostaje jeden spójny switcher języka i rynku, a administrator może zarządzać nim z poziomu konfiguracji Magento bez tworzenia dodatkowych komponentów frontendowych.
Wygląd i wybór flag z panelu
W Stores → Configuration → Kowal → Language Flags włączasz moduł oraz opcjonalną podmianę natywnego przełącznika. Ustawisz tryb dropdown lub inline, widoczność nazw języków, odstęp między flagami oraz skalę ikon. Nazwy pozostają dostępne dla czytników ekranu także po ukryciu widocznych etykiet.
Wybierasz obrazy z pickera w pub/media/language_flags/ i konfigurujesz Store View Flags, Website Flags oraz Custom URL Flags. Przełącznik możesz również wstawić jako widget Language Flags Switcher w stronie lub bloku CMS.
Wymagania i sposób przechodzenia między sklepami
Sprawdzony pakiet wymaga PHP ^8.1 || ^8.2 || ^8.3 oraz modułów Magento określonych w Composer. Store View korzysta z natywnego przełączania Magento. Website i własny URL prowadzą bezpośrednio do wskazanego adresu.
Dobór flag, etykiet i adresów pozwala dopasować nawigację do rynków. Moduł nie tłumaczy treści produktów; wersje językowe przygotowujesz w konfiguracji i danych sklepu.
Instalacja przez Composer
Pakiet: kowal/module-language-flags; moduł: Kowal_LanguageFlags. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, wykonaj aktualizację Magento i wyczyść cache. Dla trybu produkcyjnego uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.
Od konfiguracji do efektu
1. Wybierasz cele
Konfigurujesz widoki sklepu, websites lub własne adresy.
2. Dodajesz flagi i etykiety
Korzystasz z gotowych ikon albo własnych plików.
3. Klient wybiera wersję
Przełącznik kieruje do wybranego języka lub rynku.
Wspólna nawigacja dla wielu storefrontów
Przykład: polska wersja działa jako Store View, niemiecki rynek jako osobny website, a brytyjski sklep pod inną domeną.
Wszystkie trzy cele możesz pokazać w jednym przełączniku. Store View używa natywnego procesu Magento, natomiast websites i własne URL-e działają jako bezpośrednie odnośniki.
Uporządkuj wybór wersji językowej i rynku
Chcesz dopasować moduł do swojego sklepu? Zapytaj o wdrożenie Kowal Language Flags i omów konfigurację lub potrzebne rozszerzenia.
Więcej informacji
| Motyw Hyvä | Zgodny z motywem Hyvä |
|---|---|
| Zgodność z szablonem | Hyvä, Luma / Blank, KOWAL |
Instrukcja Instalacji modułu
Przed rozpoczęciem
Instrukcja instalacji i konfiguracji modułu Magento 2 Language Flags
Instalacja
Dane dostępowe do repozytorium Composer (adres e-mail klienta i token licencyjny) otrzymasz e-mailem po zakupie. Są również dostępne w panelu klienta po zalogowaniu na kowal.store. Zastąp TWOJ_EMAIL_KLIENTA adresem e-mail swojego konta, a TWOJ_TOKEN otrzymanym tokenem. Polecenia wykonaj w katalogu głównym Magento.
Dodaj repozytorium Composer
composer config repositories.kowal composer https://repo.kowal.storeSkonfiguruj dane dostępowe
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"Zainstaluj pakiet modułu
composer require kowal/module-language-flagsWłącz moduł
bin/magento module:enable Kowal_LanguageFlagsZaktualizuj Magento
bin/magento setup:upgradeWyczyść pamięć podręczną
bin/magento cache:flushDodatkowe polecenia dla production mode
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
Lokalizacja konfiguracji
Panel administracyjny:
Stores > Configuration > Kowal > Language Flags
Widget do edytora CMS
Modul udostepnia widget:
Language Flags Switcher
Mozna go wstawic w:
Content > BlocksContent > Pages
Sciezka w edytorze:
Edit > Insert Widget > Language Flags Switcher
Widget obsluguje:
- tryb
dropdownlubinline; - wlaczanie lub ukrywanie nazw jezykow;
- dodatkowa klase CSS.
Domyslne flagi
Podczas bin/magento setup:upgrade modul kopiuje domyslne pliki SVG z:
view/frontend/web/images/flags/
do katalogu:
pub/media/language_flags/
Kopiowane sa tylko brakujace pliki, bez nadpisywania juz istniejacych flag.
Konfiguracja ogolna
Sekcja General Settings zawiera pola sterujace dzialaniem modulu.
Enable Module
Sciezka:
language_flags/general/enabled
Znaczenie:
Yeswlacza modul;Nowylacza modul na frontendzie.
Replace Native Store View Switcher
Sciezka:
language_flags/general/native_enabled
Znaczenie:
Yespodmienia natywny switcher Magento na wersje z flagami;Nopozostawia natywny switcher bez zmian.
Native Display Mode
Sciezka:
language_flags/general/native_display_mode
Dostepne opcje:
dropdowninline
Znaczenie:
dropdownpokazuje aktualna pozycje i rozwijana liste pozostalych;inlinepokazuje wszystkie flagi od razu w jednej linii.
Show Language Names
Sciezka:
language_flags/general/show_labels
Znaczenie:
Yespokazuje nazwy jezykow obok flag;Noukrywa nazwy w widoku glownym, ale zostawia je dla dostepnosci.
Fallback to Store View Name
Sciezka:
language_flags/general/fallback_to_store_name
Znaczenie:
Yesuzywa nazwy store view, gdyLabelnie zostal uzupelniony;Nouzywa kodu store view wielkimi literami.
Inline Flag Gap (px)
Sciezka:
language_flags/general/inline_gap
Znaczenie:
- ustawia odstep pomiedzy elementami switchera w trybie
inline; - wartosc jest liczona w pikselach;
- domyslna wartosc to
8.
Icon Scale (%)
Sciezka:
language_flags/general/icon_scale_percent
Znaczenie:
100zachowuje oryginalne wymiary obrazka;- nizsza wartosc zmniejsza szerokosc i wysokosc proporcjonalnie;
- skaluje flagi w obu trybach renderowania.
Konfiguracja tabel z flagami
Modul obsluguje trzy osobne zestawy wpisow:
Store View FlagsWebsite FlagsCustom URL Flags
Na frontendzie wpisy sa laczone w jeden zestaw elementow switchera.
Store View Flags
Sciezka:
language_flags/general/flag_config
Przeznaczenie:
Konfiguracja flag dla store views obslugiwanych przez natywny mechanizm Magento.
Kolumny formularza
Store Code
Wybiera store view z listy Magento.
Znaczenie:
- przypisuje flage do konkretnego store view;
- korzysta z natywnego mechanizmu przelaczania store view Magento.
Flag File
Sciezka do pliku flagi wybierana z wbudowanego pickera plikow.
Znaczenie:
- okresla obrazek wyswietlany na frontendzie;
- moze byc zapisana jako
pl.svglublanguage_flags/pl.svg; - relatywne sciezki sa rozwiazywane z katalogu:
pub/media/language_flags/
Label
Pelna nazwa jezyka lub rynku, np.:
PolskiEnglishDeutsch
Znaczenie:
- jest pokazywana obok flagi, gdy wlaczone jest
Show Language Names; - sluzy rowniez jako tekst pomocniczy dla dostepnosci.
Short Label
Skrocona etykieta, np.:
PLENDE
Znaczenie:
- jest wykorzystywana w bardziej kompaktowym widoku;
- moze byc uzyta zamiast pelnej nazwy.
Website Flags
Sciezka:
language_flags/general/website_flag_config
Przeznaczenie:
Konfiguracja flag kierujacych do innych websites w tej samej instancji Magento.
Jak to dziala
- klikniecie nie wykonuje natywnego
store switch post; - wpis jest renderowany jako zwykly link do base URL docelowego website;
- biezacy website nie jest dodawany jako osobna opcja.
Kolumny formularza
Website
Wybiera website Magento z listy.
Znaczenie:
- okresla docelowy website dla wpisu;
- sluzy do pobrania adresu bazowego docelowego storefrontu.
Flag File
Dziala tak samo jak w Store View Flags.
Label
Pelna etykieta wyswietlana na frontendzie.
Jesli pozostanie pusta:
- modul uzyje nazwy website.
Short Label
Skrocona etykieta, np.:
UKDEFR
Jesli pozostanie pusta:
- modul uzyje kodu website wielkimi literami.
Custom URL Flags
Sciezka:
language_flags/general/custom_url_flag_config
Przeznaczenie:
Konfiguracja flag kierujacych do dowolnych adresow URL, np. do innej instancji Magento lub zewnetrznego sklepu.
Kolumny formularza
URL
Docelowy adres linku.
Przyklady:
https://example.de/https://en.example.com/https://shop.example.cz/
Znaczenie:
- wpis jest renderowany jako zwykly link
href; - nie korzysta z natywnego mechanizmu store switch Magento.
Flag File
Dziala tak samo jak w pozostalych tabelach.
Label
Pelna etykieta wyswietlana na frontendzie.
Jesli pozostanie pusta:
- modul sprobuje uzyc hosta z URL.
Short Label
Skrocona etykieta dla wariantu kompaktowego.
Jesli pozostanie pusta:
- modul zbuduje skrot na podstawie hosta;
- jesli to niemozliwe, uzyje wartosci
URL.
Przygotowanie plikow flag
Rekomendowana lokalizacja:
pub/media/language_flags/
Rekomendowane formaty:
svgpng
Przyklady nazw plikow:
pl.svg
en.svg
de.svg
fr.svg
Podstawowy przebieg konfiguracji
- Wlacz modul przez
Enable Module. - Zdecyduj, czy chcesz podmienic natywny switcher Magento.
- Ustaw
Native Display Mode. - Dodaj pliki flag do
pub/media/language_flags/. - Uzupelnij
Store View Flags. - Dodaj opcjonalne wpisy w
Website Flags. - Dodaj opcjonalne wpisy w
Custom URL Flags. - Zapisz konfiguracje i wyczysc cache.
Przydatne polecenia CLI
bin/magento module:status Kowal_LanguageFlags
bin/magento cache:clean
bin/magento cache:flush