Guía de instalación y configuración del módulo Magento 2 Language Flags

Instalación

Instalación mediante Composer

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

Instalación desde el repositorio Git

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

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;
• 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 la versión con banderas;
• No deja el switcher nativo sin cambios.

Native Display Mode

Ruta:

language_flags/general/native_display_mode

Opciones disponibles:

• dropdown
• inline

Significado:

• dropdown muestra el elemento actual y una lista desplegable con los demás;
• inline muestra todas las banderas de inmediato 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 accesibilidad.

Fallback to Store View Name

Ruta:

language_flags/general/fallback_to_store_name

Significado:

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

Inline Flag Gap (px)

Ruta:

language_flags/general/inline_gap

Significado:

• establece 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 proporcionalmente el ancho y la altura;
• escala las banderas en ambos modos de renderizado.

Configuración de las tablas de 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 store views gestionados por el mecanismo nativo de Magento.

Columnas del formulario

Store Code

Selecciona el store view de la lista de Magento.

Significado:

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

Flag File

Ruta del archivo de la bandera seleccionada desde el selector de archivos integrado.

Significado:

• define la imagen mostrada 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 está activado Show Language Names;
• también sirve como texto de apoyo 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

• el clic no 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 de 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 dirección 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 href normal;
• no utiliza el mecanismo nativo de cambio de store 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 construirá una abreviatura a partir del host;
• si eso no es posible, usará el valor de 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

Proceso 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