Este guia mostrará a você como criar temas multilíngues para WordPress. Um tema multilíngue é mais do que apenas envolver todos os textos em chamadas GetText e fornecer um arquivo .mo. A localização dos textos do tema é uma etapa importante, mas há outras coisas que precisam ser feitas.
Um tema para um site multilíngue precisa mostrar os idiomas disponíveis, permitir a seleção do idioma a ser exibido e exibir corretamente em cada idioma.
Essas são as coisas que precisaremos fazer:
- Fornecimento de localização para diferentes idiomas.
- Permitir que os usuários mudem de um idioma para outro.
- Retornar o conteúdo correto por idioma.
- Informar ao WPML o que precisa ser traduzido.
Preparando o tema para tradução
Para que o tema seja exibido em diferentes idiomas, os textos precisam passar pela tradução antes de serem exibidos. WordPress usa o GetText para isso, assim como seu tema.
Escrevemos uma postagem sobre a localização de temas WordPress. Ele explica como envolver os textos do tema em chamadas GetText, criar traduções (arquivos .mo) e aplicá-las ao tema.
Alternar entre diferentes idiomas
Um alternador de idiomas mostra aos visitantes quais idiomas estão disponíveis e permite que eles escolham.
Os alternadores de idioma podem ser de diferentes formas. Algumas pessoas preferem um menu suspenso compacto com nomes de idiomas. Outros exibem bandeiras de países e outros mostram listas horizontais ou verticais de idiomas.
WPML facilita a implementação de seletores de idiomas. Ele vem integrado com seu próprio seletor de idioma suspenso, que também pode ser incluído como um widget. Esse alternador de idiomas pode exibir bandeiras de países, nomes de idiomas e suas traduções. Você pode configurá-lo no menu WPML>Languages.
Você também pode criar seu próprio alternador de idiomas personalizado e inseri-lo em diferentes locais do tema. A página de manual do seletor de idioma personalizado explica como você pode criá-lo e fornece exemplos de usos comuns. Adicionar um seletor de idioma personalizado ao seu tema pode acrescentar brilho e elegância e tornar óbvio para os usuários que o tema foi criado para sites multilíngues.
Obter conteúdo no idioma certo
Muitos temas incluem links codificados para páginas, categorias e tags.
WPML se conecta às funções padrão da API WordPress e as filtra por idioma.
Por exemplo, quando você liga:
$args = array( 'category' => 1 );
$myposts = get_posts( $args );
Suponha que a categoria “1” seja uma categoria em inglês e a tradução para o espanhol seja a categoria “4”. Quando você visualizar uma página em espanhol e executar esse código, WPML substituirá o número da categoria no filtro por “4”.
Para que isso aconteça, seu código deve usar apenas as chamadas da API WordPress e não consultar manualmente o banco de dados (o que é uma prática ruim por si só).
Você pode controlar essa funcionalidade no WPML>Languages. Procure a opção para ajustar automaticamente as IDs.
Informando ao WPML o que precisa ser traduzido
WPML pode ler um arquivo de configuração de idioma. Esse arquivo informa tudo o que você precisa saber sobre o seu tema.
Isso inclui textos de administração, campos personalizados e tipos personalizados que você está usando.
Depois que você criar esse arquivo XML, WPML se configurará automaticamente e permitirá que os usuários executem um site multilíngue sem clicar em uma única tela de configuração.