Instrukcja instalacji i konfiguracji modulu Magento 2 Language Flags

Instalacja

Instalacja przez Composer

composer require kowal/module-language-flags
bin/magento module:enable Kowal_LanguageFlags
bin/magento setup:upgrade
bin/magento cache:flush

Instalacja z repozytorium Git

composer config repositories.kowal-language-flags vcs https://github.com/kowalco/language-flags
composer require kowal/module-language-flags
bin/magento module:enable Kowal_LanguageFlags
bin/magento setup:upgrade
bin/magento cache:flush

Dodatkowe 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 > Blocks
• Content > Pages

Sciezka w edytorze:

Edit > Insert Widget > Language Flags Switcher

Widget obsluguje:

• tryb dropdown lub inline;
• 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:

• Yes wlacza modul;
• No wylacza modul na frontendzie.

Replace Native Store View Switcher

Sciezka:

language_flags/general/native_enabled

Znaczenie:

• Yes podmienia natywny switcher Magento na wersje z flagami;
• No pozostawia natywny switcher bez zmian.

Native Display Mode

Sciezka:

language_flags/general/native_display_mode

Dostepne opcje:

• dropdown
• inline

Znaczenie:

• dropdown pokazuje aktualna pozycje i rozwijana liste pozostalych;
• inline pokazuje wszystkie flagi od razu w jednej linii.

Show Language Names

Sciezka:

language_flags/general/show_labels

Znaczenie:

• Yes pokazuje nazwy jezykow obok flag;
• No ukrywa nazwy w widoku glownym, ale zostawia je dla dostepnosci.

Fallback to Store View Name

Sciezka:

language_flags/general/fallback_to_store_name

Znaczenie:

• Yes uzywa nazwy store view, gdy Label nie zostal uzupelniony;
• No uzywa 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:

• 100 zachowuje 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:

1. Store View Flags
2. Website Flags
3. Custom 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.svg lub language_flags/pl.svg;
• relatywne sciezki sa rozwiazywane z katalogu:

pub/media/language_flags/

Label

Pelna nazwa jezyka lub rynku, np.:

• Polski
• English
• Deutsch

Znaczenie:

• jest pokazywana obok flagi, gdy wlaczone jest Show Language Names;
• sluzy rowniez jako tekst pomocniczy dla dostepnosci.

Short Label

Skrocona etykieta, np.:

• PL
• EN
• DE

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.:

• UK
• DE
• FR

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:

• svg
• png

Przyklady nazw plikow:

pl.svg
en.svg
de.svg
fr.svg

Podstawowy przebieg konfiguracji

1. Wlacz modul przez Enable Module.
2. Zdecyduj, czy chcesz podmienic natywny switcher Magento.
3. Ustaw Native Display Mode.
4. Dodaj pliki flag do pub/media/language_flags/.
5. Uzupelnij Store View Flags.
6. Dodaj opcjonalne wpisy w Website Flags.
7. Dodaj opcjonalne wpisy w Custom URL Flags.
8. Zapisz konfiguracje i wyczysc cache.

Przydatne polecenia CLI

bin/magento module:status Kowal_LanguageFlags
bin/magento cache:clean
bin/magento cache:flush