Instructiuni de instalare si configurare a modulului Magento 2 Language Flags

Instalare

Instalare prin Composer

composer require kowal/module-language-flagsbin/magento module:enable Kowal_LanguageFlagsbin/magento setup:upgradebin/magento cache:flush

Instalare din depozitul Git

composer config repositories.kowal-language-flags vcs https://github.com/kowalco/language-flagscomposer require kowal/module-language-flagsbin/magento module:enable Kowal_LanguageFlagsbin/magento setup:upgradebin/magento cache:flush

Comenzi suplimentare pentru production mode

bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flush

Locatia configurarii

Panou de administrare:

Stores > Configuration > Kowal > Language Flags

Widget pentru editorul CMS

Modulul pune la dispozitie widget-ul:

Language Flags Switcher

Acesta poate fi inserat in:

• Content > Blocks
• Content > Pages

Calea in editor:

Edit > Insert Widget > Language Flags Switcher

Widget-ul suporta:

• modul dropdown sau inline;
• afisarea sau ascunderea denumirilor limbilor;
• o clasa CSS suplimentara.

Steaguri implicite

In timpul bin/magento setup:upgrade, modulul copiaza fisierele SVG implicite din:

view/frontend/web/images/flags/

in directorul:

pub/media/language_flags/

Sunt copiate doar fisierele lipsa, fara a suprascrie steagurile deja existente.

Configurare generala

Sectiunea General Settings contine campurile care controleaza functionarea modulului.

Enable Module

Cale:

language_flags/general/enabled

Semnificatie:

• Yes activeaza modulul;
• No dezactiveaza modulul pe frontend.

Replace Native Store View Switcher

Cale:

language_flags/general/native_enabled

Semnificatie:

• Yes inlocuieste switcherul nativ Magento cu versiunea cu steaguri;
• No lasa switcherul nativ neschimbat.

Native Display Mode

Cale:

language_flags/general/native_display_mode

Optiuni disponibile:

• dropdown
• inline

Semnificatie:

• dropdown afiseaza pozitia curenta si o lista derulanta cu celelalte;
• inline afiseaza toate steagurile imediat pe un singur rand.

Show Language Names

Cale:

language_flags/general/show_labels

Semnificatie:

• Yes afiseaza denumirile limbilor langa steaguri;
• No ascunde denumirile in vizualizarea principala, dar le pastreaza pentru accesibilitate.

Fallback to Store View Name

Cale:

language_flags/general/fallback_to_store_name

Semnificatie:

• Yes foloseste denumirea store view atunci cand Label nu a fost completat;
• No foloseste codul store view cu majuscule.

Inline Flag Gap (px)

Cale:

language_flags/general/inline_gap

Semnificatie:

• seteaza spatiul dintre elementele switcherului in modul inline;
• valoarea este calculata in pixeli;
• valoarea implicita este 8.

Icon Scale (%)

Cale:

language_flags/general/icon_scale_percent

Semnificatie:

• 100 pastreaza dimensiunile originale ale imaginii;
• o valoare mai mica reduce proportional latimea si inaltimea;
• scaleaza steagurile in ambele moduri de randare.

Configurarea tabelelor cu steaguri

Modulul suporta trei seturi separate de intrari:

1. Store View Flags
2. Website Flags
3. Custom URL Flags

Pe frontend, intrarile sunt combinate intr-un singur set de elemente ale switcherului.

Store View Flags

Cale:

language_flags/general/flag_config

Destinatie:

Configurarea steagurilor pentru store views gestionate de mecanismul nativ Magento.

Coloanele formularului

Store Code

Selecteaza store view din lista Magento.

Semnificatie:

• atribuie un steag unui anumit store view;
• foloseste mecanismul nativ Magento de comutare a store view.

Flag File

Calea catre fisierul steagului este selectata din selectorul de fisiere integrat.

Semnificatie:

• specifica imaginea afisata pe frontend;
• poate fi salvata ca pl.svg sau language_flags/pl.svg;
• caile relative sunt rezolvate din directorul:

pub/media/language_flags/

Label

Denumirea completa a limbii sau a pietei, de exemplu:

• Polski
• English
• Deutsch

Semnificatie:

• este afisata langa steag atunci cand Show Language Names este activat;
• serveste si ca text ajutator pentru accesibilitate.

Short Label

Eticheta scurta, de exemplu:

• PL
• EN
• DE

Semnificatie:

• este utilizata intr-o vizualizare mai compacta;
• poate fi folosita in locul denumirii complete.

Website Flags

Cale:

language_flags/general/website_flag_config

Destinatie:

Configurarea steagurilor care directioneaza catre alte websites din aceeasi instanta Magento.

Cum functioneaza

• clicul nu executa store switch post nativ;
• intrarea este randata ca un link obisnuit catre base URL-ul website-ului tinta;
• website-ul curent nu este adaugat ca optiune separata.

Coloanele formularului

Website

Selecteaza website-ul Magento din lista.

Semnificatie:

• specifica website-ul tinta pentru intrare;
• serveste la preluarea adresei de baza a storefront-ului tinta.

Flag File

Functioneaza la fel ca in Store View Flags.

Label

Eticheta completa afisata pe frontend.

Daca ramane goala:

• modulul va folosi numele website-ului.

Short Label

Eticheta scurta, de exemplu:

• UK
• DE
• FR

Daca ramane goala:

• modulul va folosi codul website-ului cu majuscule.

Custom URL Flags

Cale:

language_flags/general/custom_url_flag_config

Destinatie:

Configurarea steagurilor care directioneaza catre orice adrese URL, de exemplu catre o alta instanta Magento sau un magazin extern.

Coloanele formularului

URL

Adresa de destinatie a linkului.

Exemple:

• https://example.de/
• https://en.example.com/
• https://shop.example.cz/

Semnificatie:

• intrarea este randata ca un link obisnuit href;
• nu foloseste mecanismul nativ Magento de store switch.

Flag File

Functioneaza la fel ca in celelalte tabele.

Label

Eticheta completa afisata pe frontend.

Daca ramane goala:

• modulul va incerca sa foloseasca host-ul din URL.

Short Label

Eticheta scurta pentru varianta compacta.

Daca ramane goala:

• modulul va construi o abreviere pe baza host-ului;
• daca acest lucru nu este posibil, va folosi valoarea URL.

Pregatirea fisierelor de steaguri

Locatie recomandata:

pub/media/language_flags/

Formate recomandate:

• svg
• png

Exemple de nume de fisiere:

pl.svgen.svgde.svgfr.svg

Flux de configurare de baza

1. Activeaza modulul prin Enable Module.
2. Decide daca doresti sa inlocuiesti switcherul nativ Magento.
3. Seteaza Native Display Mode.
4. Adauga fisierele de steaguri in pub/media/language_flags/.
5. Completeaza Store View Flags.
6. Adauga intrari optionale in Website Flags.
7. Adauga intrari optionale in Custom URL Flags.
8. Salveaza configuratia si goleste cache-ul.

Comenzi CLI utile

bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush