Guide d’installation et de configuration du module Magento 2 Language Flags

Installation

Installation via Composer

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

Installation depuis le dépôt 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

Commandes supplémentaires pour le mode production

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

Emplacement de la configuration

Panneau d’administration :

Stores > Configuration > Kowal > Language Flags

Widget pour l’éditeur CMS

Le module met à disposition le widget suivant :

Language Flags Switcher

Il peut être inséré dans :

• Content > Blocks
• Content > Pages

Chemin dans l’éditeur :

Edit > Insert Widget > Language Flags Switcher

Le widget prend en charge :

• le mode dropdown ou inline ;
• l’affichage ou le masquage des noms de langues ;
• une classe CSS supplémentaire.

Drapeaux par défaut

Pendant bin/magento setup:upgrade, le module copie les fichiers SVG par défaut depuis :

view/frontend/web/images/flags/

vers le répertoire :

pub/media/language_flags/

Seuls les fichiers manquants sont copiés, sans écraser les drapeaux déjà existants.

Configuration générale

La section General Settings contient les champs qui pilotent le fonctionnement du module.

Enable Module

Chemin :

language_flags/general/enabled

Signification :

• Yes active le module ;
• No désactive le module sur le frontend.

Replace Native Store View Switcher

Chemin :

language_flags/general/native_enabled

Signification :

• Yes remplace le switcher natif Magento par une version avec drapeaux ;
• No laisse le switcher natif inchangé.

Native Display Mode

Chemin :

language_flags/general/native_display_mode

Options disponibles :

• dropdown
• inline

Signification :

• dropdown affiche l’élément actuel et une liste déroulante des autres ;
• inline affiche tous les drapeaux immédiatement sur une seule ligne.

Show Language Names

Chemin :

language_flags/general/show_labels

Signification :

• Yes affiche les noms des langues à côté des drapeaux ;
• No masque les noms dans la vue principale, mais les conserve pour l’accessibilité.

Fallback to Store View Name

Chemin :

language_flags/general/fallback_to_store_name

Signification :

• Yes utilise le nom du store view lorsque le Label n’a pas été renseigné ;
• No utilise le code du store view en lettres majuscules.

Inline Flag Gap (px)

Chemin :

language_flags/general/inline_gap

Signification :

• définit l’espacement entre les éléments du switcher en mode inline ;
• la valeur est calculée en pixels ;
• la valeur par défaut est 8.

Icon Scale (%)

Chemin :

language_flags/general/icon_scale_percent

Signification :

• 100 conserve les dimensions d’origine de l’image ;
• une valeur inférieure réduit proportionnellement la largeur et la hauteur ;
• met à l’échelle les drapeaux dans les deux modes de rendu.

Configuration des tableaux de drapeaux

Le module prend en charge trois ensembles d’entrées distincts :

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

Sur le frontend, les entrées sont fusionnées en un seul ensemble d’éléments du switcher.

Store View Flags

Chemin :

language_flags/general/flag_config

Utilisation :

Configuration des drapeaux pour les store views gérés par le mécanisme natif Magento.

Colonnes du formulaire

Store Code

Sélectionne un store view dans la liste Magento.

Signification :

• attribue un drapeau à un store view précis ;
• utilise le mécanisme natif Magento de changement de store view.

Flag File

Chemin vers le fichier du drapeau sélectionné depuis le sélecteur de fichiers intégré.

Signification :

• définit l’image affichée sur le frontend ;
• peut être enregistré sous la forme pl.svg ou language_flags/pl.svg ;
• les chemins relatifs sont résolus à partir du répertoire :

pub/media/language_flags/

Label

Nom complet de la langue ou du marché, par exemple :

• Polski
• English
• Deutsch

Signification :

• est affiché à côté du drapeau lorsque Show Language Names est activé ;
• sert également de texte d’aide pour l’accessibilité.

Short Label

Libellé abrégé, par exemple :

• PL
• EN
• DE

Signification :

• est utilisé dans une vue plus compacte ;
• peut être utilisé à la place du nom complet.

Website Flags

Chemin :

language_flags/general/website_flag_config

Utilisation :

Configuration des drapeaux pointant vers d’autres websites dans la même instance Magento.

Fonctionnement

• le clic n’exécute pas le store switch post natif ;
• l’entrée est rendue comme un lien classique vers la base URL du website cible ;
• le website actuel n’est pas ajouté comme option distincte.

Colonnes du formulaire

Website

Sélectionne un website Magento dans la liste.

Signification :

• définit le website cible pour l’entrée ;
• sert à récupérer l’adresse de base du storefront cible.

Flag File

Fonctionne de la même manière que dans Store View Flags.

Label

Libellé complet affiché sur le frontend.

S’il reste vide :

• le module utilisera le nom du website.

Short Label

Libellé abrégé, par exemple :

• UK
• DE
• FR

S’il reste vide :

• le module utilisera le code du website en lettres majuscules.

Custom URL Flags

Chemin :

language_flags/general/custom_url_flag_config

Utilisation :

Configuration des drapeaux pointant vers n’importe quelles URL, par exemple vers une autre instance Magento ou une boutique externe.

Colonnes du formulaire

URL

Adresse de destination du lien.

Exemples :

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

Signification :

• l’entrée est rendue comme un lien href classique ;
• n’utilise pas le mécanisme natif Magento de changement de store.

Flag File

Fonctionne de la même manière que dans les autres tableaux.

Label

Libellé complet affiché sur le frontend.

S’il reste vide :

• le module tentera d’utiliser l’hôte de l’URL.

Short Label

Libellé abrégé pour la variante compacte.

S’il reste vide :

• le module construira une abréviation à partir de l’hôte ;
• si cela est impossible, il utilisera la valeur URL.

Préparation des fichiers de drapeaux

Emplacement recommandé :

pub/media/language_flags/

Formats recommandés :

• svg
• png

Exemples de noms de fichiers :

pl.svgen.svgde.svgfr.svg

Processus de configuration de base

1. Activez le module via Enable Module.
2. Décidez si vous souhaitez remplacer le switcher natif Magento.
3. Définissez Native Display Mode.
4. Ajoutez les fichiers de drapeaux dans pub/media/language_flags/.
5. Complétez Store View Flags.
6. Ajoutez des entrées optionnelles dans Website Flags.
7. Ajoutez des entrées optionnelles dans Custom URL Flags.
8. Enregistrez la configuration et videz le cache.

Commandes CLI utiles

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