Modulo Language Flags per Magento 2
- Compatibilità
- 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
Descrizione / Modulo Language Flags per Magento 2
MAGENTO 2 · PIÙ MERCATI · NAVIGAZIONE
Aiuta il cliente a scegliere la lingua e il mercato corretti.
Kowal Language Flags
Sostituisci lo switcher standard con un elenco chiaro di bandiere ed etichette. Collega store view, altri websites e indirizzi esterni in un unico punto di navigazione.
Store Views · Websites e URL · Dropdown o inline
COME FUNZIONA IN PRATICA
01 · Scegli le destinazioni
Configuri store view, websites o indirizzi personalizzati.
02 · Aggiungi bandiere ed etichette
Utilizzi icone pronte o file personalizzati.
03 · Il cliente sceglie la versione
Lo switcher indirizza alla lingua o al mercato selezionato.
Cosa ottiene il tuo negozio?
Scopri funzioni, utilizzo e impostazioni del modulo.
Un unico switcher per diversi scenari linguistici
Kowal_LanguageFlags risolve il problema dello switcher della lingua poco leggibile in Magento 2. Invece dell’elenco standard dei codici store view, il cliente vede uno switcher intuitivo con bandiere, nomi delle lingue e la possibilità di passare non solo tra store views, ma anche tra websites e negozi esterni.
Questa soluzione è utile soprattutto quando:
- un negozio gestisce più versioni linguistiche;
- mercati diversi funzionano come websites separati;
- parte del traffico deve essere indirizzata a un’altra istanza Magento;
- serve un unico switcher coerente per diversi tipi di indirizzi di destinazione.
Cosa offre il modulo
- bandiere per store views;
- bandiere per altri websites nella stessa istanza Magento;
- bandiere per URL qualsiasi, ad es. per un negozio Magento separato;
- etichette personalizzate e sigle abbreviate delle lingue;
- due varianti di presentazione:
dropdowneinline; - supporto dello switcher nativo di Magento e del widget.
Vantaggi per il business
- riconoscimento più rapido della versione linguistica da parte del cliente;
- meno errori nella scelta del mercato o della lingua;
- presentazione più professionale del negozio multilingua;
- possibilità di collegare comodamente più storefront in un unico punto di navigazione;
- percorso di implementazione più breve rispetto alla creazione di un componente dedicato da zero.
Vantaggi tecnici
- configurazione dal pannello di amministrazione;
- compatibilità con il meccanismo nativo Magento per lo switch store view;
- un’unica configurazione per lo switcher nativo e il widget;
- set predefinito di bandiere SVG pronte, copiato in
pub/media/language_flags/durante l’installazione; - nessuna necessità di creare una tabella dati separata all’avvio;
- possibilità di implementazione tramite Composer.
Set di bandiere pronto
Il modulo include un set di icone SVG pronte 24x18, che possono essere copiate automaticamente in pub/media/language_flags/ durante bin/magento setup:upgrade.
Bandiere disponibili:
Bandiere 1–10
atAustriabeBelgiobgBulgariacyCiproczRepubblica CecadeGermaniadkDanimarcaeeEstoniaesSpagnaeuUnione Europea
Bandiere 11–20
fiFinlandiafrFranciagrGreciahrCroaziahuUngheriaieIrlandaitItalialtLituanialuLussemburgolvLettonia
Bandiere 21–30
mtMaltanlPaesi BassiplPoloniaptPortogalloroRomaniaseSveziasiSloveniaskSlovacchiaukRegno UnitousStati Uniti
A chi è destinato
Il modulo è destinato a:
- negozi Magento 2 attivi su più mercati;
- installazioni con più store views e websites;
- progetti in cui alcune versioni linguistiche funzionano al di fuori dello storefront principale;
- team che vogliono implementare uno switcher chiaro senza ricostruire il core Magento.
Esempi di utilizzo
Un Magento, molte store views
Il negozio dispone delle versioni:
PLENDE
Ognuna può avere una bandiera e un’etichetta separate.
Un Magento, molti websites
Il negozio utilizza websites separati per diversi Paesi, ad es.:
- Polonia
- Germania
- Francia
Il modulo consente di mostrare questi websites nello stesso switcher delle store views locali.
Storefront distribuiti
Alcuni mercati funzionano in un’altra istanza Magento o sotto un altro dominio. In questa situazione Custom URL Flags consente di aggiungerli a uno switcher comune.
Risultato dell’implementazione
Il cliente ottiene un unico switcher coerente per lingua e mercato, mentre l’amministratore può gestirlo dalla configurazione Magento senza creare componenti frontend aggiuntivi.
Aspetto e scelta delle bandiere dal pannello
In Stores → Configuration → Kowal → Language Flags abiliti il modulo e la sostituzione opzionale dello switcher nativo. Puoi impostare la modalità dropdown o inline, la visibilità dei nomi delle lingue, la distanza tra le bandiere e la scala delle icone. I nomi restano disponibili per gli screen reader anche dopo aver nascosto le etichette visibili.
Scegli le immagini dal picker in pub/media/language_flags/ e configuri Store View Flags, Website Flags e Custom URL Flags. Puoi inserire lo switcher anche come widget Language Flags Switcher in una pagina o in un blocco CMS.
Requisiti e modalità di passaggio tra negozi
Il pacchetto verificato richiede PHP ^8.1 || ^8.2 || ^8.3 e i moduli Magento definiti in Composer. Store View utilizza lo switching nativo di Magento. Website e URL personalizzato conducono direttamente all’indirizzo indicato.
La scelta di bandiere, etichette e indirizzi consente di adattare la navigazione ai mercati. Il modulo non traduce i contenuti dei prodotti; le versioni linguistiche vengono preparate nella configurazione e nei dati del negozio.
Installazione tramite Composer
Pacchetto: kowal/module-language-flags; modulo: Kowal_LanguageFlags. Dopo aver configurato l’accesso al repository Kowal, installa il pacchetto, abilita il modulo, esegui l’aggiornamento di Magento e svuota la cache. Per la modalità produzione, includi la compilazione e il deploy dei contenuti statici secondo il processo del negozio.
Dalla configurazione al risultato
1. Scegli le destinazioni
Configuri store view, websites o indirizzi personalizzati.
2. Aggiungi bandiere ed etichette
Utilizzi icone pronte o file personalizzati.
3. Il cliente sceglie la versione
Lo switcher indirizza alla lingua o al mercato selezionato.
Navigazione comune per più storefront
Esempio: la versione polacca funziona come Store View, il mercato tedesco come website separato e il negozio britannico sotto un altro dominio.
Puoi mostrare tutte e tre le destinazioni in un unico switcher. Store View utilizza il processo nativo di Magento, mentre websites e URL personalizzati funzionano come link diretti.
Organizza la scelta della versione linguistica e del mercato
Vuoi adattare il modulo al tuo negozio? Richiedi l’implementazione di Kowal Language Flags e discuti la configurazione o le estensioni necessarie.
Maggiori Informazioni
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Conformità al modello | Buono, Luma / Vuoto, Fabbro |
Istruzioni per l'installazione del modulo
# Riceverai i dati di accesso, e-mail del cliente e token di licenza, via e-mail dopo l’acquisto.
# Sono disponibili anche nel pannello cliente dopo l’accesso a kowal.store.
# Sostituisci TWOJ_EMAIL_KLIENTA con l’indirizzo e-mail dell’account e TWOJ_TOKEN con il token ricevuto.
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
Istruzioni di installazione e configurazione del modulo Magento 2 Language Flags
Installazione
Installazione tramite Composer
Riceverai i dati di accesso al repository Composer, indirizzo e-mail del cliente e token di licenza, via e-mail dopo l’acquisto. Sono disponibili anche nel pannello cliente dopo l’accesso a kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l’indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di 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:flushComandi aggiuntivi per production mode
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushPosizione della configurazione
Pannello di amministrazione:
Stores > Configuration > Kowal > Language FlagsWidget per l’editor CMS
Il modulo mette a disposizione il widget:
Language Flags SwitcherPuò essere inserito in:
Content > BlocksContent > Pages
Percorso nell’editor:
Edit > Insert Widget > Language Flags SwitcherIl widget supporta:
- modalità
dropdownoinline; - abilitazione o nascondimento dei nomi delle lingue;
- classe CSS aggiuntiva.
Bandiere predefinite
Durante bin/magento setup:upgrade il modulo copia i file SVG predefiniti da:
view/frontend/web/images/flags/alla directory:
pub/media/language_flags/Vengono copiati solo i file mancanti, senza sovrascrivere le bandiere già esistenti.
Configurazione generale
La sezione General Settings contiene i campi che controllano il funzionamento del modulo.
Enable Module
Percorso:
language_flags/general/enabledSignificato:
Yesabilita il modulo;Nodisabilita il modulo sul frontend.
Replace Native Store View Switcher
Percorso:
language_flags/general/native_enabledSignificato:
Yessostituisce lo switcher nativo di Magento con la versione con bandiere;Nolascia invariato lo switcher nativo.
Native Display Mode
Percorso:
language_flags/general/native_display_modeOpzioni disponibili:
dropdowninline
Significato:
dropdownmostra la posizione corrente e l’elenco a discesa delle altre;inlinemostra subito tutte le bandiere su una riga.
Show Language Names
Percorso:
language_flags/general/show_labelsSignificato:
Yesmostra i nomi delle lingue accanto alle bandiere;Nonasconde i nomi nella vista principale, ma li mantiene per l’accessibilità.
Fallback to Store View Name
Percorso:
language_flags/general/fallback_to_store_nameSignificato:
Yesusa il nome della store view quandoLabelnon è stato compilato;Nousa il codice della store view in maiuscolo.
Inline Flag Gap (px)
Percorso:
language_flags/general/inline_gapSignificato:
- imposta la distanza tra gli elementi dello switcher in modalità
inline; - il valore è calcolato in pixel;
- il valore predefinito è
8.
Icon Scale (%)
Percorso:
language_flags/general/icon_scale_percentSignificato:
100mantiene le dimensioni originali dell’immagine;- un valore più basso riduce proporzionalmente larghezza e altezza;
- scala le bandiere in entrambe le modalità di rendering.
Configurazione delle tabelle con bandiere
Il modulo supporta tre set separati di voci:
Store View FlagsWebsite FlagsCustom URL Flags
Sul frontend le voci vengono unite in un unico set di elementi dello switcher.
Store View Flags
Percorso:
language_flags/general/flag_configScopo:
Configurazione delle bandiere per le store views gestite dal meccanismo nativo Magento.
Colonne del modulo
Store Code
Seleziona una store view dall’elenco Magento.
Significato:
- assegna una bandiera a una store view specifica;
- utilizza il meccanismo nativo di switching delle store view Magento.
Flag File
Percorso del file della bandiera selezionato dal file picker integrato.
Significato:
- definisce l’immagine mostrata sul frontend;
- può essere salvato come
pl.svgolanguage_flags/pl.svg; - i percorsi relativi vengono risolti dalla directory:
pub/media/language_flags/Label
Nome completo della lingua o del mercato, ad es.:
PolskiEnglishDeutsch
Significato:
- viene mostrato accanto alla bandiera quando
Show Language Namesè abilitato; - viene usato anche come testo di supporto per l’accessibilità.
Short Label
Etichetta abbreviata, ad es.:
PLENDE
Significato:
- viene utilizzata in una vista più compatta;
- può essere usata al posto del nome completo.
Website Flags
Percorso:
language_flags/general/website_flag_configScopo:
Configurazione delle bandiere che indirizzano ad altri websites nella stessa istanza Magento.
Come funziona
- il clic non esegue il
store switch postnativo; - la voce viene renderizzata come un normale link al base URL del website di destinazione;
- il website corrente non viene aggiunto come opzione separata.
Colonne del modulo
Website
Seleziona un website Magento dall’elenco.
Significato:
- definisce il website di destinazione per la voce;
- serve a recuperare l’indirizzo base dello storefront di destinazione.
Flag File
Funziona come in Store View Flags.
Label
Etichetta completa visualizzata sul frontend.
Se resta vuota:
- il modulo userà il nome del website.
Short Label
Etichetta abbreviata, ad es.:
UKDEFR
Se resta vuota:
- il modulo userà il codice del website in maiuscolo.
Custom URL Flags
Percorso:
language_flags/general/custom_url_flag_configScopo:
Configurazione delle bandiere che indirizzano a URL qualsiasi, ad es. a un’altra istanza Magento o a un negozio esterno.
Colonne del modulo
URL
Indirizzo di destinazione del link.
Esempi:
https://example.de/https://en.example.com/https://shop.example.cz/
Significato:
- la voce viene renderizzata come un normale link
href; - non utilizza il meccanismo nativo di store switch Magento.
Flag File
Funziona come nelle altre tabelle.
Label
Etichetta completa visualizzata sul frontend.
Se resta vuota:
- il modulo proverà a usare l’host dall’URL.
Short Label
Etichetta abbreviata per la variante compatta.
Se resta vuota:
- il modulo creerà una sigla in base all’host;
- se non è possibile, userà il valore
URL.
Preparazione dei file delle bandiere
Posizione consigliata:
pub/media/language_flags/Formati consigliati:
svgpng
Esempi di nomi file:
pl.svgen.svgde.svgfr.svgFlusso di configurazione di base
- Abilita il modulo tramite
Enable Module. - Decidi se vuoi sostituire lo switcher nativo di Magento.
- Imposta
Native Display Mode. - Aggiungi i file delle bandiere a
pub/media/language_flags/. - Compila
Store View Flags. - Aggiungi voci opzionali in
Website Flags. - Aggiungi voci opzionali in
Custom URL Flags. - Salva la configurazione e svuota la cache.
Comandi CLI utili
bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush