# 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 por correo electrónico los datos de acceso al repositorio Composer (dirección de e-mail del cliente y token de licencia) 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.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

Comandos adicionales para production mode

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/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:

• mododropdownoinline;
• mostrar u ocultar los nombres de los idiomas;
• una clase CSS adicional.

Banderas predeterminadas

Durantebin/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ónGeneral Settingscontiene los campos que controlan el funcionamiento del módulo.

Enable Module

Ruta:

language_flags/general/enabled

Significado:

• Yesactiva el módulo;
• Nodesactiva el módulo en el frontend.

Replace Native Store View Switcher

Ruta:

language_flags/general/native_enabled

Significado:

• Yessustituye el switcher nativo de Magento por una versión con banderas;
• Nomantiene el switcher nativo sin cambios.

Native Display Mode

Ruta:

language_flags/general/native_display_mode

Opciones disponibles:

• dropdown
• inline

Significado:

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

Show Language Names

Ruta:

language_flags/general/show_labels

Significado:

• Yesmuestra los nombres de los idiomas junto a las banderas;
• Nooculta 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:

• Yesusa el nombre del store view cuandoLabelno se ha completado;
• Nousa 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 modoinline;
• el valor se calcula en píxeles;
• el valor predeterminado es8.

Icon Scale (%)

Ruta:

language_flags/general/icon_scale_percent

Significado:

• 100mantiene 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 comopl.svgolanguage_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 cuandoShow Language Names;
• 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 elstore switch post;
• 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 enStore 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 normalhref;
• 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 valorURL.

Preparación de los archivos de banderas

Ubicación recomendada:

pub/media/language_flags/

Formatos recomendados:

• svg
• png

Ejemplos de nombres de archivo:

pl.svg
en.svg
de.svg
fr.svg

Flujo básico de configuración

1. Activa el módulo medianteEnable Module.
2. Decide si quieres sustituir el switcher nativo de Magento.
3. ConfiguraNative Display Mode.
4. Añade los archivos de banderas apub/media/language_flags/.
5. CompletaStore View Flags.
6. Añade entradas opcionales enWebsite Flags.
7. Añade entradas opcionales enCustom URL Flags.
8. Guarda la configuración y limpia la caché.

Comandos CLI útiles

bin/magento module:status Kowal_LanguageFlags
bin/magento cache:clean
bin/magento cache:flush