Guida all installazione e alla configurazione del modulo Magento 2 Language Flags

Installazione

Installazione tramite Composer

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

Installazione dal repository 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

Comandi aggiuntivi per la production mode

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

Posizione della configurazione

Pannello amministrativo:

Stores > Configuration > Kowal > Language Flags

Widget per l editor CMS

Il modulo mette a disposizione il widget:

Language Flags Switcher

Puo essere inserito in:

• Content > Blocks
• Content > Pages

Percorso nell editor:

Edit > Insert Widget > Language Flags Switcher

Il widget supporta:

• modalita dropdown oppure inline;
• attivazione 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 cartella:

pub/media/language_flags/

Vengono copiati solo i file mancanti, senza sovrascrivere le bandiere gia esistenti.

Configurazione generale

La sezione General Settings contiene i campi che controllano il funzionamento del modulo.

Enable Module

Percorso:

language_flags/general/enabled

Significato:

• Yes attiva il modulo;
• No disattiva il modulo sul frontend.

Replace Native Store View Switcher

Percorso:

language_flags/general/native_enabled

Significato:

• Yes sostituisce lo switcher nativo Magento con la versione con bandiere;
• No lascia invariato lo switcher nativo.

Native Display Mode

Percorso:

language_flags/general/native_display_mode

Opzioni disponibili:

• dropdown
• inline

Significato:

• dropdown mostra la voce attuale e un elenco a discesa delle altre;
• inline mostra subito tutte le bandiere su un unica riga.

Show Language Names

Percorso:

language_flags/general/show_labels

Significato:

• Yes mostra i nomi delle lingue accanto alle bandiere;
• No nasconde i nomi nella vista principale, ma li mantiene per l accessibilita.

Fallback to Store View Name

Percorso:

language_flags/general/fallback_to_store_name

Significato:

• Yes usa il nome della store view quando Label non e stato compilato;
• No usa il codice store view in maiuscolo.

Inline Flag Gap (px)

Percorso:

language_flags/general/inline_gap

Significato:

• imposta la spaziatura tra gli elementi dello switcher in modalita inline;
• il valore e espresso in pixel;
• il valore predefinito e 8.

Icon Scale (%)

Percorso:

language_flags/general/icon_scale_percent

Significato:

• 100 mantiene le dimensioni originali dell immagine;
• un valore inferiore riduce larghezza e altezza in proporzione;
• scala le bandiere in entrambe le modalita di rendering.

Configurazione delle tabelle con le bandiere

Il modulo supporta tre set separati di voci:

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

Sul frontend le voci vengono unite in un unico insieme di elementi dello switcher.

Store View Flags

Percorso:

language_flags/general/flag_config

Destinazione d uso:

Configurazione delle bandiere per le store views gestite dal meccanismo nativo Magento.

Colonne del modulo

Store Code

Seleziona la store view dall elenco Magento.

Significato:

• assegna una bandiera a una specifica store view;
• utilizza il meccanismo nativo Magento di cambio store view.

Flag File

Percorso del file della bandiera selezionato dal file picker integrato.

Significato:

• definisce l immagine visualizzata sul frontend;
• puo essere salvato come pl.svg oppure language_flags/pl.svg;
• i percorsi relativi vengono risolti dalla cartella:

pub/media/language_flags/

Label

Nome completo della lingua o del mercato, ad esempio:

• Polski
• English
• Deutsch

Significato:

• viene mostrato accanto alla bandiera quando Show Language Names e attivato;
• serve anche come testo di supporto per l accessibilita.

Short Label

Etichetta abbreviata, ad esempio:

• PL
• EN
• DE

Significato:

• viene utilizzata in una vista piu compatta;
• puo essere usata al posto del nome completo.

Website Flags

Percorso:

language_flags/general/website_flag_config

Destinazione d uso:

Configurazione delle bandiere che rimandano ad altri websites nella stessa istanza Magento.

Come funziona

• il clic non esegue il nativo store switch post;
• 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 il 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 allo stesso modo di Store View Flags.

Label

Etichetta completa visualizzata sul frontend.

Se lasciata vuota:

• il modulo usera il nome del website.

Short Label

Etichetta abbreviata, ad esempio:

• UK
• DE
• FR

Se lasciata vuota:

• il modulo usera il codice website in maiuscolo.

Custom URL Flags

Percorso:

language_flags/general/custom_url_flag_config

Destinazione d uso:

Configurazione delle bandiere che rimandano a qualsiasi indirizzo URL, ad esempio 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 Magento di store switch.

Flag File

Funziona allo stesso modo delle altre tabelle.

Label

Etichetta completa visualizzata sul frontend.

Se lasciata vuota:

• il modulo provera a usare l host dell URL.

Short Label

Etichetta abbreviata per la variante compatta.

Se lasciata vuota:

• il modulo costruira l abbreviazione in base all host;
• se cio non e possibile, usera il valore URL.

Preparazione dei file delle bandiere

Posizione consigliata:

pub/media/language_flags/

Formati consigliati:

• svg
• png

Esempi di nomi file:

pl.svgen.svgde.svgfr.svg

Procedura di configurazione di base

1. Attiva il modulo tramite Enable Module.
2. Decidi se vuoi sostituire lo switcher nativo Magento.
3. Imposta Native Display Mode.
4. Aggiungi i file delle bandiere in pub/media/language_flags/.
5. Compila Store View Flags.
6. Aggiungi eventuali voci opzionali in Website Flags.
7. Aggiungi eventuali voci opzionali in Custom URL Flags.
8. Salva la configurazione e svuota la cache.

Comandi CLI utili

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