Anleitung zur Installation und Konfiguration des Magento 2 Language Flags Moduls

Installation

Installation über Composer

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

Installation aus dem Git-Repository

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

Zusätzliche Befehle für den Production Mode

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

Speicherort der Konfiguration

Administrationspanel:

Stores > Configuration > Kowal > Language Flags

Widget für den CMS-Editor

Das Modul stellt folgendes Widget bereit:

Language Flags Switcher

Es kann eingefügt werden in:

• Content > Blocks
• Content > Pages

Pfad im Editor:

Edit > Insert Widget > Language Flags Switcher

Das Widget unterstützt:

• den Modus dropdown oder inline;
• 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 zur Steuerung der Funktionsweise des Moduls.

Enable Module

Pfad:

language_flags/general/enabled

Bedeutung:

• Yes aktiviert das Modul;
• No deaktiviert das Modul im Frontend.

Replace Native Store View Switcher

Pfad:

language_flags/general/native_enabled

Bedeutung:

• Yes ersetzt den nativen Magento-Switcher durch eine Version mit Flaggen;
• No belässt den nativen Switcher unverändert.

Native Display Mode

Pfad:

language_flags/general/native_display_mode

Verfügbare Optionen:

• dropdown
• inline

Bedeutung:

• dropdown zeigt die aktuelle Position und eine ausklappbare Liste der übrigen an;
• inline zeigt alle Flaggen sofort in einer Zeile an.

Show Language Names

Pfad:

language_flags/general/show_labels

Bedeutung:

• Yes zeigt Sprachnamen neben den Flaggen an;
• No blendet die Namen in der Hauptansicht aus, lässt sie aber für die Barrierefreiheit bestehen.

Fallback to Store View Name

Pfad:

language_flags/general/fallback_to_store_name

Bedeutung:

• Yes verwendet den Store-View-Namen, wenn Label nicht ausgefüllt wurde;
• No verwendet den Store-View-Code in Großbuchstaben.

Inline Flag Gap (px)

Pfad:

language_flags/general/inline_gap

Bedeutung:

• legt den Abstand zwischen den Elementen des Switchers im Modus inline fest;
• der Wert wird in Pixeln berechnet;
• der Standardwert ist 8.

Icon Scale (%)

Pfad:

language_flags/general/icon_scale_percent

Bedeutung:

• 100 behält die Originalabmessungen des Bildes bei;
• ein niedrigerer Wert verkleinert Breite und Höhe proportional;
• skaliert die Flaggen in beiden Render-Modi.

Konfiguration der Tabellen mit Flaggen

Das Modul unterstützt drei separate Eintragssätze:

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

Im Frontend werden die Einträge zu einem gemeinsamen Satz von Switcher-Elementen zusammengeführt.

Store View Flags

Pfad:

language_flags/general/flag_config

Zweck:

Konfiguration von Flaggen für Store Views, die über den 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 Umschalten des Store Views.

Flag File

Pfad zur Flaggen-Datei, ausgewählt über den integrierten Dateiauswähler.

Bedeutung:

• bestimmt das im Frontend angezeigte Bild;
• kann als pl.svg oder language_flags/pl.svg gespeichert werden;
• relative Pfade werden vom Verzeichnis aus aufgelöst:

pub/media/language_flags/

Label

Vollständiger Name der Sprache oder des Marktes, z. B.:

• Polski
• English
• Deutsch

Bedeutung:

• wird neben der Flagge angezeigt, wenn Show Language Names aktiviert ist;
• dient auch als Hilfstext für die Barrierefreiheit.

Short Label

Verkürzte Bezeichnung, z. B.:

• PL
• EN
• DE

Bedeutung:

• wird in einer kompakteren Ansicht verwendet;
• kann anstelle des vollständigen Namens genutzt werden.

Website Flags

Pfad:

language_flags/general/website_flag_config

Zweck:

Konfiguration von Flaggen, die zu anderen Websites in derselben Magento-Instanz führen.

So funktioniert es

• ein Klick führt keinen nativen store switch post aus;
• der Eintrag wird als gewöhnlicher 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:

• bestimmt die Ziel-Website für den Eintrag;
• dient dazu, die Basisadresse der Ziel-Storefront abzurufen.

Flag File

Funktioniert genauso wie bei Store View Flags.

Label

Vollständige Bezeichnung, die im Frontend angezeigt wird.

Wenn sie leer bleibt:

• verwendet das Modul den Namen der Website.

Short Label

Verkürzte Bezeichnung, z. B.:

• UK
• DE
• FR

Wenn sie leer bleibt:

• verwendet das Modul den Website-Code in Großbuchstaben.

Custom URL Flags

Pfad:

language_flags/general/custom_url_flag_config

Zweck:

Konfiguration von Flaggen, die zu beliebigen URLs führen, z. B. zu einer anderen Magento-Instanz oder zu 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 gewöhnlicher href-Link gerendert;
• nutzt nicht den nativen Magento-Mechanismus zum Umschalten des Stores.

Flag File

Funktioniert genauso wie in den übrigen Tabellen.

Label

Vollständige Bezeichnung, die im Frontend angezeigt wird.

Wenn sie leer bleibt:

• versucht das Modul, den Host aus der URL zu verwenden.

Short Label

Verkürzte Bezeichnung für die kompakte Variante.

Wenn sie leer bleibt:

• erstellt das Modul eine Abkürzung auf Basis des Hosts;
• wenn das nicht möglich ist, verwendet es den Wert URL.

Vorbereitung der Flaggendateien

Empfohlener Speicherort:

pub/media/language_flags/

Empfohlene Formate:

• svg
• png

Beispiele für Dateinamen:

pl.svgen.svgde.svgfr.svg

Grundlegender Konfigurationsablauf

1. Aktivieren Sie das Modul über Enable Module.
2. Entscheiden Sie, ob Sie den nativen Magento-Switcher ersetzen möchten.
3. Legen Sie Native Display Mode fest.
4. Fügen Sie Flaggendateien zu pub/media/language_flags/ hinzu.
5. Ergänzen Sie Store View Flags.
6. Fügen Sie optionale Einträge in Website Flags hinzu.
7. Fügen Sie optionale Einträge in Custom URL Flags hinzu.
8. 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