O switcher é o que permite aos visitantes mudar de idioma. Está configurado em Traduções → Switcher. Aparece apenas quando há pelo menos uma língua alvo.
Modo (Onde aparece)
| Modo | O que faz |
|---|---|
| Automático (padrão) | Aparece por conta própria, flutuando, sem tocar no tema. Escolha o canto em Posição: canto inferior direito, canto inferior esquerdo, canto superior direito ou canto superior esquerdo. |
| Manual | Coloque onde quiser, com o shortcode ou a função PHP (veja abaixo). |
| Desligado | Não aparece. |
No modo automático, se você colocar um switcher manualmente numa página, o flutuante sai dessa página — nunca há dois.
O switcher flutuante também aparece no carrinho e na checkout. Alguém que chega ao carrinho na língua errada precisa de um caminho de volta para a sua, precisamente quando está a gastar dinheiro.
Formato
Cada formato é pré-visualizado no painel com as línguas do seu site.
| Formato | Quando usá-lo |
|---|---|
| Lista | Um ao lado do outro, tudo visível. Desce horizontalmente por conta própria se não couber. |
| Coluna | Um por linha. Para rodapés e barras laterais estreitas. |
| Menu | Abre com um clique. Ocupa o espaço de uma única língua. |
| Caixa do sistema | A caixa de seleção do sistema. Nos telemóveis, abre a roda nativa, mais fácil de tocar com um dedo. |
Como lê
- Bandeiras — mostra uma bandeira emoji antes do nome. Elas são desenhadas pelo sistema do visualizador, sem imagens. Uma língua cujo código não inclua país (por exemplo.
frem vez defr_FR) não recebe bandeira — um país não é uma língua. - Nome ou código — Inglês, Español ou EN, ES.
- Sugira a língua do visitante — ver A barra de sugestões de línguas.
Aparência
Com uma pré-visualização ao vivo ao lado:
- Caixa — fundo, borda, borda ao passar o mouse.
- Línguas — texto, fundo e texto ao passar o mouse, fundo e texto da língua atual.
- Formato — tamanho do texto, cantos arredondados, sombra.
- Redefinir para o padrão — volta às cores originais.
Se a cor do texto cair abaixo de uma razão de contraste de 4.5:1 (o mínimo do padrão de acessibilidade WCAG AA), o painel avisa. Ele avisa, não impede.
Colocando à mão
Esses funcionam em todos os três modos.
Em conteúdo ou um widget:
[pht_switcher]
Opções de shortcode:
show_label="no"— mostra apenas o código em vez do nome;class="my-class"— adiciona uma classe CSS.
Num template de tema (geralmente header.php):
<?php pht_switcher(); ?>
Personalizando com CSS
O comutador utiliza cerca de 4 KB de CSS, apenas nas páginas onde aparece, e zero JavaScript em três das quatro formas. Cada opção de aparência é uma variável CSS em .pht-switcher (--pht-bg, --pht-fg, --pht-hover, --pht-radius…), assim um tema pode redefini-las sem !important.
A barra de sugestões de línguas
Alguém que chega ao site numa língua que não é a do seu navegador vê uma pequena barra no topo oferecendo a versão na sua língua.
- Sugere, não redireciona. Redirecionar pela língua do navegador quebra o cache da página, e o Google desaconselha isso.
- Aparece apenas uma vez. Escolhendo ou fechando respostas permanentemente.
- É ativado e desativado em Comutador → Sugira a língua do visitante... É ativado por padrão.
Tradução automática do navegador
Em páginas já traduzidas pelo plugin, o Chrome e outros navegadores param de oferecer “Traduzir esta página” — a tradução deles em cima da nossa daria um texto pior. Na língua de origem, a oferta permanece ativa: é assim que um visitante estrangeiro descobre que o site existe na sua língua.