Module Language Flags pour 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
Description / Module Language Flags pour Magento 2
MAGENTO 2 · PLUSIEURS MARCHÉS · NAVIGATION
Aidez le client à choisir la bonne langue et le bon marché.
Kowal Language Flags
Remplacez le sélecteur standard par une liste claire de drapeaux et de libellés. Regroupez les vues de boutique, d'autres websites et des adresses externes dans un seul point de navigation.
Store Views · Websites et URL · Dropdown ou inline
COMMENT ÇA FONCTIONNE EN PRATIQUE
01 · Vous choisissez les destinations
Vous configurez les vues de boutique, les websites ou vos propres adresses.
02 · Vous ajoutez des drapeaux et des libellés
Vous utilisez les icônes prêtes à l'emploi ou vos propres fichiers.
03 · Le client choisit une version
Le sélecteur redirige vers la langue ou le marché choisi.
Quels avantages pour votre boutique ?
Découvrez les fonctionnalités, les usages et les paramètres du module.
Un seul switcher pour de nombreux scénarios linguistiques
Kowal_LanguageFlags résout le problème du sélecteur de langue peu lisible dans Magento 2. Au lieu d'une liste standard de codes store view, le client voit un switcher intuitif avec des drapeaux, des noms de langues et la possibilité de naviguer non seulement entre les store views, mais aussi entre les websites et les boutiques externes.
Cette solution est particulièrement utile lorsque :
- une boutique prend en charge plusieurs versions linguistiques ;
- différents marchés fonctionnent comme des websites distincts ;
- une partie du trafic doit être redirigée vers une autre instance Magento ;
- un seul switcher cohérent est nécessaire pour différents types d'adresses de destination.
Ce que le module apporte
- des drapeaux pour les store views ;
- des drapeaux pour d'autres websites dans la même instance Magento ;
- des drapeaux pour n'importe quelle URL, par exemple vers une boutique Magento distincte ;
- des libellés personnalisés et des désignations abrégées des langues ;
- deux variantes d'affichage :
dropdownetinline; - la prise en charge du switcher Magento natif et du widget.
Avantages business
- identification plus rapide de la version linguistique par le client ;
- moins d'erreurs lors du choix du marché ou de la langue ;
- présentation plus professionnelle d'une boutique multilingue ;
- possibilité de relier facilement plusieurs storefronts dans un seul point de navigation ;
- mise en place plus rapide que la création d'un composant dédié à partir de zéro.
Avantages techniques
- configuration depuis le panneau d'administration ;
- compatibilité avec le mécanisme natif Magento pour le store view switch ;
- une seule configuration pour le switcher natif et le widget ;
- jeu par défaut de drapeaux SVG prêts à l'emploi copié dans
pub/media/language_flags/pendant l'installation ; - pas besoin de créer une table de données distincte au démarrage ;
- possibilité de déploiement via Composer.
Jeu de drapeaux prêt à l'emploi
Le module inclut un jeu d'icônes SVG prêtes à l'emploi 24x18, qui peuvent être automatiquement copiées dans pub/media/language_flags/ pendant bin/magento setup:upgrade.
Drapeaux disponibles :
Drapeaux 1–10
atAutrichebeBelgiquebgBulgariecyChypreczTchéquiedeAllemagnedkDanemarkeeEstonieesEspagneeuUnion européenne
Drapeaux 11–20
fiFinlandefrFrancegrGrècehrCroatiehuHongrieieIrlandeitItalieltLituanieluLuxembourglvLettonie
Drapeaux 21–30
mtMaltenlPays-BasplPologneptPortugalroRoumanieseSuèdesiSlovénieskSlovaquieukRoyaume-UniusÉtats-Unis
Pour qui
Le module est destiné aux :
- boutiques Magento 2 présentes sur plusieurs marchés ;
- installations avec plusieurs store views et websites ;
- projets dans lesquels certaines versions linguistiques fonctionnent en dehors du storefront principal ;
- équipes qui souhaitent mettre en place un switcher lisible sans modifier le core Magento.
Exemples d'utilisation
Un seul Magento, plusieurs store views
La boutique dispose des versions :
PLENDE
Chacune d'elles peut avoir son propre drapeau et son propre libellé.
Un seul Magento, plusieurs websites
La boutique utilise des websites distincts pour différents pays, par exemple :
- Pologne
- Allemagne
- France
Le module permet d'afficher ces websites dans le même switcher que les store views locales.
Storefronts distribués
Certains marchés fonctionnent dans une autre instance Magento ou sous un autre domaine. Dans ce cas, Custom URL Flags permettent de les intégrer au sélecteur commun.
Résultat du déploiement
Le client bénéficie d'un switcher unique et cohérent pour la langue et le marché, tandis que l'administrateur peut le gérer depuis la configuration Magento sans créer de composants frontend supplémentaires.
Apparence et choix des drapeaux depuis le panneau
Dans Stores → Configuration → Kowal → Language Flags, vous activez le module ainsi que le remplacement optionnel du sélecteur natif. Vous définissez le mode dropdown ou inline, la visibilité des noms de langues, l'espacement entre les drapeaux et l'échelle des icônes. Les noms restent accessibles aux lecteurs d'écran même après le masquage des libellés visibles.
Vous choisissez les images depuis le sélecteur dans pub/media/language_flags/ et configurez Store View Flags, Website Flags et Custom URL Flags. Vous pouvez également insérer le switcher sous forme de widget Language Flags Switcher dans une page ou un bloc CMS.
Exigences et mode de navigation entre les boutiques
Le package testé nécessite PHP ^8.1 || ^8.2 || ^8.3 ainsi que les modules Magento définis dans Composer. Store View utilise la commutation native Magento. Website et l'URL personnalisée mènent directement à l'adresse indiquée.
Le choix des drapeaux, des libellés et des adresses permet d'adapter la navigation aux marchés. Le module ne traduit pas le contenu des produits ; vous préparez les versions linguistiques dans la configuration et les données de la boutique.
Installation via Composer
Package : kowal/module-language-flags ; module : Kowal_LanguageFlags. Après avoir configuré l'accès au dépôt Kowal, installez le package, activez le module, effectuez la mise à jour Magento et videz le cache. Pour le mode production, prévoyez la compilation et le déploiement du contenu statique conformément au processus de la boutique.
De la configuration au résultat
1. Vous choisissez les destinations
Vous configurez les vues de boutique, les websites ou vos propres adresses.
2. Vous ajoutez des drapeaux et des libellés
Vous utilisez les icônes prêtes à l'emploi ou vos propres fichiers.
3. Le client choisit une version
Le sélecteur redirige vers la langue ou le marché choisi.
Navigation commune pour plusieurs storefronts
Exemple : la version polonaise fonctionne comme Store View, le marché allemand comme website distinct et la boutique britannique sous un autre domaine.
Vous pouvez afficher les trois destinations dans un seul sélecteur. Store View utilise le processus natif Magento, tandis que les websites et les URL personnalisées fonctionnent comme des liens directs.
Structurez le choix de la version linguistique et du marché
Vous souhaitez adapter le module à votre boutique ? Demandez le déploiement de Kowal Language Flags et discutez de la configuration ou des extensions nécessaires.
Caractéristiques
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Compatibilité avec le modèle | Hyvä, Luma / Blank, KOWAL |
Notice d'installation du module
# Vous recevrez les données d'accès, e-mail client et token de licence, par e-mail après l'achat.
# Elles sont également disponibles dans l'espace client après connexion sur kowal.store.
# Remplacez TWOJ_EMAIL_KLIENTA par l'adresse e-mail du compte et TWOJ_TOKEN par le token reçu.
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
Guide d'installation et de configuration du module Magento 2 Language Flags
Installation
Installation via Composer
Vous recevrez les données d'accès au dépôt Composer, adresse e-mail client et token de licence, par e-mail après l'achat. Elles sont également disponibles dans l'espace client après connexion sur kowal.store. Remplacez TWOJ_EMAIL_KLIENTA par l'adresse e-mail de votre compte et TWOJ_TOKEN par le token reçu. Exécutez les commandes dans le répertoire racine de 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:flushCommandes supplémentaires pour le production mode
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushEmplacement de la configuration
Panneau d'administration :
Stores > Configuration > Kowal > Language FlagsWidget pour l'éditeur CMS
Le module fournit le widget :
Language Flags SwitcherIl peut être inséré dans :
Content > BlocksContent > Pages
Chemin dans l'éditeur :
Edit > Insert Widget > Language Flags SwitcherLe widget prend en charge :
- le mode
dropdownouinline; - 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 contrôlent le fonctionnement du module.
Enable Module
Chemin :
language_flags/general/enabledSignification :
Yesactive le module ;Nodésactive le module sur le frontend.
Replace Native Store View Switcher
Chemin :
language_flags/general/native_enabledSignification :
Yesremplace le switcher Magento natif par une version avec drapeaux ;Nolaisse le switcher natif inchangé.
Native Display Mode
Chemin :
language_flags/general/native_display_modeOptions disponibles :
dropdowninline
Signification :
dropdownaffiche l'élément actuel et une liste déroulante des autres ;inlineaffiche tous les drapeaux immédiatement sur une seule ligne.
Show Language Names
Chemin :
language_flags/general/show_labelsSignification :
Yesaffiche les noms de langues à côté des drapeaux ;Nomasque les noms dans la vue principale, mais les conserve pour l'accessibilité.
Fallback to Store View Name
Chemin :
language_flags/general/fallback_to_store_nameSignification :
Yesutilise le nom du store view lorsqueLabeln'a pas été renseigné ;Noutilise le code du store view en majuscules.
Inline Flag Gap (px)
Chemin :
language_flags/general/inline_gapSignification :
- définit l'espacement entre les éléments du switcher en mode
inline; - la valeur est exprimée en pixels ;
- la valeur par défaut est
8.
Icon Scale (%)
Chemin :
language_flags/general/icon_scale_percentSignification :
100conserve les dimensions d'origine de l'image ;- une valeur plus basse 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 jeux d'entrées distincts :
Store View FlagsWebsite FlagsCustom 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_configObjectif :
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 :
- associe un drapeau à un store view précis ;
- utilise le mécanisme natif de changement de store view Magento.
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.svgoulanguage_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 :
PolskiEnglishDeutsch
Signification :
- est affiché à côté du drapeau lorsque
Show Language Namesest activé ; - sert également de texte d'aide pour l'accessibilité.
Short Label
Libellé abrégé, par exemple :
PLENDE
Signification :
- est utilisé dans une vue plus compacte ;
- peut être utilisé à la place du nom complet.
Website Flags
Chemin :
language_flags/general/website_flag_configObjectif :
Configuration des drapeaux redirigeant vers d'autres websites dans la même instance Magento.
Fonctionnement
- le clic n'exécute pas le
store switch postnatif ; - l'entrée est rendue comme un lien standard 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 :
UKDEFR
S'il reste vide :
- le module utilisera le code du website en majuscules.
Custom URL Flags
Chemin :
language_flags/general/custom_url_flag_configObjectif :
Configuration des drapeaux redirigeant vers n'importe quelles adresses URL, par exemple vers une autre instance Magento ou une boutique externe.
Colonnes du formulaire
URL
Adresse cible du lien.
Exemples :
https://example.de/https://en.example.com/https://shop.example.cz/
Signification :
- l'entrée est rendue comme un lien standard
href; - elle n'utilise pas le mécanisme natif store switch de Magento.
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 essaiera 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 ce n'est pas possible, il utilisera la valeur
URL.
Préparation des fichiers de drapeaux
Emplacement recommandé :
pub/media/language_flags/Formats recommandés :
svgpng
Exemples de noms de fichiers :
pl.svgen.svgde.svgfr.svgProcessus de configuration de base
- Activez le module via
Enable Module. - Décidez si vous souhaitez remplacer le switcher Magento natif.
- Définissez
Native Display Mode. - Ajoutez les fichiers de drapeaux dans
pub/media/language_flags/. - Renseignez
Store View Flags. - Ajoutez des entrées optionnelles dans
Website Flags. - Ajoutez des entrées optionnelles dans
Custom URL Flags. - Enregistrez la configuration et videz le cache.
Commandes CLI utiles
bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush