Plugins necessários e configuração inicial

Para usar o WooCommerce Multilingual, você precisa ter os seguintes plugins instados e ativados:

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

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

Você pode obter todos os componentes WPML de sua conta wpml.org, sob Downloads. O WooCommerce Multilingual e o WooCommerce se encontram no repositório de plugins do WordPress. Já tem todos os plugins? Então vamos começar!

Usando o instalador para baixar e atualizar o plugin com facilidade

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

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

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

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

Usando o 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 similar ao do próprio WooCommerce. Ele o ajudará a configurar os seguintes itens: traduzir páginas da loja, selecionar atributos de produto traduzíveis e habilitar o 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 você ainda não configurou as páginas da loja, haverá uma mensagem dizendo que as páginas da loja não existem e propondo 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, você verá também avisos sobre traduções faltando para termos de taxonomia. Se você estiver usando taxonomia para variações de produtos ou para organizar os produtos em categorias e tags, seria muito importante ter todas as taxonomias traduzidas.

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

A maioria das lojas está organizada em categorias de produtos. Algumas também usam tags. Se você estiver usando variações, provavelmente esteja usando atributos de produtos também. O WooCommerce Multilingual facilita a tradução de todos esses.

Primeiro, crie as categorias, tags e atributos de produtos no idioma padrão, usando a interface de edição padrão do WooCommerce. Ao criar atributos, por padrão estes são marcados como traduzíveis. Você pode alterar essa opção para cada atributo sempre que quiser. Não se preocupe com a tradução de categorias, tags e atributos por enquanto.

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
Traduzindo 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. Você precisará inserir 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 a sua loja tem muitas categorias, ou outros termos de taxonomia, use a função pesquisar para localizar estes itens 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.

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, não é possível traduzir os slugs de base das taxonomias personalizadas associadas a produtos.

Tradução de produtos

Agora que as taxonomias dos seus produtos estão traduzidas, é hora de traduzir os produtos. Primeiro, crie os produtos no WooCommerce no idioma padrão ou então em um dos idiomas secundários. Não se preocupe com a tradução deles por enquanto. Crie os produtos normalmente no WooCommerce, como de costume. 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. 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 você tem muitos produtos, use um filtro no topo da página e pesquise para encontrar os produtos específicos que está procurando. 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 suplementos de produtos

O WooCommerce Multilingual lhe permite traduzir campos adicionados a produtos por diversas extensões do WooCommerce. Todos os campos e opções que extensões compatíveis adicionarem aos seus produtos serão automaticamente traduzíveis na página de tradução de produtos.

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

Seção de suplementos de produtos na página de tradução de produtos
Seção de suplementos de produtos na página de tradução de produtos

Para encontrar uma lista completa de todas as extensões do WooCommerce que são 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. Depois de 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
Traduzindo variações

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

Após a conclusão da tradução de 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

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

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

Assim, você pode especificar o título, a legenda e a descrição para as mesmas imagens em idiomas diferentes.

Tradução de URLs

Partes diferentes que compõem os URLs podem ser traduzidas com o WooCommerce Multilingual. A partir da versão 3.8, o WooCommerce Multilingual lhe permite traduzir URLs usando sua própria seção específica para traduzir strings de URL. 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 de loja, carrinho, pagamento e 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 as outras bases de URL relacionadas, a base de produto pode ser definida na tela de configurações de permalinks. Por padrão, o idioma de origem delas é o mesmo idioma padrão do site, mas pode ser definido para idiomas diferentes, até mesmo idiomas que não estão no site.

Configuração da base do produto e seu idioma de origem.
Configuração 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
Traduzindo a 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 uma página seusite.com/minha-conta. Quando o endpoint “editar-conta” é acrescentado a esse URL, transformando-o em seusite.com/minha-conta/editar-conta, o WooCommerce mostrará a página “Editar conta” em vez da página “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. 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 você vende um produto, o idioma da venda não é relevante para o gerenciamento do 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 aplica a 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. Você pode configurar tudo relacionado às múltiplas moedas: moedas secundárias e suas propriedades, adicionar mais moedas, definir preços diferentes para moedas diferentes, alterar as 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. Assim que ele é ativado, você pode configurar opções de formatação personalizada para cada moeda. Você pode até mesmo mostrar moedas específicas para determinados idiomas no front-end.

Desde o lançamento da versão 3.8 do WooCommerce Multilingual, também é possível definir preços manualmente em moedas secundárias para preços diferentes dos preços-padrão do WooCommerce (preço normal e promocional). 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 as assinaturas simples é chamado de “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 três 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 como usar múltiplas moedas em seus 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. É possível selecionar o que ocorre com os produtos no carrinho quando os usuários trocam de idioma ou de 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 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 internacional de comércio eletrônico, você talvez precise habilitar diferentes opções de pagamento para países diferentes. Você pode fazer isso usando o plugin WooCommerce Gateways Country Limiter (limitador de gateways por país), que está incluso no pacote 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.

Usar a API REST do WordPress com o WooCommerce Multilingual

O WooCommerce Multilingual é compatível com a API REST do WordPress. Usando a API REST, agora você pode criar, ler, atualizar e excluir conteúdos do WooCommerce. Isso inclui produtos, categorias, pedidos, entre outros.

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

Uso de hooks do WooCommerce Multilingual

O WooCommerce Multilingual tem um conjunto de ações e filtros que os programadores podem 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.

Está desenvolvendo temas personalizados para WooCommerce?

Se você estiver desenvolvendo seus próprios temas do WooCommerce, ou fazendo grandes adaptações a temas existentes, você deve se certificar de que eles funcionem bem em diversos idiomas.

Para ajudar você, preparamos um tutorial completo sobre como fazer temas do WooCommerce compatíveis com diversos idiomas e moedas.