Módulo Language Flags para Magento 2
- Compatibilidade
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
- Hyva Theme
- Hyva Theme Redy
Descrição / Módulo Language Flags para Magento 2
MAGENTO 2 · VÁRIOS MERCADOS · NAVEGAÇÃO
Ajude o cliente a escolher o idioma e o mercado certos.
Kowal Language Flags
Substitua o seletor padrão por uma lista clara de bandeiras e etiquetas. Ligue store views, outros websites e endereços externos num único ponto de navegação.
Store Views · Websites e URL · Dropdown ou inline
COMO FUNCIONA NA PRÁTICA
01 · Escolhe os destinos
Configura store views, websites ou endereços próprios.
02 · Adiciona bandeiras e etiquetas
Utiliza ícones prontos ou ficheiros próprios.
03 · O cliente escolhe a versão
O seletor encaminha para o idioma ou mercado escolhido.
O que ganha a sua loja?
Conheça as funções, a aplicação e as definições do módulo.
Um único switcher para vários cenários linguísticos
Kowal_LanguageFlags resolve o problema de um seletor de idioma pouco claro no Magento 2. Em vez da lista padrão de códigos de store view, o cliente vê um switcher intuitivo com bandeiras, nomes de idiomas e a possibilidade de navegar não só entre store views, mas também entre websites e lojas externas.
Esta solução é especialmente útil quando:
- uma loja suporta várias versões linguísticas;
- diferentes mercados funcionam como websites separados;
- parte do tráfego deve ser encaminhada para outra instância Magento;
- é necessário um switcher único e coerente para diferentes tipos de endereços de destino.
O que o módulo oferece
- bandeiras para store views;
- bandeiras para outros websites na mesma instância Magento;
- bandeiras para quaisquer URL, por exemplo para uma loja Magento separada;
- etiquetas próprias e abreviações de idiomas;
- duas variantes de apresentação:
dropdowneinline; - suporte para o switcher nativo do Magento e para widget.
Benefícios comerciais
- identificação mais rápida da versão linguística pelo cliente;
- menos erros na escolha do mercado ou do idioma;
- apresentação mais profissional de uma loja multilingue;
- possibilidade de ligar comodamente vários storefronts num único ponto de navegação;
- implementação mais rápida do que criar um componente dedicado de raiz.
Benefícios técnicos
- configuração a partir do painel de administração;
- compatibilidade com o mecanismo nativo do Magento para store view switch;
- uma configuração para o switcher nativo e para o widget;
- conjunto predefinido de bandeiras SVG prontas copiado para
pub/media/language_flags/durante a instalação; - não é necessário criar uma tabela de dados separada no início;
- possibilidade de implementação via Composer.
Conjunto de bandeiras pronto a usar
O módulo inclui um conjunto de ícones SVG prontos 24x18, que podem ser copiados automaticamente para pub/media/language_flags/ durante bin/magento setup:upgrade.
Bandeiras disponíveis:
Bandeiras 1–10
atÁustriabeBélgicabgBulgáriacyChipreczChéquiadeAlemanhadkDinamarcaeeEstóniaesEspanhaeuUnião Europeia
Bandeiras 11–20
fiFinlândiafrFrançagrGréciahrCroáciahuHungriaieIrlandaitItálialtLituânialuLuxemburgolvLetónia
Bandeiras 21–30
mtMaltanlPaíses BaixosplPolóniaptPortugalroRoméniaseSuéciasiEslovéniaskEslováquiaukReino UnidousEstados Unidos
Para quem
O módulo destina-se a:
- lojas Magento 2 que operam em vários mercados;
- instalações com várias store views e websites;
- projetos em que parte das versões linguísticas funciona fora do storefront principal;
- equipas que querem implementar um switcher claro sem reconstruir o core do Magento.
Exemplos de utilização
Um Magento, várias store views
A loja tem as versões:
PLENDE
Cada uma pode ter uma bandeira e uma etiqueta separadas.
Um Magento, vários websites
A loja utiliza websites separados para diferentes países, por exemplo:
- Polónia
- Alemanha
- França
O módulo permite apresentar estes websites no mesmo switcher que as store views locais.
Storefronts distribuídos
Parte dos mercados funciona noutra instância Magento ou sob outro domínio. Nessa situação, Custom URL Flags permitem incluí-los num seletor comum.
Resultado da implementação
O cliente obtém um switcher único e coerente de idioma e mercado, e o administrador pode geri-lo a partir da configuração do Magento sem criar componentes frontend adicionais.
Aspeto e escolha de bandeiras no painel
Em Stores → Configuration → Kowal → Language Flags, ativa o módulo e a substituição opcional do seletor nativo. Pode definir o modo dropdown ou inline, a visibilidade dos nomes dos idiomas, o espaçamento entre bandeiras e a escala dos ícones. Os nomes continuam disponíveis para leitores de ecrã mesmo depois de ocultar as etiquetas visíveis.
Escolhe imagens no picker em pub/media/language_flags/ e configura Store View Flags, Website Flags e Custom URL Flags. Também pode inserir o seletor como widget Language Flags Switcher numa página ou bloco CMS.
Requisitos e forma de navegação entre lojas
O pacote testado requer PHP ^8.1 || ^8.2 || ^8.3 e os módulos Magento definidos no Composer. Store View utiliza a comutação nativa do Magento. Website e URL próprio encaminham diretamente para o endereço indicado.
A seleção de bandeiras, etiquetas e endereços permite adaptar a navegação aos mercados. O módulo não traduz o conteúdo dos produtos; as versões linguísticas são preparadas na configuração e nos dados da loja.
Instalação via Composer
Pacote: kowal/module-language-flags; módulo: Kowal_LanguageFlags. Depois de configurar o acesso ao repositório Kowal, instale o pacote, ative o módulo, execute a atualização do Magento e limpe a cache. Para o modo de produção, inclua a compilação e a implementação de conteúdo estático de acordo com o processo da loja.
Da configuração ao resultado
1. Escolhe os destinos
Configura store views, websites ou endereços próprios.
2. Adiciona bandeiras e etiquetas
Utiliza ícones prontos ou ficheiros próprios.
3. O cliente escolhe a versão
O seletor encaminha para o idioma ou mercado escolhido.
Navegação comum para vários storefronts
Exemplo: a versão polaca funciona como Store View, o mercado alemão como website separado e a loja britânica sob outro domínio.
Pode apresentar os três destinos num único seletor. Store View utiliza o processo nativo do Magento, enquanto websites e URL próprios funcionam como ligações diretas.
Organize a escolha da versão linguística e do mercado
Quer adaptar o módulo à sua loja? Pergunte sobre a implementação do Kowal Language Flags e discuta a configuração ou as extensões necessárias.
Mais informação
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Compatibilidade com o modelo | Hyvä, Luma / Blank, KOWAL |
Manual de instalação do módulo
# Receberá os dados de acesso, e-mail do cliente e token de licença, por e-mail após a compra.
# Também estão disponíveis no painel do cliente depois de iniciar sessão em kowal.store.
# Substitua TWOJ_EMAIL_KLIENTA pelo endereço de e-mail da conta e TWOJ_TOKEN pelo token recebido.
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
Manual de instalação e configuração do módulo Magento 2 Language Flags
Instalação
Instalação via Composer
Receberá os dados de acesso ao repositório Composer, endereço de e-mail do cliente e token de licença, por e-mail após a compra. Também estão disponíveis no painel do cliente depois de iniciar sessão em kowal.store. Substitua TWOJ_EMAIL_KLIENTA pelo endereço de e-mail da sua conta e TWOJ_TOKEN pelo token recebido. Execute os comandos no diretório raiz do 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:flushComandos adicionais para production mode
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushLocalização da configuração
Painel de administração:
Stores > Configuration > Kowal > Language FlagsWidget para o editor CMS
O módulo disponibiliza o widget:
Language Flags SwitcherPode ser inserido em:
Content > BlocksContent > Pages
Caminho no editor:
Edit > Insert Widget > Language Flags SwitcherO widget suporta:
- modo
dropdownouinline; - ativar ou ocultar nomes de idiomas;
- classe CSS adicional.
Bandeiras predefinidas
Durante bin/magento setup:upgrade, o módulo copia os ficheiros SVG predefinidos de:
view/frontend/web/images/flags/para o diretório:
pub/media/language_flags/São copiados apenas os ficheiros em falta, sem substituir bandeiras já existentes.
Configuração geral
A secção General Settings contém campos que controlam o funcionamento do módulo.
Enable Module
Caminho:
language_flags/general/enabledSignificado:
Yesativa o módulo;Nodesativa o módulo no frontend.
Replace Native Store View Switcher
Caminho:
language_flags/general/native_enabledSignificado:
Yessubstitui o switcher nativo do Magento pela versão com bandeiras;Nodeixa o switcher nativo inalterado.
Native Display Mode
Caminho:
language_flags/general/native_display_modeOpções disponíveis:
dropdowninline
Significado:
dropdownmostra a posição atual e a lista suspensa das restantes;inlinemostra todas as bandeiras imediatamente numa só linha.
Show Language Names
Caminho:
language_flags/general/show_labelsSignificado:
Yesmostra os nomes dos idiomas junto às bandeiras;Nooculta os nomes na vista principal, mas mantém-nos para acessibilidade.
Fallback to Store View Name
Caminho:
language_flags/general/fallback_to_store_nameSignificado:
Yesutiliza o nome da store view quandoLabelnão foi preenchido;Noutiliza o código da store view em maiúsculas.
Inline Flag Gap (px)
Caminho:
language_flags/general/inline_gapSignificado:
- define o espaçamento entre os elementos do switcher no modo
inline; - o valor é calculado em píxeis;
- o valor predefinido é
8.
Icon Scale (%)
Caminho:
language_flags/general/icon_scale_percentSignificado:
100mantém as dimensões originais da imagem;- um valor inferior reduz a largura e a altura proporcionalmente;
- escala as bandeiras em ambos os modos de renderização.
Configuração das tabelas com bandeiras
O módulo suporta três conjuntos de entradas separados:
Store View FlagsWebsite FlagsCustom URL Flags
No frontend, as entradas são combinadas num único conjunto de elementos do switcher.
Store View Flags
Caminho:
language_flags/general/flag_configFinalidade:
Configuração de bandeiras para store views suportadas pelo mecanismo nativo do Magento.
Colunas do formulário
Store Code
Seleciona a store view a partir da lista do Magento.
Significado:
- atribui uma bandeira a uma store view específica;
- utiliza o mecanismo nativo de alternância de store view do Magento.
Flag File
Caminho para o ficheiro da bandeira selecionado no picker de ficheiros integrado.
Significado:
- define a imagem apresentada no frontend;
- pode ser guardado como
pl.svgoulanguage_flags/pl.svg; - os caminhos relativos são resolvidos a partir do diretório:
pub/media/language_flags/Label
Nome completo do idioma ou mercado, por exemplo:
PolskiEnglishDeutsch
Significado:
- é apresentado junto à bandeira quando
Show Language Namesestá ativado; - também serve como texto auxiliar para acessibilidade.
Short Label
Etiqueta abreviada, por exemplo:
PLENDE
Significado:
- é utilizada numa vista mais compacta;
- pode ser usada em vez do nome completo.
Website Flags
Caminho:
language_flags/general/website_flag_configFinalidade:
Configuração de bandeiras que encaminham para outros websites na mesma instância Magento.
Como funciona
- o clique não executa o
store switch postnativo; - a entrada é renderizada como uma ligação normal para o base URL do website de destino;
- o website atual não é adicionado como opção separada.
Colunas do formulário
Website
Seleciona o website Magento a partir da lista.
Significado:
- define o website de destino para a entrada;
- serve para obter o endereço base do storefront de destino.
Flag File
Funciona da mesma forma que em Store View Flags.
Label
Etiqueta completa apresentada no frontend.
Se ficar vazia:
- o módulo utilizará o nome do website.
Short Label
Etiqueta abreviada, por exemplo:
UKDEFR
Se ficar vazia:
- o módulo utilizará o código do website em maiúsculas.
Custom URL Flags
Caminho:
language_flags/general/custom_url_flag_configFinalidade:
Configuração de bandeiras que encaminham para quaisquer endereços URL, por exemplo para outra instância Magento ou uma loja externa.
Colunas do formulário
URL
Endereço de destino da ligação.
Exemplos:
https://example.de/https://en.example.com/https://shop.example.cz/
Significado:
- a entrada é renderizada como uma ligação normal
href; - não utiliza o mecanismo nativo de store switch do Magento.
Flag File
Funciona da mesma forma que nas restantes tabelas.
Label
Etiqueta completa apresentada no frontend.
Se ficar vazia:
- o módulo tentará utilizar o host do URL.
Short Label
Etiqueta abreviada para a variante compacta.
Se ficar vazia:
- o módulo criará uma abreviação com base no host;
- se isso não for possível, utilizará o valor
URL.
Preparação dos ficheiros de bandeiras
Localização recomendada:
pub/media/language_flags/Formatos recomendados:
svgpng
Exemplos de nomes de ficheiros:
pl.svgen.svgde.svgfr.svgFluxo básico de configuração
- Ative o módulo através de
Enable Module. - Decida se pretende substituir o switcher nativo do Magento.
- Defina
Native Display Mode. - Adicione ficheiros de bandeiras a
pub/media/language_flags/. - Preencha
Store View Flags. - Adicione entradas opcionais em
Website Flags. - Adicione entradas opcionais em
Custom URL Flags. - Guarde a configuração e limpe a cache.
Comandos CLI úteis
bin/magento module:status Kowal_LanguageFlagsbin/magento cache:cleanbin/magento cache:flush