Plugins necessários e configuração inicial

Para usar o WooCommerce Multilingual é preciso ter, instalados e ativados, os seguintes plugins:

  • WPML 3.4 ou superior
  • WPML String Translation 2.0 ou superior
  • WPML Translation Management 2.2 ou superior
  • WooCommerce 2.1 ou superior

Se desejar usar itens de mídia (imagens) diferentes para as traduções dos produtos, é preciso instalar o WPML Media.

Se você estiver trabalhando com um programador, ele deve instalar e configurar todos os componentes necessários citados nesta seção.

Todos os componentes do WPML podem ser obtidos da sua conta no wpml.org em Downloads. O WooCommerce Multilingual e o WooCommerce ficam hospedados no repositório de plugins do WordPress. Já tem todos os plugins? Então, vamos começar!

Uso do instalador para baixar e atualizar o plugin com facilidade

O WooCommerce Multilingual tem um instalador integrado para baixar, ativar e atualizar todos os plugins necessários.

Após ativar o WooCommerce Multilingual, acesse a página Plugins e clique no botão Adicionar novo no topo. Aparecerá uma lista de plugins categorizados sob diferentes guias, como Em destaque, Populares, Recomendados, Favoritos e Comerciais.

Clique na guia Comerciais, e aparecerá a opção para comprar uma licença do WPML ou inserir a chave de site registrada, caso já tenha comprado o WPML. Assim que tiver comprado o plugin e registrado seu site através da página Conta, aparecerá uma lista de plugins disponíveis para download, ativação e atualização.

Guia Comerciais da página de plugins após registrar seu site
Guia Comerciais da página de plugins após registrar seu site

Uso do assistente de configuração

O WooCommerce Multilingual tem um assistente de configuração para ajudá-lo a realizar as etapas básicas de configuração do seu site com o plugin WooCommerce Multilingual.

Assim que ativar todos os plugins necessários, o assistente de configuração do WooCommerce Multilingual iniciará automaticamente.

Página inicial do assistente de configuração do WooCommerce Multilingual
Página inicial do assistente de configuração do WooCommerce Multilingual

Como pode ver na imagem acima, o assistente de configuração é muito parecido com o do WooCommerce. Ele o ajudará a configurar o seguinte: tradução das páginas da loja, seleção de atributos de produtos traduzíveis e ativação do modo de múltiplas moedas.

Configuração das páginas da loja

Você precisa ter as páginas padrão do WooCommerce aparecendo em todos os idiomas no seu site. O WooCommerce Multilingual fará isso automaticamente para você. Isso também é feito no assistente de configuração. Para fazer isso manualmente, acesse a página WooCommerce-> WooCommerce Multilingual e clique na guia Status. Se ainda não configurou as páginas da loja, haverá uma mensagem dizendo que as páginas de loja não existem e oferecendo a criação delas.

Status e alertas do WooCommerce Multilingual
Status e alertas do WooCommerce
Multilingual

O WooCommerce Multilingual criará essas páginas com a tradução disponível dos títulos das páginas. Você pode alterar os títulos das páginas nos diferentes idiomas mais tarde.

Nesta página também aparecem avisos sobre traduções faltando para termos de taxonomia. Se estiver usando taxonomia para variações de produtos ou para organizar produtos em categorias e tags, é excelente ter todas as taxonomias traduzidas.

Tradução de categorias de produtos, tags, atributos e taxonomias personalizadas

A maioria das lojas está organizada em categorias de produtos. Algumas também usam tags. Se estiver usando variações, provavelmente usa atributos de produto também. O WooCommerce Multilingual facilita a tradução de todos esses. Outra opção é configurar o WooCommerce Multilingual para exibir as tags, atributos e categorias originais dos produtos caso as traduções deles não estejam disponíveis. Primeiro, crie as tags, atributos e categorias dos produtos no idioma padrão usando a interface normal de edição do WooCommerce. Ao criar atributos, eles são marcados como traduzíveis por padrão. Você pode alterar essa opção para cada atributo sempre que quiser.

Não se preocupe ainda em traduzir categorias, tags e atributos. Dica: categorias de produtos, tags e atributos — todos esses são armazenados como taxonomias do WordPress. O WooCommerce Multilingual inclui uma interface prática para a tradução de termos de taxonomia. Acesse a página WooCommerce -> WooCommerce Multilingual. Desta vez, veja as outras guias na tela. Você verá uma guia para cada taxonomia que pertence à sua loja.

Tradução de atributos
Tradução de atributos

Cada uma destas guias corresponde a uma taxonomia diferente. Clique em uma guia para ver e traduzir todos os termos dessa taxonomia. Para traduzir um termo, clique em seu rótulo. Será preciso digitar o nome, slug e descrição. O nome é o que será exibido na tela. O slug aparece no URL e a descrição é exibida ao editar no painel de administrador do WordPress. Se sua loja tiver muitas categorias ou outros termos de taxonomia, use a função de pesquisa para localizá-los rapidamente.

Tradução de taxonomias personalizadas pela página do WooCommerce Multilingual

Desde a versão 3.9, o WooCommerce Multilingual lhe permite traduzir diretamente da página principal qualquer taxonomia personalizada associada a produtos do WooCommerce. Há muitos plugins para adicionar taxonomias personalizadas ao seu site, como o Toolset Types, por exemplo. Além disso, alguns plugins e temas adicionam automaticamente taxonomias personalizadas a produtos. Por exemplo, um tema chamado Adventure Tours cria uma taxonomia personalizada chamada “Tour Categories”, que você pode traduzir assim como qualquer outra taxonomia de produto personalizada.

Quando uma taxonomia personalizada estiver associada a produtos, uma guia chamada “Taxonomias Personalizadas” aparece na página WooCommerce -> WooCommerce Multilingual.

Tradução de taxonomia personalizada e seus termos
Tradução de taxonomia
personalizada e seus termos

Os termos da taxonomia podem ser traduzidos clicando no ícone “+” do idioma correspondente.

Note que, no momento, ainda não é possível traduzir os slugs de base das taxonomias personalizadas associadas a produtos.

Tradução de produtos

Agora que as taxonomias de produtos estão traduzidas, é hora de traduzir os produtos. Há duas opções para fazer isso. Uma delas é exibir apenas produtos traduzidos no site. A outra é exibir os produtos traduzidos, mas se não houver traduções, exibir os conteúdos do produto no idioma original. Nesse caso, apenas os conteúdos dos produtos são exibidos no idioma original, ao passo que o restante do site, como os menus e widgets continuam sendo exibidos do idioma atual. Saiba mais sobre isso na página sobre exibição de produtos não traduzidos em idiomas secundários. Crie primeiro os produtos no WooCommerce no idioma padrão ou em um dos secundários. Não se preocupe com a tradução deles por enquanto. Crie produtos normalmente como faz com o WooCommerce. Podem ser produtos padrão, produtos variáveis, produtos para download e qualquer outro tipo oferecido pelo WooCommerce.

Assim que seus produtos existirem, acesse a página WooCommerce -> WooCommerce Multilingual. Daí, comece na guia Produtos.

Guia de tradução de produtos listando todos os produtos
Guia de tradução
de produtos listando todos os produtos

A tabela de produtos lhe fornece um resumo de todos os produtos em seu site. Se tiver muitos produtos, use o filtro no topo da página e pesquise para encontrar os produtos exatos desejados. Cada idioma tem sua própria coluna com ícones de status da tradução. Eles ajudam a encontrar produtos que não estão traduzidos ou que precisam de atualização. Clique no ícone de caneta para editar as traduções existentes dos produtos ou no ícone de “mais” para traduzir o produto.

Editor de tradução de produtos
Editor de tradução de produtos

Você pode traduzir as informações do seu produto usando o editor de tradução de produtos ao qual você é conduzido. Você pode traduzir produtos do idioma em que foram criados para todos os outros idiomas definidos no seu site.

Tradução de add-ons de produtos

O WooCommerce Multilingual lhe permite traduzir campos adicionados a produtos por diversas extensões para WooCommerce. Todos os campos e opções adicionados aos produtos por extensões compatíveis ficarão automaticamente traduzíveis na página Tradução de produtos.

A imagem abaixo mostra a seção de add-ons de produtos encontrada na página de tradução de produtos.

Seção de add-ons de produtos na página de tradução de produtos
Seção
de add-ons de produtos na página de tradução de produtos

Para encontrar uma lista com todas as extensões do WooCommerce compatíveis com o WPML, acesse a página de extensões do wpml.org.

Tradução de variações de produtos

O WooCommerce Multilingual cria e sincroniza automaticamente as variações de produtos em todos os idiomas. Após criar uma variação no idioma padrão, salve o produto (no idioma padrão). O WooCommerce Multilingual criará imediatamente as mesmas variações para todas as traduções do produto. A tradução de variações de produtos pode ser feita de modo similar à tradução de produtos simples. Uma coisa que é específica em relação às variações são os atributos de produtos personalizados. Eles serão traduzidos na tela de tradução de produtos da mesma maneira que os campos personalizados são traduzidos para todos os produtos em geral.

Tradução de variações
Tradução de variações

Você também pode traduzir os títulos das imagens das variações. Se as variações usarem atributos de produto globais, eles precisam ser traduzidos nas guias de taxonomia correspondentes. Assim que tiver traduzido todos os atributos, poderá gerar automaticamente as variações dos produtos traduzidos.

Depois de terminar a tradução dos atributos, as variações relacionadas dos produtos em outros idiomas também precisam ser criadas. Isso é feito usando o botão Sincronizar atributos e atualizar variações de produtos na guia de atributos.

Tradução de textos de imagens

Assim como no caso das variações, o WooCommerce Multilingual sincroniza automaticamente todas as imagens entre traduções de produtos. Isso inclui a imagem em destaque, galeria de imagens e todas as imagens de variações. Após fazer upload ou selecionar diferentes imagens para o produto no idioma padrão, salve. Todas as traduções desse produto terão as mesmas imagens. Você pode editar os textos das imagens para traduções dos produtos na página de tradução de produtos, bem como todas as outras informações relacionadas a eles.

Tradução de textos de imagens
Tradução de textos de imagens

Dessa forma, são especificados título, legenda e descrição para as mesmas imagens em diferentes idiomas.

Tradução de URLs

Partes diferentes que compõem os URLs podem ser traduzidas com o WooCommerce Multilingual. Desde a versão 3.8, o WooCommerce Multilingual lhe permite traduzir strings de URL usando a seção específica para este fim. Caso prefira, ainda poderá usar a página String Translation do WPML para traduzir essas mesmas strings. Acesse a página WooCommerce -> WooCommerce Multilingual e clique na guia URLs da loja. Você verá uma lista de URLs e uma coluna com o status de tradução para cada idioma. Clique no ícone de caneta para editar as traduções existentes de URLs ou no ícone de “mais” para adicionar a tradução do URL.

Guia URLs da loja
Guia URLs da loja

As páginas da loja, carrinho, finalização de compra e de conta

Os URLs dessas páginas são traduzidos com a tradução das respectivas páginas do WooCommerce.

http://example.com/shop/ (inglês)

http://example.com/fr/boutique/ (francês)

Assim como outras bases relacionadas a URLs, a base do produto pode ser definida na tela de configurações de permalinks. Por padrão, o idioma de origem é o mesmo que o padrão do site, mas outros idiomas podem ser escolhidos, até mesmo aqueles que não pertencem ao site.

Configurações da base do produto e seu idioma de origem.
Configurações
da base do produto e seu idioma de origem.

A tradução da base de permalink de produto permite ter URLs como:

http://example.com/product/book (inglês)

http://example.com/fr/produit/livre (francês)

Tradução da base de produto
Tradução da base de produto

Base de categoria de produto

No exemplo abaixo, a base de categoria do produto “product-category” está traduzida como “categorie-produit”.

http://example.com/product-category/man (inglês)

http://example.com/fr/categorie-produit/homme (francês)

Base de tag de produto

No exemplo abaixo, a base de tag do produto “product-tag” está traduzida como “mot-cle-produit”.

http://example.com/product-tag/new (inglês)

http://example.com/fr/mot-cle-produit/nouveau (francês)

