WPML

O WPML permite que você traduza seu site para 65 idiomas pré-configurados, adicione seus próprios idiomas personalizados e personalize várias opções de configuração para o seu seletor de idiomas, formato de URL e muito mais. Você encontrará tudo isso em WPMLConfigurações, nas seções Idiomas, Seletores de idiomas, URLs e SEO e Compatibilidade.

Idiomas do site

Escolha dos idiomas para o site
Escolha dos idiomas para o site

Quando você configura o WPML pela primeira vez (o primeiro passo do Setup Wizard do WPML), você precisa escolher o idioma do seu conteúdo existente. Em seguida, escolha para quais dos 65 idiomas pré-configurados você gostaria de traduzir o seu site.

Também é possível criar um idioma personalizado. Isso é especialmente útil se você quiser adicionar um idioma específico de um país ao seu site (como francês canadense ou alemão suíço), ou se você precisar de um idioma que não aparece na lista de idiomas pré-configurados.

Para o idioma personalizado que você criar, você pode usar uma das bandeiras do WPML ou adicionar uma bandeira personalizada.

Você pode adicionar, editar ou remover idiomas do seu site a qualquer momento acessando WPMLConfiguraçõesIdiomas. A seção Gerenciar e ocultar idiomas do site lista uma linha por idioma: use Pesquisar e adicionar um idioma… para adicionar um, e o menu Editar da linha para configurá-lo ou removê-lo.

Formato de URL do idioma

O WPML permite que você escolha como organizar o conteúdo em diferentes idiomas. Você pode escolher entre:

  • Idiomas diferentes em diretórios – como wpml.org/es/ para espanhol e wpml.org/de/ para alemão.
  • Um domínio diferente por idioma – subdomínios como es.example.com e de.example.com ou domínios completamente diferentes como ejemplo.es e beispiel.de.
  • Nome do idioma adicionado como um parâmetro – como wpml.org/?lang=es para espanhol.

Para que a opção Idiomas diferentes em diretórios funcione, a estrutura de links permanentes do seu site precisa ser diferente da padrão. Recomendamos escolher Ano/Mês/Nome ou %postname%.

Para exemplos mais detalhados e documentação sobre o que é necessário para cada um desses modos funcionar, leia sobre as opções de URL de idioma.

Seletor de idiomas

As opções do seletor de idiomas estão em WPMLConfiguraçõesSeletores de idiomas.

Para permitir que os visitantes selecionem seu idioma preferido, o WPML adiciona um seletor de idiomas ao rodapé do seu site por padrão. Você também pode adicionar seletores de idiomas a widgets, menus ou criar seu próprio seletor de idiomas personalizado.

Opções para os seletores de idiomas do WPML
Opções para os seletores de idiomas do WPML

Ou você pode adicionar um seletor de idiomas a menus, widgets, modelos e conteúdo de página ou post usando o bloco Seletor de idiomas.

Você também pode exibir seletores de idiomas usando os seguintes hooks:

Ordem dos idiomas

Você pode controlar a ordem em que os idiomas aparecem no seletor de idiomas na seção Opções do seletor de idiomas em WPMLConfiguraçõesSeletores de idiomas.

Definição da ordem dos idiomas
Definição da ordem dos idiomas

Clique e arraste os idiomas para alterar a ordem.

Observe que, quando você usa um seletor de idiomas suspenso, o primeiro idioma mostrado é sempre o idioma atual. Os outros idiomas serão listados de acordo com a ordem que você definir na lista Ordem dos idiomas.

Escolha do que exibir no seletor de idiomas

Você pode escolher o que incluir no seletor de idiomas. O WPML pode exibir uma bandeira de país, o nome do idioma nativo e o nome do idioma no idioma atual da página (como “Deutsch (alemão)” quando o idioma atual for o inglês).

Você também pode escolher as cores para todas as partes do seletor de idiomas.

Para fazer qualquer alteração no seu seletor de idiomas:

  1. Vá para WPMLConfiguraçõesSeletores de idiomas.
  2. Encontre o seu seletor. Cada seletor de idiomas estará em uma seção diferente, dependendo do seu posicionamento no site: Seletor de idiomas de menu, Seletor de idiomas de widget ou Seletor de idiomas de rodapé.
  3. Clique no ícone de lápis para editá-lo.

