Modul Language Flags pentru Magento 2
- Compatibilitate
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
- Hyva Theme
- Hyva Theme Redy
Descriere / Modul Language Flags pentru Magento 2
MAGENTO 2 · MAI MULTE PIEȚE · NAVIGARE
Ajută clientul să aleagă limba și piața potrivite.
Kowal Language Flags
Înlocuiește comutatorul standard cu o listă clară de steaguri și etichete. Conectează store views, alte websites și adrese externe într-un singur punct de navigare.
Store Views · Websites și URL · Dropdown sau inline
CUM FUNCȚIONEAZĂ ÎN PRACTICĂ
01 · Alegi destinațiile
Configurezi vizualizările magazinului, websites sau adrese proprii.
02 · Adaugi steaguri și etichete
Folosești pictogramele incluse sau propriile fișiere.
03 · Clientul alege versiunea
Comutatorul îl direcționează către limba sau piața selectată.
Ce câștigă magazinul tău?
Descoperă funcțiile, utilizarea și setările modulului.
Un singur switcher pentru mai multe scenarii lingvistice
Kowal_LanguageFlags rezolvă problema comutatorului de limbă greu de citit din Magento 2. În locul listei standard de coduri store view, clientul vede un switcher intuitiv cu steaguri, nume de limbi și posibilitatea de a trece nu doar între store views, ci și între websites și magazine externe.
Această soluție este utilă mai ales acolo unde:
- un singur magazin gestionează mai multe versiuni lingvistice;
- piețele diferite funcționează ca websites separate;
- o parte din trafic trebuie direcționată către o altă instanță Magento;
- este necesar un switcher unitar pentru diferite tipuri de adrese destinație.
Ce oferă modulul
- steaguri pentru store views;
- steaguri pentru alte websites din aceeași instanță Magento;
- steaguri pentru orice URL-uri, de exemplu către un magazin Magento separat;
- etichete proprii și marcaje scurte pentru limbi;
- două variante de prezentare:
dropdownșiinline; - suport pentru switcherul nativ Magento și pentru widget.
Beneficii de business
- recunoașterea mai rapidă a versiunii lingvistice de către client;
- mai puține erori la alegerea pieței sau a limbii;
- prezentare mai profesională a magazinului multilingv;
- posibilitatea de a conecta convenabil mai multe storefronturi într-un singur punct de navigare;
- implementare mai rapidă decât construirea unui component dedicat de la zero.
Beneficii tehnice
- configurare din panoul de administrare;
- compatibilitate cu mecanismul nativ Magento pentru store view switch;
- o singură configurație pentru switcherul nativ și pentru widget;
- set implicit de steaguri SVG gata pregătite, copiat în
pub/media/language_flags/în timpul instalării; - nu este necesară construirea unei tabele de date separate la început;
- posibilitate de implementare prin Composer.
Set de steaguri gata de utilizare
Modulul include un set de pictograme SVG gata pregătite 24x18, care pot fi copiate automat în pub/media/language_flags/ în timpul bin/magento setup:upgrade.
Steaguri disponibile:
Steaguri 1–10
atAustriabeBelgiabgBulgariacyCipruczCehiadeGermaniadkDanemarcaeeEstoniaesSpaniaeuUniunea Europeană
Steaguri 11–20
fiFinlandafrFranțagrGreciahrCroațiahuUngariaieIrlandaitItalialtLituanialuLuxemburglvLetonia
Steaguri 21–30
mtMaltanlȚările de JosplPoloniaptPortugaliaroRomâniaseSuediasiSloveniaskSlovaciaukRegatul UnitusStatele Unite
Pentru cine
Modulul este destinat pentru:
- magazine Magento 2 care operează pe mai multe piețe;
- instalări cu mai multe store views și websites;
- proiecte în care o parte dintre versiunile lingvistice funcționează în afara storefrontului principal;
- echipe care doresc să implementeze un switcher clar fără reconstruirea core Magento.
Exemple de utilizare
Un Magento, mai multe store views
Magazinul are versiunile:
PLENDE
Fiecăreia i se poate atribui un steag și o etichetă separate.
Un Magento, mai multe websites
Magazinul folosește websites separate pentru diferite țări, de exemplu:
- Polonia
- Germania
- Franța
Modulul permite afișarea acestor websites în același switcher cu store views locale.
Storefronturi distribuite
O parte dintre piețe funcționează într-o altă instanță Magento sau sub un alt domeniu. În această situație, Custom URL Flags permit includerea lor în comutatorul comun.
Rezultatul implementării
Clientul primește un singur switcher coerent pentru limbă și piață, iar administratorul îl poate gestiona din configurația Magento, fără a crea componente frontend suplimentare.
Aspect și selectarea steagurilor din panou
În Stores → Configuration → Kowal → Language Flags activezi modulul și înlocuirea opțională a comutatorului nativ. Poți seta modul dropdown sau inline, vizibilitatea numelor limbilor, spațiul dintre steaguri și scala pictogramelor. Numele rămân disponibile pentru cititoarele de ecran chiar și după ascunderea etichetelor vizibile.
Alegi imaginile din pickerul din pub/media/language_flags/ și configurezi Store View Flags, Website Flags și Custom URL Flags. Comutatorul poate fi inserat și ca widget Language Flags Switcher într-o pagină sau într-un bloc CMS.
Cerințe și modul de trecere între magazine
Pachetul verificat necesită PHP ^8.1 || ^8.2 || ^8.3 și modulele Magento definite în Composer. Store View folosește comutarea nativă Magento. Website și URL-ul propriu duc direct la adresa indicată.
Alegerea steagurilor, etichetelor și adreselor permite adaptarea navigării la piețe. Modulul nu traduce conținutul produselor; versiunile lingvistice sunt pregătite în configurația și datele magazinului.
Instalare prin Composer
Pachet: kowal/module-language-flags; modul: Kowal_LanguageFlags. După configurarea accesului la repository-ul Kowal, instalează pachetul, activează modulul, execută actualizarea Magento și golește cache-ul. Pentru modul de producție, include compilarea și implementarea conținutului static conform procesului magazinului.
De la configurare la rezultat
1. Alegi destinațiile
Configurezi vizualizările magazinului, websites sau adrese proprii.
2. Adaugi steaguri și etichete
Folosești pictogramele incluse sau propriile fișiere.
3. Clientul alege versiunea
Comutatorul îl direcționează către limba sau piața selectată.
Navigare comună pentru mai multe storefronturi
Exemplu: versiunea poloneză funcționează ca Store View, piața germană ca website separat, iar magazinul britanic sub un alt domeniu.
Poți afișa toate cele trei destinații într-un singur comutator. Store View folosește procesul nativ Magento, în timp ce websites și URL-urile proprii funcționează ca linkuri directe.
Organizează alegerea versiunii lingvistice și a pieței
Vrei să adaptezi modulul la magazinul tău? Întreabă despre implementarea Kowal Language Flags și discută configurația sau extensiile necesare.
Mai multe informații
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Conformitate cu șablonul | Hyvä, Luma / Blank, KOWAL |
Instrucțiuni de instalare a modulului
# Datele de acces, e-mailul clientului și tokenul de licență, le vei primi prin e-mail după achiziție.
# Sunt disponibile și în panoul clientului după autentificarea pe kowal.store.
# Înlocuiește TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului, iar TWOJ_TOKEN cu tokenul primit.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
composer require kowal/module-language-flags
bin/magento module:enable Kowal_LanguageFlags
bin/magento setup:upgrade
bin/magento cache:flush
Instrucțiuni de instalare și configurare a modulului Magento 2 Language Flags
Instalare
Instalare prin Composer
Datele de acces la repository-ul Composer, adresa de e-mail a clientului și tokenul de licență, le vei primi prin e-mail după achiziție. Sunt disponibile și în panoul clientului după autentificarea pe kowal.store. Înlocuiește TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului tău, iar TWOJ_TOKEN cu tokenul primit. Execută comenzile în directorul rădăcină Magento.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-language-flagsbin/magento module:enable Kowal_LanguageFlagsbin/magento setup:upgradebin/magento cache:flushComenzi suplimentare pentru production mode
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushLocația configurației
Panou de administrare:
Stores > Configuration > Kowal > Language FlagsWidget pentru editorul CMS
Modulul pune la dispoziție widgetul:
Language Flags SwitcherPoate fi inserat în:
Content > BlocksContent > Pages
Calea în editor:
Edit > Insert Widget > Language Flags SwitcherWidgetul suportă:
- modul
dropdownsauinline; - activarea sau ascunderea numelor limbilor;
- o clasă CSS suplimentară.
Steaguri implicite
În timpul bin/magento setup:upgrade, modulul copiază fișierele SVG implicite din:
view/frontend/web/images/flags/în directorul:
pub/media/language_flags/Sunt copiate doar fișierele lipsă, fără suprascrierea steagurilor deja existente.
Configurare generală
Secțiunea General Settings conține câmpurile care controlează funcționarea modulului.
Enable Module
Cale:
language_flags/general/enabledSemnificație:
Yesactivează modulul;Nodezactivează modulul pe frontend.
Replace Native Store View Switcher
Cale:
language_flags/general/native_enabledSemnificație:
Yesînlocuiește switcherul nativ Magento cu versiunea cu steaguri;Nolasă switcherul nativ neschimbat.
Native Display Mode
Cale:
language_flags/general/native_display_modeOpțiuni disponibile:
dropdowninline
Semnificație:
dropdownafișează poziția curentă și lista derulantă a celorlalte;inlineafișează toate steagurile imediat, pe o singură linie.
Show Language Names
Cale:
language_flags/general/show_labelsSemnificație:
Yesafișează numele limbilor lângă steaguri;Noascunde numele în vizualizarea principală, dar le păstrează pentru accesibilitate.
Fallback to Store View Name
Cale:
language_flags/general/fallback_to_store_nameSemnificație:
Yesfolosește numele store view atunci cândLabelnu a fost completat;Nofolosește codul store view cu litere mari.
Inline Flag Gap (px)
Cale:
language_flags/general/inline_gapSemnificație:
- setează spațiul dintre elementele switcherului în modul
inline; - valoarea este calculată în pixeli;
- valoarea implicită este
8.
Icon Scale (%)
Cale:
language_flags/general/icon_scale_percentSemnificație:
100păstrează dimensiunile originale ale imaginii;- o valoare mai mică reduce proporțional lățimea și înălțimea;
- scalează steagurile în ambele moduri de randare.
Configurarea tabelelor cu steaguri
Modulul suportă trei seturi separate de intrări:
Store View FlagsWebsite FlagsCustom URL Flags
Pe frontend, intrările sunt combinate într-un singur set de elemente ale switcherului.
Store View Flags
Cale:
language_flags/general/flag_configScop:
Configurarea steagurilor pentru store views gestionate de mecanismul nativ Magento.
Coloanele formularului
Store Code
Selectează store view din lista Magento.
Semnificație:
- atribuie steagul unui store view concret;
- folosește mecanismul nativ Magento de comutare a store view.
Flag File
Calea către fișierul steagului, selectată din pickerul de fișiere integrat.
Semnificație:
- definește imaginea afișată pe frontend;
- poate fi salvată ca
pl.svgsaulanguage_flags/pl.svg; - căile relative sunt rezolvate din directorul:
pub/media/language_flags/Label
Numele complet al limbii sau pieței, de exemplu:
PolskiEnglishDeutsch
Semnificație:
- este afișată lângă steag atunci când
Show Language Nameseste activat; - servește și ca text auxiliar pentru accesibilitate.
Short Label
Etichetă scurtă, de exemplu:
PLENDE
Semnificație:
- este utilizată într-o vizualizare mai compactă;
- poate fi folosită în locul numelui complet.
Website Flags
Cale:
language_flags/general/website_flag_configScop:
Configurarea steagurilor care direcționează către alte websites din aceeași instanță Magento.
Cum funcționează
- clicul nu execută nativul
store switch post; - intrarea este randată ca link obișnuit către base URL al website-ului destinație;
- website-ul curent nu este adăugat ca opțiune separată.
Coloanele formularului
Website
Selectează website Magento din listă.
Semnificație:
- definește website-ul destinație pentru intrare;
- servește la obținerea adresei de bază a storefrontului destinație.
Flag File
Funcționează la fel ca în Store View Flags.
Label
Eticheta completă afișată pe frontend.
Dacă rămâne goală:
- modulul va folosi numele website-ului.
Short Label
Etichetă scurtă, de exemplu:
UKDEFR
Dacă rămâne goală:
- modulul va folosi codul website-ului cu litere mari.
Custom URL Flags
Cale:
language_flags/general/custom_url_flag_configScop:
Configurarea steagurilor care direcționează către orice adrese URL, de exemplu către o altă instanță Magento sau un magazin extern.
Coloanele formularului
URL
Adresa destinație a linkului.
Exemple:
https://example.de/https://en.example.com/https://shop.example.cz/
Semnificație:
- intrarea este randată ca link obișnuit
href; - nu folosește mecanismul nativ Magento store switch.
Flag File
Funcționează la fel ca în celelalte tabele.
Label
Eticheta completă afișată pe frontend.
Dacă rămâne goală:
- modulul va încerca să folosească hostul din URL.
Short Label
Etichetă scurtă pentru varianta compactă.
Dacă rămâne goală:
- modulul va construi abrevierea pe baza hostului;
- dacă acest lucru nu este posibil, va folosi valoarea
URL.
Pregătirea fișierelor cu steaguri
Locație recomandată:
pub/media/language_flags/Formate recomandate:
svgpng
Exemple de nume de fișiere:
pl.svgen.svgde.svgfr.svgFlux de configurare de bază
- Activează modulul prin
Enable Module. - Decide dacă vrei să înlocuiești switcherul nativ Magento.
- Setează
Native Display Mode. - Adaugă fișierele cu steaguri în
pub/media/language_flags/. - Completează
Store View Flags. - Adaugă intrări opționale în
Website Flags. - Adaugă intrări opționale în
Custom URL Flags. - Salvează configurația și golește cache-ul.
Comenzi CLI utile
bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush