# Recibirás los datos de acceso por correo electrónico después de la compra: el e-mail del cliente y el token de licencia.
# También están disponibles en el panel de cliente tras iniciar sesión en kowal.store.
# Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de la cuenta y TWOJ_TOKEN por el token recibido.
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
Instrucciones de instalación y configuración del módulo Magento 2 Language Flags

Instalación

Instalación mediante Composer

Recibirás los datos de acceso al repositorio Composer, es decir, la dirección de e-mail del cliente y el token de licencia, por correo electrónico después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz 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:flush

Comandos adicionales para production mode

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

Ubicación de la configuración

Panel de administración:

Stores > Configuration > Kowal > Language Flags

Widget para el editor CMS

El módulo proporciona el widget:

Language Flags Switcher

Se puede insertar en:

• Content > Blocks
• Content > Pages

Ruta en el editor:

Edit > Insert Widget > Language Flags Switcher

El widget admite:

• modo dropdown o inline;
• mostrar u ocultar los nombres de los idiomas;
• una clase CSS adicional.

Banderas predeterminadas

Durante bin/magento setup:upgrade, el módulo copia los archivos SVG predeterminados desde:

view/frontend/web/images/flags/

al directorio:

pub/media/language_flags/

Solo se copian los archivos que faltan, sin sobrescribir las banderas ya existentes.

Configuración general

La sección General Settings contiene los campos que controlan el funcionamiento del módulo.

Enable Module

Ruta:

language_flags/general/enabled

Significado:

• Yes activa el módulo;
• No desactiva el módulo en el frontend.

Replace Native Store View Switcher

Ruta:

language_flags/general/native_enabled

Significado:

• Yes sustituye el switcher nativo de Magento por una versión con banderas;
• No mantiene el switcher nativo sin cambios.

Native Display Mode

Ruta:

language_flags/general/native_display_mode

Opciones disponibles:

• dropdown
• inline

Significado:

• dropdown muestra la opción actual y una lista desplegable con las restantes;
• inline muestra todas las banderas directamente en una sola línea.

Show Language Names

Ruta:

language_flags/general/show_labels

Significado:

• Yes muestra los nombres de los idiomas junto a las banderas;
• No oculta los nombres en la vista principal, pero los mantiene por motivos de accesibilidad.

Fallback to Store View Name

Ruta:

language_flags/general/fallback_to_store_name

Significado:

• Yes usa el nombre del store view cuando Label no se ha completado;
• No usa el código del store view en mayúsculas.

Inline Flag Gap (px)

Ruta:

language_flags/general/inline_gap

Significado:

• define el espacio entre los elementos del switcher en modo inline;
• el valor se calcula en píxeles;
• el valor predeterminado es 8.

Icon Scale (%)

Ruta:

language_flags/general/icon_scale_percent

Significado:

• 100 mantiene las dimensiones originales de la imagen;
• un valor inferior reduce la anchura y la altura de forma proporcional;
• escala las banderas en ambos modos de renderizado.

Configuración de las tablas con banderas

El módulo admite tres conjuntos independientes de entradas:

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

En el frontend, las entradas se combinan en un único conjunto de elementos del switcher.

Store View Flags

Ruta:

language_flags/general/flag_config

Finalidad:

Configuración de banderas para los store views gestionados por el mecanismo nativo de Magento.

Columnas del formulario

Store Code

Selecciona un store view de la lista de Magento.

Significado:

• asigna una bandera a un store view concreto;
• utiliza el mecanismo nativo de cambio de store view de Magento.

Flag File

Ruta al archivo de la bandera seleccionada mediante el selector de archivos integrado.

Significado:

• define la imagen que se muestra en el frontend;
• puede guardarse como pl.svg o language_flags/pl.svg;
• las rutas relativas se resuelven desde el directorio:

pub/media/language_flags/

Label

Nombre completo del idioma o mercado, por ejemplo:

• Polski
• English
• Deutsch

Significado:

• se muestra junto a la bandera cuando Show Language Names está activado;
• también sirve como texto auxiliar para accesibilidad.

Short Label

Etiqueta abreviada, por ejemplo:

• PL
• EN
• DE

Significado:

• se utiliza en una vista más compacta;
• puede usarse en lugar del nombre completo.

Website Flags

Ruta:

language_flags/general/website_flag_config

Finalidad:

Configuración de banderas que dirigen a otros websites dentro de la misma instancia de Magento.

Cómo funciona

• al hacer clic no se ejecuta el store switch post nativo;
• la entrada se renderiza como un enlace normal al base URL del website de destino;
• el website actual no se añade como opción independiente.

Columnas del formulario

Website

Selecciona un website de Magento de la lista.

Significado:

• define el website de destino para la entrada;
• sirve para obtener la dirección base del storefront de destino.

Flag File

Funciona igual que en Store View Flags.

Label

Etiqueta completa mostrada en el frontend.

Si se deja vacía:

• el módulo usará el nombre del website.

Short Label

Etiqueta abreviada, por ejemplo:

• UK
• DE
• FR

Si se deja vacía:

• el módulo usará el código del website en mayúsculas.

Custom URL Flags

Ruta:

language_flags/general/custom_url_flag_config

Finalidad:

Configuración de banderas que dirigen a cualquier URL, por ejemplo, a otra instancia de Magento o a una tienda externa.

Columnas del formulario

URL

Dirección de destino del enlace.

Ejemplos:

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

Significado:

• la entrada se renderiza como un enlace normal href;
• no utiliza el mecanismo nativo de store switch de Magento.

Flag File

Funciona igual que en las demás tablas.

Label

Etiqueta completa mostrada en el frontend.

Si se deja vacía:

• el módulo intentará usar el host de la URL.

Short Label

Etiqueta abreviada para la variante compacta.

Si se deja vacía:

• el módulo generará una abreviatura a partir del host;
• si no es posible, usará el valor URL.

Preparación de los archivos de banderas

Ubicación recomendada:

pub/media/language_flags/

Formatos recomendados:

• svg
• png

Ejemplos de nombres de archivo:

pl.svgen.svgde.svgfr.svg

Flujo básico de configuración

1. Activa el módulo mediante Enable Module.
2. Decide si quieres sustituir el switcher nativo de Magento.
3. Configura Native Display Mode.
4. Añade los archivos de banderas a pub/media/language_flags/.
5. Completa Store View Flags.
6. Añade entradas opcionales en Website Flags.
7. Añade entradas opcionales en Custom URL Flags.
8. Guarda la configuración y limpia la caché.

Comandos CLI útiles

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