Language Flags Modul für Magento 2
- SKU
- M2-FLAGS
Beschreibung / Language Flags Modul für Magento 2
MAGENTO 2 · MEHRERE MÄRKTE · NAVIGATION
Helfen Sie Kunden, die richtige Sprache und den passenden Markt auszuwählen.
Kowal Language Flags
Ersetzen Sie den Standard-Umschalter durch eine übersichtliche Liste mit Flaggen und Labels. Verbinden Sie Store Views, andere Websites und externe Adressen an einer zentralen Navigationsstelle.
Store Views · Websites und URL · Dropdown oder Inline
SO FUNKTIONIERT ES IN DER PRAXIS
01 · Ziele auswählen
Sie konfigurieren Store Views, Websites oder eigene Adressen.
02 · Flaggen und Labels hinzufügen
Sie verwenden fertige Icons oder eigene Dateien.
03 · Kunde wählt die Version
Der Umschalter führt zur gewählten Sprache oder zum gewählten Markt.
Was gewinnt Ihr Shop?
Lernen Sie Funktionen, Einsatzmöglichkeiten und Einstellungen des Moduls kennen.
Ein Umschalter für viele Sprachszenarien
Kowal_LanguageFlags löst das Problem eines wenig übersichtlichen Sprachumschalters in Magento 2. Statt einer Standardliste mit Store-View-Codes sieht der Kunde einen intuitiven Umschalter mit Flaggen, Sprachnamen und der Möglichkeit, nicht nur zwischen Store Views, sondern auch zwischen Websites und externen Shops zu wechseln.
Diese Lösung ist besonders nützlich, wenn:
- ein Shop mehrere Sprachversionen unterstützt;
- verschiedene Märkte als separate Websites betrieben werden;
- ein Teil des Traffics zu einer anderen Magento-Instanz geleitet werden soll;
- ein einheitlicher Umschalter für verschiedene Zieladressentypen benötigt wird.
Was das Modul bietet
- Flaggen für Store Views;
- Flaggen für andere Websites in derselben Magento-Instanz;
- Flaggen für beliebige URLs, z. B. zu einem separaten Magento-Shop;
- eigene Labels und gekürzte Sprachkennzeichnungen;
- zwei Darstellungsvarianten:
dropdownundinline; - Unterstützung für den nativen Magento-Umschalter und ein Widget.
Geschäftliche Vorteile
- schnelleres Erkennen der Sprachversion durch den Kunden;
- weniger Fehler bei der Auswahl von Markt oder Sprache;
- professionellere Präsentation eines mehrsprachigen Shops;
- Möglichkeit, mehrere Storefronts komfortabel an einem Navigationspunkt zu verbinden;
- kürzerer Weg zur Implementierung als beim Aufbau einer dedizierten Komponente von Grund auf.
Technische Vorteile
- Konfiguration über das Admin-Panel;
- Kompatibilität mit dem nativen Magento-Mechanismus für den Store View Switch;
- eine Konfiguration für den nativen Umschalter und das Widget;
- standardmäßiges Set fertiger SVG-Flaggen, das während der Installation nach
pub/media/language_flags/kopiert wird; - zu Beginn keine Notwendigkeit, eine separate Datentabelle zu erstellen;
- Implementierung über Composer möglich.
Fertiges Flaggen-Set
Das Modul enthält ein Set fertiger SVG-Icons 24x18, die während bin/magento setup:upgrade automatisch nach pub/media/language_flags/ kopiert werden können.
Verfügbare Flaggen:
Flaggen 1–10
atÖsterreichbeBelgienbgBulgariencyZypernczTschechiendeDeutschlanddkDänemarkeeEstlandesSpanieneuEuropäische Union
Flaggen 11–20
fiFinnlandfrFrankreichgrGriechenlandhrKroatienhuUngarnieIrlanditItalienltLitauenluLuxemburglvLettland
Flaggen 21–30
mtMaltanlNiederlandeplPolenptPortugalroRumänienseSchwedensiSlowenienskSlowakeiukGroßbritannienusVereinigte Staaten
Für wen
Das Modul ist vorgesehen für:
- Magento 2 Shops, die auf mehreren Märkten tätig sind;
- Installationen mit mehreren Store Views und Websites;
- Projekte, bei denen ein Teil der Sprachversionen außerhalb der Haupt-Storefront betrieben wird;
- Teams, die einen übersichtlichen Umschalter implementieren möchten, ohne den Magento-Core umzubauen.
Beispielhafte Anwendungen
Ein Magento, viele Store Views
Der Shop verfügt über Versionen:
PLENDE
Jeder Version kann eine eigene Flagge und ein eigenes Label zugewiesen werden.
Ein Magento, viele Websites
Der Shop nutzt separate Websites für verschiedene Länder, z. B.:
- Polen
- Deutschland
- Frankreich
Das Modul ermöglicht es, diese Websites im selben Umschalter wie lokale Store Views anzuzeigen.
Verteilte Storefronts
Ein Teil der Märkte läuft in einer anderen Magento-Instanz oder unter einer anderen Domain. In dieser Situation ermöglichen Custom URL Flags, sie in einen gemeinsamen Umschalter einzubinden.
Ergebnis der Implementierung
Der Kunde erhält einen einheitlichen Umschalter für Sprache und Markt, und der Administrator kann ihn über die Magento-Konfiguration verwalten, ohne zusätzliche Frontend-Komponenten zu erstellen.
Darstellung und Flaggenauswahl im Panel
Unter Stores → Configuration → Kowal → Language Flags aktivieren Sie das Modul sowie optional den Austausch des nativen Umschalters. Sie legen den Modus dropdown oder inline, die Sichtbarkeit der Sprachnamen, den Abstand zwischen den Flaggen und die Skalierung der Icons fest. Die Namen bleiben auch nach dem Ausblenden sichtbarer Labels für Screenreader verfügbar.
Sie wählen Bilder aus dem Picker in pub/media/language_flags/ aus und konfigurieren Store View Flags, Website Flags sowie Custom URL Flags. Den Umschalter können Sie außerdem als Widget Language Flags Switcher in eine Seite oder einen CMS-Block einfügen.
Anforderungen und Wechsel zwischen Shops
Das geprüfte Paket erfordert PHP ^8.1 || ^8.2 || ^8.3 sowie die in Composer definierten Magento-Module. Store View nutzt den nativen Magento-Umschaltmechanismus. Website und eigene URL führen direkt zur angegebenen Adresse.
Die Auswahl von Flaggen, Labels und Adressen ermöglicht es, die Navigation an die Märkte anzupassen. Das Modul übersetzt keine Produktinhalte; Sprachversionen bereiten Sie in der Konfiguration und in den Shopdaten vor.
Installation über Composer
Paket: kowal/module-language-flags; Modul: Kowal_LanguageFlags. Nachdem Sie den Zugriff auf das Kowal-Repository konfiguriert haben, installieren Sie das Paket, aktivieren das Modul, führen das Magento-Upgrade aus und leeren den Cache. Für den Produktionsmodus berücksichtigen Sie die Kompilierung und das Deployment statischer Inhalte gemäß dem Prozess Ihres Shops.
Von der Konfiguration zum Ergebnis
1. Ziele auswählen
Sie konfigurieren Store Views, Websites oder eigene Adressen.
2. Flaggen und Labels hinzufügen
Sie verwenden fertige Icons oder eigene Dateien.
3. Kunde wählt die Version
Der Umschalter führt zur gewählten Sprache oder zum gewählten Markt.
Gemeinsame Navigation für viele Storefronts
Beispiel: Die polnische Version läuft als Store View, der deutsche Markt als separate Website und der britische Shop unter einer anderen Domain.
Alle drei Ziele können Sie in einem Umschalter anzeigen. Store View verwendet den nativen Magento-Prozess, während Websites und eigene URLs als direkte Links funktionieren.
Ordnen Sie die Auswahl von Sprachversion und Markt
Möchten Sie das Modul an Ihren Shop anpassen? Fragen Sie nach der Implementierung von Kowal Language Flags und besprechen Sie die Konfiguration oder benötigte Erweiterungen.
Weitere Informationen
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Übereinstimmung mit der Vorlage | Gut, Luma / Leer, KOWAL |
Installationsanleitung für das Modul
# Die Zugangsdaten E-Mail des Kunden und Lizenz-Token erhalten Sie nach dem Kauf per E-Mail.
# Sie sind auch nach dem Login im Kundenpanel auf kowal.store verfügbar.
# Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse des Kontos und TWOJ_TOKEN durch den erhaltenen Token.
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
Installations- und Konfigurationsanleitung für das Magento 2 Language Flags Modul
Installation
Installation über Composer
Die Zugangsdaten zum Composer-Repository E-Mail-Adresse des Kunden und Lizenz-Token erhalten Sie nach dem Kauf per E-Mail. Sie sind auch nach dem Login im Kundenpanel auf kowal.store verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
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:flushZusätzliche Befehle für den production mode
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushKonfigurationspfad
Admin-Panel:
Stores > Configuration > Kowal > Language FlagsWidget für den CMS-Editor
Das Modul stellt ein Widget bereit:
Language Flags SwitcherEs kann eingefügt werden in:
Content > BlocksContent > Pages
Pfad im Editor:
Edit > Insert Widget > Language Flags SwitcherDas Widget unterstützt:
- den Modus
dropdownoderinline; - das Einblenden oder Ausblenden von Sprachnamen;
- eine zusätzliche CSS-Klasse.
Standardflaggen
Während bin/magento setup:upgrade kopiert das Modul die Standard-SVG-Dateien aus:
view/frontend/web/images/flags/in das Verzeichnis:
pub/media/language_flags/Es werden nur fehlende Dateien kopiert, ohne bereits vorhandene Flaggen zu überschreiben.
Allgemeine Konfiguration
Der Abschnitt General Settings enthält Felder, die die Funktionsweise des Moduls steuern.
Enable Module
Pfad:
language_flags/general/enabledBedeutung:
Yesaktiviert das Modul;Nodeaktiviert das Modul im Frontend.
Replace Native Store View Switcher
Pfad:
language_flags/general/native_enabledBedeutung:
Yesersetzt den nativen Magento-Umschalter durch eine Version mit Flaggen;Nobelässt den nativen Umschalter unverändert.
Native Display Mode
Pfad:
language_flags/general/native_display_modeVerfügbare Optionen:
dropdowninline
Bedeutung:
dropdownzeigt die aktuelle Position und eine ausklappbare Liste der übrigen;inlinezeigt alle Flaggen sofort in einer Zeile.
Show Language Names
Pfad:
language_flags/general/show_labelsBedeutung:
Yeszeigt Sprachnamen neben den Flaggen;Noblendet die Namen in der Hauptansicht aus, lässt sie aber für die Barrierefreiheit verfügbar.
Fallback to Store View Name
Pfad:
language_flags/general/fallback_to_store_nameBedeutung:
Yesverwendet den Namen des Store Views, wennLabelnicht ausgefüllt wurde;Noverwendet den Store-View-Code in Großbuchstaben.
Inline Flag Gap (px)
Pfad:
language_flags/general/inline_gapBedeutung:
- legt den Abstand zwischen den Elementen des Umschalters im Modus
inlinefest; - der Wert wird in Pixeln berechnet;
- der Standardwert ist
8.
Icon Scale (%)
Pfad:
language_flags/general/icon_scale_percentBedeutung:
100behält die ursprünglichen Abmessungen des Bildes bei;- ein niedrigerer Wert reduziert Breite und Höhe proportional;
- skaliert die Flaggen in beiden Rendering-Modi.
Konfiguration der Flaggen-Tabellen
Das Modul unterstützt drei separate Eintragsgruppen:
Store View FlagsWebsite FlagsCustom URL Flags
Im Frontend werden die Einträge zu einem gemeinsamen Set von Umschalter-Elementen zusammengeführt.
Store View Flags
Pfad:
language_flags/general/flag_configZweck:
Konfiguration von Flaggen für Store Views, die vom nativen Magento-Mechanismus unterstützt werden.
Formularspalten
Store Code
Wählt einen Store View aus der Magento-Liste aus.
Bedeutung:
- weist einem konkreten Store View eine Flagge zu;
- nutzt den nativen Magento-Mechanismus zum Wechseln des Store Views.
Flag File
Pfad zur Flaggen-Datei, ausgewählt über den integrierten Dateipicker.
Bedeutung:
- definiert das Bild, das im Frontend angezeigt wird;
- kann als
pl.svgoderlanguage_flags/pl.svggespeichert werden; - relative Pfade werden aus dem Verzeichnis aufgelöst:
pub/media/language_flags/Label
Vollständiger Name der Sprache oder des Markts, z. B.:
PolskiEnglishDeutsch
Bedeutung:
- wird neben der Flagge angezeigt, wenn
Show Language Namesaktiviert ist; - dient außerdem als Hilfstext für die Barrierefreiheit.
Short Label
Gekürztes Label, z. B.:
PLENDE
Bedeutung:
- wird in einer kompakteren Ansicht verwendet;
- kann anstelle des vollständigen Namens verwendet werden.
Website Flags
Pfad:
language_flags/general/website_flag_configZweck:
Konfiguration von Flaggen, die zu anderen Websites in derselben Magento-Instanz führen.
So funktioniert es
- ein Klick führt keinen nativen
store switch postaus; - der Eintrag wird als normaler Link zur Base URL der Ziel-Website gerendert;
- die aktuelle Website wird nicht als separate Option hinzugefügt.
Formularspalten
Website
Wählt eine Magento-Website aus der Liste aus.
Bedeutung:
- definiert die Ziel-Website für den Eintrag;
- dient zum Abrufen der Basisadresse der Ziel-Storefront.
Flag File
Funktioniert genauso wie bei Store View Flags.
Label
Vollständiges Label, das im Frontend angezeigt wird.
Wenn es leer bleibt:
- verwendet das Modul den Namen der Website.
Short Label
Gekürztes Label, z. B.:
UKDEFR
Wenn es leer bleibt:
- verwendet das Modul den Website-Code in Großbuchstaben.
Custom URL Flags
Pfad:
language_flags/general/custom_url_flag_configZweck:
Konfiguration von Flaggen, die zu beliebigen URLs führen, z. B. zu einer anderen Magento-Instanz oder einem externen Shop.
Formularspalten
URL
Zieladresse des Links.
Beispiele:
https://example.de/https://en.example.com/https://shop.example.cz/
Bedeutung:
- der Eintrag wird als normaler Link
hrefgerendert; - verwendet nicht den nativen Store-Switch-Mechanismus von Magento.
Flag File
Funktioniert genauso wie in den übrigen Tabellen.
Label
Vollständiges Label, das im Frontend angezeigt wird.
Wenn es leer bleibt:
- versucht das Modul, den Host aus der URL zu verwenden.
Short Label
Gekürztes Label für die kompakte Variante.
Wenn es leer bleibt:
- erstellt das Modul eine Abkürzung auf Basis des Hosts;
- wenn dies nicht möglich ist, verwendet es den Wert
URL.
Vorbereitung der Flaggen-Dateien
Empfohlener Speicherort:
pub/media/language_flags/Empfohlene Formate:
svgpng
Beispiele für Dateinamen:
pl.svgen.svgde.svgfr.svgGrundlegender Konfigurationsablauf
- Aktivieren Sie das Modul über
Enable Module. - Entscheiden Sie, ob Sie den nativen Magento-Umschalter ersetzen möchten.
- Legen Sie
Native Display Modefest. - Fügen Sie Flaggen-Dateien zu
pub/media/language_flags/hinzu. - Füllen Sie
Store View Flagsaus. - Fügen Sie optionale Einträge in
Website Flagshinzu. - Fügen Sie optionale Einträge in
Custom URL Flagshinzu. - Speichern Sie die Konfiguration und leeren Sie den Cache.
Nützliche CLI-Befehle
bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush