# 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 aver effettuato l'accesso su 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 per l'installazione e la 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 aver effettuato l'accesso su 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: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 di amministrazione:

Stores > Configuration > Kowal > Language Flags

Widget per l'editor CMS

Il modulo mette a disposizione il widget:

Language Flags Switcher

Può essere inserito in:

• Content > Blocks
• Content > Pages

Percorso nell'editor:

Edit > Insert Widget > Language Flags Switcher

Il widget supporta:

• modalità dropdown o inline;
• attivazione o nascondimento dei nomi delle lingue;
• classe CSS aggiuntiva.

Flag predefinite

Durante bin/magento setup:upgrade il modulo copia i file SVG predefiniti da:

view/frontend/web/images/flags/

nella directory:

pub/media/language_flags/

Vengono copiati solo i file mancanti, senza sovrascrivere le flag già 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 di Magento con la versione con flag;
• No lascia invariato lo switcher nativo.

Native Display Mode

Percorso:

language_flags/general/native_display_mode

Opzioni disponibili:

• dropdown
• inline

Significato:

• dropdown mostra l'elemento corrente e un elenco a discesa degli altri;
• inline mostra subito tutte le flag su un'unica riga.

Show Language Names

Percorso:

language_flags/general/show_labels

Significato:

• Yes mostra i nomi delle lingue accanto alle flag;
• No nasconde i nomi nella vista principale, ma li lascia disponibili per l'accessibilità.

Fallback to Store View Name

Percorso:

language_flags/general/fallback_to_store_name

Significato:

• Yes usa il nome della store view quando Label non è stato compilato;
• No usa il codice della store view in lettere maiuscole.

Inline Flag Gap (px)

Percorso:

language_flags/general/inline_gap

Significato:

• imposta la distanza tra gli elementi dello switcher in modalità inline;
• il valore è espresso in pixel;
• il valore predefinito è 8.

Icon Scale (%)

Percorso:

language_flags/general/icon_scale_percent

Significato:

• 100 mantiene le dimensioni originali dell'immagine;
• un valore più basso riduce proporzionalmente larghezza e altezza;
• scala le flag in entrambe le modalità di rendering.

Configurazione delle tabelle con le flag

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 set di elementi dello switcher.

Store View Flags

Percorso:

language_flags/general/flag_config

Scopo:

Configurazione delle flag per le store view gestite dal meccanismo nativo di Magento.

Colonne del modulo

Store Code

Seleziona la store view dall'elenco di Magento.

Significato:

• assegna la flag a una store view specifica;
• utilizza il meccanismo nativo di Magento per il cambio della store view.

Flag File

Percorso del file della flag selezionato tramite il file picker integrato.

Significato:

• definisce l'immagine visualizzata sul frontend;
• può essere salvato come pl.svg o language_flags/pl.svg;
• i percorsi relativi vengono risolti a partire dalla directory:

pub/media/language_flags/

Label

Nome completo della lingua o del mercato, ad esempio:

• Polski
• English
• Deutsch

Significato:

• viene mostrato accanto alla flag quando Show Language Names è attivato;
• funge anche da testo di supporto per l'accessibilità.

Short Label

Etichetta abbreviata, ad esempio:

• PL
• EN
• DE

Significato:

• viene utilizzata in una vista più compatta;
• può essere usata al posto del nome completo.

Website Flags

Percorso:

language_flags/general/website_flag_config

Scopo:

Configurazione delle flag che indirizzano ad altri website nella stessa istanza Magento.

Come funziona

• il clic non esegue il store switch post nativo;
• 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 per recuperare l'indirizzo base dello storefront di destinazione.

Flag File

Funziona come in Store View Flags.

Label

Etichetta completa visualizzata sul frontend.

Se rimane vuota:

• il modulo userà il nome del website.

Short Label

Etichetta abbreviata, ad esempio:

• UK
• DE
• FR

Se rimane vuota:

• il modulo userà il codice del website in lettere maiuscole.

Custom URL Flags

Percorso:

language_flags/general/custom_url_flag_config

Scopo:

Configurazione delle flag che indirizzano a qualsiasi URL, ad esempio a un'altra istanza Magento o a uno store 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 Magento per il cambio store.

Flag File

Funziona come nelle altre tabelle.

Label

Etichetta completa visualizzata sul frontend.

Se rimane vuota:

• il modulo proverà a usare l'host dall'URL.

Short Label

Etichetta abbreviata per la variante compatta.

Se rimane vuota:

• il modulo creerà un'abbreviazione sulla base dell'host;
• se non è possibile, userà il valore URL.

Preparazione dei file delle flag

Posizione consigliata:

pub/media/language_flags/

Formati consigliati:

• svg
• png

Esempi di nomi file:

pl.svgen.svgde.svgfr.svg

Flusso di configurazione di base

1. Attiva il modulo tramite Enable Module.
2. Decidi se vuoi sostituire lo switcher nativo di Magento.
3. Imposta Native Display Mode.
4. Aggiungi i file delle flag in pub/media/language_flags/.
5. Compila Store View Flags.
6. Aggiungi voci opzionali in Website Flags.
7. Aggiungi 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