Base de atributo de produto

Outra opção é definir uma “base” da estrutura do URL para atributos. No exemplo a seguir, ela é “filters”.

http://example.com/filters/color/white/ (inglês)

http://example.com/fr/filtres/couleur/blanche/ (francês)

Slugs de atributo de produto

Desde a versão 3.9, o WooCommerce Multilingual lhe permite traduzir slugs de atributos. Abaixo há um exemplo de URLs que correspondem ao atributo “cor”.

http://example.com/filters/color/white/ (inglês)

http://example.com/fr/filtres/couleur/blanche/ (francês)

Você pode traduzir slugs de atributos através da seção URLs da loja no menu do WooCommerce Multilingual.

Tradução de slugs de atributo
Tradução de slugs de atributo

Observe que um atributo deve ser marcado como traduzível e ter arquivos habilitados para que um slug dele possa ser traduzido.

Tradução de endpoints do WooCommerce

Os “endpoints” são uma parte extra do URL que o WooCommerce detecta e usa para apresentar o conteúdo adequado na página.

Por exemplo, você talvez tenha a página seusite.com/minha-conta. Quando o endpoint “editar-conta” for acrescentado ao final desse URL, formando seusite.com/minha-conta/editar-conta, o WooCommerce mostrará a página “Editar Conta” em vez da “Minha Conta”.

Os endpoints foram adicionados no WooCommerce 2.1 a fim de simplificar o processo de instalação do WooCommerce. Endpoints também podem ser traduzidos através da guia URLs da loja.

Dois dos endpoints mais comuns são o endpoint da página de conta e os endpoints da página de pagamento. Há mais detalhes sobre os endpoints na documentação oficial do WooCommerce.

Tradução de classes e áreas de entrega

O WooCommerce lhe permite definir várias opções de entrega para seus produtos. É possível defini-las na página WooCommerce -> Configurações, na guia Entrega.

Tradução de classes de entrega

Classes de entrega lhe permitem agrupar itens de tipos parecidos. Por exemplo, você pode criar classes de entrega para pacotes pequenos, médios e grandes, com diferentes valores de entrega para cada um.

Após ter criado as classes de entrega no idioma padrão do site, elas serão reconhecidas automaticamente pelo WooCommerce Multilingual. Será possível traduzi-las na guia Classes de entrega da página WooCommerce -> WooCommerce Multilingual.

Página Classes de entrega no WooCommerce Multilingual
Página
Classes de entrega no WooCommerce Multilingual

Tradução de áreas de entrega

Você também pode definir áreas de entrega, que são usadas para agrupar áreas geográficas e selecionar diferentes valores e métodos de entrega para elas. Por exemplo, você poderia criar uma área de entrega chamada “Europa” e criar tarifas e métodos para calcular custos de encomendas enviadas para seus clientes europeus.

No caso das áreas de entrega, só há seus nomes para traduzir, o que é feito na página WPML -> String Translation. Use a função pesquisar no topo da página para encontrar a string da área de entrega, clique nela e traduza-a para outros idiomas usando as caixas de diálogo que aparecem.

Tradução de áreas de entrega
Tradução de áreas de entrega

Sincronização automática de estoque e de atributos de produtos

Quando um produto é vendido, o idioma da venda é irrelevante no gerenciamento de estoque. Defina seu estoque na configuração do produto no idioma padrão. O WooCommerce Multilingual atualiza automaticamente seu estoque à medida que os clientes compram em diferentes idiomas. O mesmo se dá com atributos de produto não textuais, como tamanho e peso. Você precisa inseri-los apenas no idioma padrão. O WooCommerce Multilingual os definirá igualmente para todos os produtos traduzidos.

Usar mais de uma moeda

Ativar múltiplas moedas

O WooCommerce Multilingual ajuda você a usar mais de uma moeda em seus sites.

Acesse WPML -> WooCommerce Multilingual e clique na guia Múltiplas moedas. É possível configurar tudo relacionado ao uso de mais de uma moeda: adicionar, definir as secundárias e suas propriedades, especificar preços diferentes para cada uma e alterar opções do seletor de moeda.

