Skip Navigation
Atualizado
agosto 16, 2021

Ao desenvolver sites multilíngues com o WPML, você talvez precise de um seletor de idioma personalizado. Aprenda a criar um com um pouco de programação simples em PHP e CSS.

Neste tutorial, mostraremos como adicionar um seletor de idioma flutuante. Um seletor de idioma flutuante fica ótimo e facilita para seus clientes visualizarem seu site no idioma deles.

Um site com um seletor de idioma flutuante

Siga essas três etapas principais:

  1. Adicione o código de programação PHP que renderiza o seletor de idioma.
  2. Estilize seu seletor de idioma com CSS.
  3. Atualize as configurações do seu seletor de idioma.

A parte em PHP

O primeiro passo é adicionar o código de programação em PHP responsável por renderizar o seletor de idioma em sua página. Para isso, você cria uma função que adiciona um contêiner div com o seletor de idioma dentro. Podemos usar a ação wpml_add_language_selector para renderizar o seletor de idioma.

Neste exemplo, queremos que o novo seletor de idioma seja exibido no rodapé, então usamos nossa nova função com o próprio hook wp_footer do WordPress.

O código de programação PHP completo fica assim:

Language switcher PHP
//WPML - Add a floating language switcher to the footer
 add_action('wp_footer', 'wpml_floating_language_switcher'); 
 
 function wpml_floating_language_switcher() { 
    echo '<div class="wpml-floating-language-switcher">';
        //PHP action to display the language switcher (see https://wpml.org/documentation/getting-started-guide/language-setup/language-switcher-options/#using-php-actions)
        do_action('wpml_add_language_selector');
    echo '</div>'; 
}

Você pode copiá-lo e adicioná-lo ao arquivo functions.php de seu tema (filho).

A parte de estilo

Com o código de programação anterior no lugar, já temos um novo seletor de idioma adicionado ao rodapé de nosso site. Agora, é hora de personalizá-lo para que ele flutue no canto inferior direito do site. É possível fazer isso usando o atributo CSS position: fixed.

Siga as etapas abaixo para adicionar o código de programação de CSS:

  1. Acesse WPML → Idiomas.
  2. Encontre mais abaixo na página as Opções do seletor de idioma e expanda a seção CSS adicional.

Outra opção é adicionar esse código de programação de CSS acessando Aparência → Personalizar e clicar em CSS adicional.

O exemplo a seguir acrescenta um pouco mais de personalização, como bordas arredondadas e sombra. É claro que você pode personalizar como quiser.

Language Switcher Styling
/*Removing some default CSS from our language switcher*/
.wpml-floating-language-switcher .wpml-ls-statics-shortcode_actions {
  margin-bottom: 0;
}
 
.wpml-floating-language-switcher  .wpml-ls-statics-shortcode_actions a {
  background-color: transparent !important;
}
 
.wpml-floating-language-switcher .wpml-ls-legacy-list-horizontal a {
  padding: 5px;
}
 
 
/*Customize this if you want*/
.wpml-floating-language-switcher {
  position: fixed;
  bottom: 10px;
  right: 10px;
  background: #f8f8f8; /*background color*/
  border: 1px solid; /*border settings*/
  border-color: #eee; /*color of the border*/
  padding: 0px; /*padding of container*/
  border-radius: 6px; /*rounded border*/
  /*Box Shadow*/
  -webkit-box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
  -moz-box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
  box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
}

A parte de configurações

Por fim, você precisa ajustar algumas configurações para que o seletor de idioma exiba apenas as bandeiras.

Siga as etapas a seguir:

  1. Acesse WPML → Idiomas.
  2. Encontre mais abaixo na página Seletores de idioma personalizados e clique em Habilitar.
  3. Clique no botão Personalizar.
  4. Em O que incluir no seletor de idioma, selecione Bandeira e desmarque as outras opções.
  5. Clique em Salvar.
Language switcher options
Exibição apenas da bandeira no seletor de idioma flutuante

E é isso! Agora você deve ter um seletor de idioma personalizado bem legal no site:

Horizontal language switcher
O seletor de idioma na interface do site

Bônus: seletor de idioma flutuante vertical

Outra opção que você também tem é criar um seletor de idioma vertical, como na captura de tela abaixo:

Vertical language switcher
Seletor de idioma vertical

Para isso, é só substituir o código de programação de CSS anterior pelo a seguir:

Vertical Language Switcher CSS
/*Removing some default CSS our language switcher*/
.wpml-floating-language-switcher .wpml-ls-statics-shortcode_actions {
  margin-bottom: 0;
}
 
.wpml-floating-language-switcher  .wpml-ls-statics-shortcode_actions a {
  background-color: transparent !important;
}
 
.wpml-floating-language-switcher .wpml-ls-legacy-list-horizontal a {
  padding: 5px;
}
 
.wpml-floating-language-switcher .wpml-ls-item {
  display: block;
}
 
/*Customize this if you want*/
.wpml-floating-language-switcher {
  position: fixed;
  bottom: 20px;
  right: 0px;
  background: #f8f8f8; /*background color*/
  border: 1px solid; /*border settings*/
  border-color: #eee; /*color of the border*/
  padding: 0px; /*padding of container*/
  border-radius: 6px 0 0 6px; /*rounded border*/
  /*Box Shadow*/
  -webkit-box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
  -moz-box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
  box-shadow: 2px 2px 5px 0px rgba(0,0,0,0.25);
  z-index: 999;
}