Skip Navigation
Início » Documentação » Projetos relacionados » WooCommerce Multilingual — sites com WooCommerce em vários idiomas com facilidade

Plugins necessários e configuração inicial

Para usar o WooCommerce Multilingual é preciso ter, instalados e ativados, os seguintes plugins:
  • WPML 4.0 ou superior
  • WPML String Translation 2.8 ou superior
  • WPML Translation Management 2.6 ou superior
  • WooCommerce 3.3.0 ou superior
Se desejar usar itens de mídia (imagens) diferentes para as traduções de um produto, é 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 na parte superior. 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 será iniciado 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 taxonomias para variações de produtos ou para organizar produtos em categorias e tags, seria muito bom ter todas as taxonomias traduzidas. [/]

Tradução das páginas do carrinho e de finalização de compra

A tradução das páginas de finalização de compra e de carrinho do WooCommerce é um pouco diferente daquela do restante do conteúdo do WooCommerce. O tema e plugins de seu site muitas vezes fornecem essas traduções, mas em alguns casos, você precisará realizar algumas etapas adicionais. [/]

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, olhe para 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. Assim que alguma taxonomia personalizada fica 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, 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. Você pode criar 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. Então, 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 exatamente os que procura. 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 “+” 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, a tradução precisa ser feita 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 as 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 “+” 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” (ou, “filtros”). 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 “color” (ou, “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”, ou pontos de extremidade, 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 ao 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. Entre os endpoints mais comuns estão o endpoint da página de conta e os da página de finalização de compra. Há mais detalhes sobre os endpoints na documentação oficial do WooCommerce. [/]

Tradução de classes 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. 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. Elas poderão ser traduzidas 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
[/]

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 quando 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

Habilitar 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 diferentes daqueles padrões do WooCommerce (normal e promoção). Isso permite que outras extensões (como a WooCommerce Subscriptions) não se baseiem 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.

Criação de 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, ele é sincronizado. 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 limpeza do conteúdo do carrinho ao trocar de idioma ou moeda. [/]

Plugins suplementares úteis

Habilitação de 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 da API REST do WordPress. [/]

Uso de hooks do WooCommerce Multilingual

O WooCommerce Multilingual tem um conjunto de ações e filtros que programadores podem usar para fazer seus temas e plugins funcionar 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. [/]

Informações para desenvolvedores de temas para WooCommerce

Se estiver desenvolvendo seus próprios temas para WooCommerce ou realizando personalizações significativas de 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. [/]
Originalmente escrito em
setembro 14, 2014
Atualizado
fevereiro 28, 2020