# Je ontvangt de toegangsgegevens via e-mail na aankoop: het e-mailadres van de klant en de licentietoken.
# Ze zijn ook beschikbaar in het klantenpaneel na inloggen op kowal.store.
# Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van het account en TWOJ_TOKEN door de ontvangen 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
Installatie- en configuratiehandleiding voor de Magento 2 Language Flags-module

Installatie

Installatie via Composer

De toegangsgegevens voor de Composer-repository, het e-mailadres van de klant en de licentietoken, ontvang je per e-mail na aankoop. Ze zijn ook beschikbaar in het klantenpaneel na inloggen op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van je account en TWOJ_TOKEN door de ontvangen token. Voer de opdrachten uit in de hoofdmap van 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:flush

Aanvullende opdrachten 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

Je kunt deze invoegen in:

• Content > Blocks
• Content > Pages

Pad in de editor:

Edit > Insert Widget > Language Flags Switcher

De widget ondersteunt:

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

Standaardvlaggen

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

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 waarmee de werking van de module wordt beheerd.

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 een 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 opties;
• inline toont alle vlaggen direct op één regel.

Show Language Names

Pad:

language_flags/general/show_labels

Betekenis:

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

Fallback to Store View Name

Pad:

language_flags/general/fallback_to_store_name

Betekenis:

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

Inline Flag Gap (px)

Pad:

language_flags/general/inline_gap

Betekenis:

• stelt de afstand in tussen de elementen van de switcher in de modus inline;
• de waarde wordt berekend in pixels;
• 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 de breedte en hoogte proportioneel;
• schaalt de vlaggen in beide rendermodi.

Configuratie van tabellen met vlaggen

De module ondersteunt drie afzonderlijke sets vermeldingen:

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

Op de frontend worden de vermeldingen 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 ondersteund.

Formulierkolommen

Store Code

Selecteert een store view uit de Magento-lijst.

Betekenis:

• koppelt een vlag aan een specifieke store view;
• gebruikt het native mechanisme van Magento voor het wisselen van store view.

Flag File

Pad naar het vlagbestand, gekozen via de ingebouwde file picker.

Betekenis:

• bepaalt welke afbeelding 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, bijv.:

• Polski
• English
• Deutsch

Betekenis:

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

Short Label

Verkorte label, bijv.:

• 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 naar andere websites binnen dezelfde Magento-instantie verwijzen.

Hoe het werkt

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

Formulierkolommen

Website

Selecteert een Magento-website uit de lijst.

Betekenis:

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

Flag File

Werkt hetzelfde als in Store View Flags.

Label

Volledige label die op de frontend wordt weergegeven.

Als dit leeg blijft:

• gebruikt de module de naam van de website.

Short Label

Verkorte label, bijv.:

• UK
• DE
• FR

Als dit 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 naar willekeurige URL-adressen verwijzen, bijv. naar een andere Magento-instantie of een externe winkel.

Formulierkolommen

URL

Doeladres van de link.

Voorbeelden:

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

Betekenis:

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

Flag File

Werkt hetzelfde als in de overige tabellen.

Label

Volledige label die op de frontend wordt weergegeven.

Als dit leeg blijft:

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

Short Label

Verkorte label voor de compacte variant.

Als dit leeg blijft:

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

Vlagbestanden voorbereiden

Aanbevolen locatie:

pub/media/language_flags/

Aanbevolen formaten:

• svg
• png

Voorbeelden van bestandsnamen:

pl.svgen.svgde.svgfr.svg

Basisconfiguratieproces

1. Schakel de module in via Enable Module.
2. Bepaal of je 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 vermeldingen toe in Website Flags.
7. Voeg optionele vermeldingen toe in Custom URL Flags.
8. Sla de configuratie op en wis de cache.

Handige CLI-opdrachten

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