Handleiding voor installatie en configuratie van de Magento 2 Language Flags-module

Installatie

Installatie via Composer

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

Installatie vanuit 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

Extra commando's voor production mode

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

Locatie van de configuratie

Beheerpaneel:

Stores > Configuration > Kowal > Language Flags

Widget voor de CMS-editor

De module biedt de widget:

Language Flags Switcher

Deze kan worden ingevoegd in:

• Content > Blocks
• Content > Pages

Pad in de editor:

Edit > Insert Widget > Language Flags Switcher

De widget ondersteunt:

• modus dropdown of inline;
• het tonen of verbergen van taalnamen;
• een extra CSS-klasse.

Standaardvlaggen

Tijdens bin/magento setup:upgrade kopieert de module standaard SVG-bestanden van:

view/frontend/web/images/flags/

naar de map:

pub/media/language_flags/

Alleen ontbrekende bestanden worden gekopieerd, zonder bestaande vlaggen te overschrijven.

Algemene configuratie

De sectie General Settings bevat velden die de werking van de module aansturen.

Enable Module

Pad:

language_flags/general/enabled

Betekenis:

• Yes schakelt de module in;
• No schakelt de module uit op de frontend.

Replace Native Store View Switcher

Pad:

language_flags/general/native_enabled

Betekenis:

• Yes vervangt de native Magento-switcher door de versie met vlaggen;
• No laat de native switcher ongewijzigd.

Native Display Mode

Pad:

language_flags/general/native_display_mode

Beschikbare opties:

• dropdown
• inline

Betekenis:

• dropdown toont de huidige positie en een uitklapbare lijst met de overige;
• inline toont alle vlaggen direct op één regel.

Show Language Names

Pad:

language_flags/general/show_labels

Betekenis:

• Yes toont taalnamen naast de vlaggen;
• No verbergt de namen in de hoofdweergave, maar laat ze beschikbaar voor toegankelijkheid.

Fallback to Store View Name

Pad:

language_flags/general/fallback_to_store_name

Betekenis:

• Yes gebruikt de store view-naam wanneer Label niet is ingevuld;
• No gebruikt de store view-code in hoofdletters.

Inline Flag Gap (px)

Pad:

language_flags/general/inline_gap

Betekenis:

• stelt de afstand tussen de elementen van de switcher in de modus inline in;
• de waarde wordt in pixels berekend;
• de standaardwaarde is 8.

Icon Scale (%)

Pad:

language_flags/general/icon_scale_percent

Betekenis:

• 100 behoudt de oorspronkelijke afmetingen van de afbeelding;
• een lagere waarde verkleint breedte en hoogte proportioneel;
• schaalt de vlaggen in beide renderingsmodi.

Configuratie van tabellen met vlaggen

De module ondersteunt drie afzonderlijke sets invoeren:

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

Op de frontend worden de invoeren samengevoegd tot één set switcher-elementen.

Store View Flags

Pad:

language_flags/general/flag_config

Doel:

Configuratie van vlaggen voor store views die door het native Magento-mechanisme worden afgehandeld.

Kolommen van het formulier

Store Code

Selecteert een store view uit de Magento-lijst.

Betekenis:

• wijst een vlag toe aan een specifieke store view;
• maakt gebruik van het native Magento-mechanisme voor het schakelen van store views.

Flag File

Pad naar het vlagbestand, geselecteerd via de ingebouwde bestandskiezer.

Betekenis:

• bepaalt de afbeelding die op de frontend wordt weergegeven;
• kan worden opgeslagen als pl.svg of language_flags/pl.svg;
• relatieve paden worden opgelost vanuit de map:

pub/media/language_flags/

Label

Volledige naam van de taal of markt, bijvoorbeeld:

• Pools
• English
• Deutsch

Betekenis:

• wordt naast de vlag weergegeven wanneer Show Language Names is ingeschakeld;
• dient ook als ondersteunende tekst voor toegankelijkheid.

Short Label

Verkort label, bijvoorbeeld:

• PL
• EN
• DE

Betekenis:

• wordt gebruikt in een compactere weergave;
• kan worden gebruikt in plaats van de volledige naam.

Website Flags

Pad:

language_flags/general/website_flag_config

Doel:

Configuratie van vlaggen die verwijzen naar andere websites binnen dezelfde Magento-instantie.

Hoe het werkt

• een klik voert geen native store switch post uit;
• de invoer wordt weergegeven als een gewone link naar de base URL van de doelwebsite;
• de huidige website wordt niet als aparte optie toegevoegd.

Kolommen van het formulier

Website

Selecteert een Magento-website uit de lijst.

Betekenis:

• bepaalt de doelwebsite voor de invoer;
• wordt gebruikt om het basisadres van de doelstorefront op te halen.

Flag File

Werkt hetzelfde als bij Store View Flags.

Label

Volledig label dat op de frontend wordt weergegeven.

Als het leeg blijft:

• gebruikt de module de naam van de website.

Short Label

Verkort label, bijvoorbeeld:

• UK
• DE
• FR

Als het leeg blijft:

• gebruikt de module de websitecode in hoofdletters.

Custom URL Flags

Pad:

language_flags/general/custom_url_flag_config

Doel:

Configuratie van vlaggen die verwijzen naar willekeurige URL's, bijvoorbeeld naar een andere Magento-instantie of een externe winkel.

Kolommen van het formulier

URL

Doeladres van de link.

Voorbeelden:

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

Betekenis:

• de invoer wordt weergegeven als een gewone href-link;
• maakt geen gebruik van het native Magento-mechanisme voor store switch.

Flag File

Werkt hetzelfde als in de overige tabellen.

Label

Volledig label dat op de frontend wordt weergegeven.

Als het leeg blijft:

• probeert de module de host uit de URL te gebruiken.

Short Label

Verkort label voor de compacte variant.

Als het leeg blijft:

• bouwt de module een afkorting op basis van de host;
• als dat niet mogelijk is, gebruikt deze de waarde URL.

Voorbereiding van vlagbestanden

Aanbevolen locatie:

pub/media/language_flags/

Aanbevolen formaten:

• svg
• png

Voorbeelden van bestandsnamen:

pl.svgen.svgde.svgfr.svg

Basisverloop van de configuratie

1. Schakel de module in via Enable Module.
2. Bepaal of u de native Magento-switcher wilt vervangen.
3. Stel Native Display Mode in.
4. Voeg vlagbestanden toe aan pub/media/language_flags/.
5. Vul Store View Flags in.
6. Voeg optionele invoeren toe in Website Flags.
7. Voeg optionele invoeren toe in Custom URL Flags.
8. Sla de configuratie op en maak de cache leeg.

Handige CLI-commando's

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