Opções de uso das várias moedas na guia de múltiplas moedas
Opções de uso das várias moedas na guia de múltiplas moedas

O modo de múltiplas moedas está desativado por padrão no WooCommerce Multilingual. Quando habilitado, é possível personalizar a formatação para cada moeda. Você pode até mesmo mostrar moedas específicas para determinados idiomas na interface.

Desde a versão 3.8 do WooCommerce Multilingual, também é possível, em moedas secundárias, definir manualmente preços para aqueles diferentes dos padrões do WooCommerce (normal e promoção). Isso permite a outras extensões (como a WooCommerce Subscriptions) não se basearem em preços determinados usando as taxas de câmbio para tipos de preço personalizados que definem. No caso da extensão WooCommerce Subscriptions, um preço extra para assinaturas simples é chamado de “Sign-up fee” (taxa de adesão).

Desde a versão 4.0 do WooCommerce Multilingual, é possível definir taxas de câmbio automáticas para sua loja. Você pode escolher dentre dois bem conhecidos serviços on-line para fornecer os dados das taxas de câmbio, especificar a frequência das atualizações automáticas delas e aplicar uma tarifa de operação.

Para informações detalhadas, acesse nossa documentação sobre o uso de múltiplas moedas em sites.

Criar seletores de moeda personalizados

O WCML permite aos programadores criar seletores de moeda personalizados, usando modelos simples do Twig. Assim, é possível criar seletores que combinam perfeitamente com o design de seus temas ou plugins.
Para informações detalhadas, acesse nossa documentação sobre criação de seletores de moeda personalizados.

Limpar conteúdo do carrinho ao trocar de idioma ou moeda

O WooCommerce Multilingual ajuda você a usar mais de uma moeda em seus sites. Você pode selecionar o que ocorre com os produtos no carrinho quando usuários trocam de idioma ou moeda. O conteúdo do carrinho pode ser sincronizado ou descartado. Por padrão, é feita a sincronização. Essa opção é importante pois permite a restauração do carrinho ao trocar de idioma ou moeda. Você deve fazer isso quando os produtos e suas opções não estiverem sendo sincronizados corretamente ao trocar de idioma ou moeda. Isso pode ocorrer com produtos de tipos complexos, como assinaturas e reservas, ou os que contêm opções avançadas como tabela de tarifas de entrega. Para informações detalhadas, acesse nossa documentação sobre limpar o conteúdo do carrinho ao trocar de idioma ou moeda.

Plugins suplementares úteis

Habilitando diferentes processadores de pagamento para diferentes países

Quando você tem um site de comércio eletrônico, pode precisar habilitar opções de pagamento diferentes para cada país. É possível fazer isso com o plugin WooCommerce Gateways Country Limiter, que é incluso na conta Multilingual CMS.

Escolha de países específicos nos quais permitir um gateway de pagamento
Escolha
de países específicos nos quais permitir um gateway de pagamento

Importação em massa de produtos

Nosso plugin WPML All Import é uma ferramenta muito útil para importar produtos de um arquivo CSV.

Uso da API REST do WordPress com o WooCommerce Multilingual

O WooCommerce Multilingual é compatível com a API REST do WordPress. Com a API REST, agora é possível criar, ler, atualizar e excluir conteúdo traduzido do WooCommerce. Isso inclui produtos, categorias, pedidos, entre outros.

Para saber mais sobre esse assunto, acesse nossa página de documentação de API REST do WordPress.

Uso de hooks do WooCommerce Multilingual

O WooCommerce Multilingual tem um conjunto de ações e filtros que programadores pode usar para fazer seus temas e plugins funcionarem harmoniosamente no ambiente multilíngue. Para saber mais sobre esse assunto, acesse nossa página de documentação de Relação de Hooks do WCML.

Desenvolvendo temas personalizados do WooCommerce?

Se estiver desenvolvendo seus próprios temas do WooCommerce ou realizando personalizações significativas a temas já existentes, é preciso garantir que funcionem bem em vários idiomas. Para ajudá-lo, preparamos um tutorial completo sobre como criar temas multilíngues e compatíveis com múltiplas moedas para WooCommerce.