Ao fazer alterações, você verá uma pequena pré-visualização de como o seletor de idiomas ficará antes de salvar.

Opções do seletor de idiomas
Opções do seletor de idiomas

Você pode estilizar o seletor de idiomas do WPML para que ele corresponda ao design do seu site.

Para alterar as bandeiras que aparecem ao lado dos idiomas:

  1. Vá para WPMLConfiguraçõesIdiomas
  2. Na seção Gerenciar e ocultar idiomas do site, clique em Editar na linha do idioma que você quer alterar
  3. Abra o seletor Bandeira e escolha uma das bandeiras do WPML, o globo neutro ou o código do país — ou escolha Fazer upload de um SVG personalizado… para usar a sua própria

Para mais informações sobre os diferentes estilos de seletores de idiomas que você pode adicionar ao seu site, leia sobre as opções do seletor de idiomas.

Seletores de idiomas personalizados

Você pode criar seletores de idiomas personalizados e adicioná-los ao tema do site.

Opção para ativar ou desativar seletores de idiomas personalizados
Opção para ativar ou desativar seletores de idiomas personalizados

Na seção Seletores de idiomas personalizados, você pode ativar ou desativar os seletores de idiomas personalizados no seu site. Quando os seletores de idiomas personalizados estão desativados, os recursos CSS e JavaScript relacionados não são mais carregados. Isso é útil para sites que não usam nenhum seletor de idiomas.

Neste caso, ainda é possível usar o shortcode wpml_language_switcher e a ação wpml_language_switcher, no entanto, eles exibirão os seletores de idiomas sem nenhum CSS ou JavaScript.

Os seletores de idiomas personalizados são ativados por padrão para instalações existentes que atualizam para a versão 3.8 ou posterior do WPML. Para novas instalações usando a versão 3.8 ou posterior do WPML, esta opção é desativada por padrão.

Opções de SEO

Ativação das Opções de SEO
Ativação das Opções de SEO

Quando o seu site multilíngue é analisado pelos mecanismos de busca, como o Google, é importante “dizer” a eles sobre os idiomas alternativos disponíveis para o conteúdo do seu site. Dessa forma, os mecanismos de busca não tratarão as traduções como duplicatas, mas como o mesmo conteúdo, apenas em idiomas diferentes. Isso é bom para as classificações de SEO do seu site.

Observe que, quando ativada, esta informação não é visível no front-end do seu site, mas apenas no código-fonte.

Além de ativar e desativar esse recurso, você também pode usar a opção Posição do link hreflang para definir onde esta informação será exibida:

  • O mais cedo possível - padrão, prioridade 1
  • Mais tarde na seção head - prioridade 10

Na maioria dos casos, é melhor usar a configuração padrão. Às vezes, diferentes temas e plugins podem causar conflitos quando esta opção é usada. Esses conflitos podem levar a um conjunto incorreto ou completamente ausente desses links de idioma de SEO. Nesse caso, mudar para a opção Mais tarde na seção head deve resolver o problema.

Idioma do painel de administração

O idioma padrão normalmente também é o idioma do painel de administração. No entanto, você também pode escolher exibir o painel de administração do WordPress do seu site em um idioma diferente do idioma padrão do conteúdo do seu site. Esta não é uma configuração do WPML: ela pertence ao WordPress, em UsuáriosPerfilOpções pessoaisIdioma.

Seleção de um idioma diferente para o painel de administração
Seleção de um idioma diferente para o painel de administração

Isso permite que sites que têm vários autores, cada um escrevendo em um idioma diferente, possam ter um idioma do painel de administração diferente por usuário. Os usuários individuais podem selecionar seu idioma do painel de administração em sua própria página de perfil.

Para saber como definir o idioma padrão do painel de administração do site e um idioma diferente do painel de administração por usuário, leia sobre a configuração do idioma de administração do WordPress.

Filtragem de idioma para operações AJAX

O WPML permite que você ative um cookie JavaScript para que temas e plugins possam realizar a filtragem AJAX sem problemas, mesmo em sites com cache.

Armazenamento de um cookie de idioma para suportar a filtragem de idioma para AJAX
Armazenamento de um cookie de idioma para suportar a filtragem de idioma para AJAX

Saiba mais sobre isso na página sobre a ativação do cookie de idioma para suportar a filtragem AJAX.

Mais nesta seção

Escrito por Amir · Última atualização em 19 de fevereiro de 2026