Traduza produtos importados do WooCommerce: CSV, API, ERP
Mantenha um catálogo multilíngue do WooCommerce sincronizado quando os produtos chegam por importação de CSV, WP All Import, pela API REST ou por uma sincronização de ERP.
Atualizado: 16 de novembro de 2026
Este guia é para lojas cujo catálogo fica fora do WordPress: em uma planilha, um PIM, um ERP ou um feed de fornecedor. Os produtos chegam ao WooCommerce por meio de um importador, pela API REST ou por uma tarefa agendada, e você raramente abre o editor de produtos.
Parte 1. Como funciona uma loja multilíngue gerenciada externamente
Um produto por idioma, vinculado por um grupo de tradução
Cada idioma tem seu próprio produto do WooCommerce, com seu próprio ID. O WPML vincula os idiomas em um grupo de tradução. O original é o produto no idioma padrão da sua loja; os outros idiomas são as suas traduções.
Na nossa loja de exemplo, o Zip-Up Hoodie é o produto 14 em inglês, 121 em alemão e 122 em francês. Toda resposta da API REST para qualquer um deles carrega o mesmo mapa: "translations": {"de":"121","en":"14","fr":"122"}.
O SKU é o mesmo em todos os idiomas. As variações de um produto variável também mantêm os mesmos SKUs de variação.
O SKU é a chave para o seu sistema externo. A própria busca do WooCommerce, wc_get_product_id_by_sku(), retorna o produto original, não uma tradução.
As listas retornam um idioma por vez.GET /wc/v3/products?sku=HP-HD-ZIP retorna apenas o idioma padrão. Adicione &lang=de para um idioma, ou &lang=all para todos os idiomas.
O que o WPML copia para todos os idiomas e o que ele traduz
Quando o produto original muda, por meio do editor de produtos, de uma importação de CSV ou da API REST, o WPML copia esses valores para todas as traduções:
Preço normal e preço promocional
Quantidade em estoque e status do estoque
SKU, peso e dimensões
Imagem do produto e galeria (cada idioma recebe sua própria cópia da imagem)
Categorias e tags (como a categoria ou tag traduzida)
Upsells e vendas cruzadas (apontando para o produto no mesmo idioma)
Status de publicação
Para produtos variáveis: o preço e o estoque de cada variação, a faixa de preço, um novo termo de atributo global (como sua tradução, por exemplo, Schwarz e Noir para Black) e uma nova variação
Estes permanecem diferentes em cada idioma, porque são traduzidos:
Nome, descrição e descrição curta
Slug (o endereço do produto, por exemplo, /de/produkt/kapuzenjacke-mit-reissverschluss/)
Termos de atributo, como Blue, Blau e Bleu
Valores de atributos específicos do produto, como um “Material” definido apenas neste produto
O estoque é compartilhado por todos os idiomas.
Grave os preços e atributos no original. Se o seu sistema gravar um preço ou atributos em uma tradução, a tradução manterá os valores do original. O estoque gravado em qualquer idioma se torna o estoque de todos os idiomas, porque ele é compartilhado.
Os preços em uma segunda moeda também seguem o original (veja multimoeda para WooCommerce). Defina-os no original, com custom_prices na API REST ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) ou com as colunas CSV Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD e Meta: _price_USD. Em seguida, cada idioma mostra esses preços nessa moeda.
custom_prices é armazenado quando o recurso multimoeda está ativado e a moeda é uma das moedas da sua loja. Envie-o da seguinte forma:
Ative o recurso multimoeda primeiro. Vá para WPML → Configurações → Multimoeda, marque Ativar o modo multimoeda e clique em Salvar alterações. Em Mostrar moedas baseadas em, escolha uma opção (por exemplo, Idioma do site) e clique em Salvar alterações. Em seguida, adicione cada moeda com Adicionar moeda. Com o recurso multimoeda desativado, o WPML não armazena nada de custom_prices.
Use os códigos de moeda da sua loja. O WPML armazena apenas os preços das moedas da loja. Um preço em qualquer outro código não é armazenado.
Para um produto variável, envie custom_prices em cada variação, não no produto pai. O WPML o armazena na variação original, e todos os idiomas o mostram. Se enviado no produto pai, ele não é armazenado.
Leia os preços armazenados de meta_data (_regular_price_USD, _sale_price_USD, _price_USD). As respostas às chamadas REST não incluem um campo custom_prices.
Duplicatas ou traduções independentes
O WPML tem dois tipos de produto traduzido. O tipo que você tem decide o que acontece com o texto que você importa.
Duplicata
Tradução independente
O que é
Uma cópia que o WPML mantém
Uma tradução com seu próprio texto
Texto após o próximo salvamento do original
Substituído pelo texto do original
Mantido apenas com o Traduzir tudo desativado ou com Produtos definido como Nenhum
Preço e estoque
Seguem o original
Seguem o original
Onde você o vê: a caixa Idioma de uma duplicata exibe “This document is a duplicate of ... and it is maintained by WPML.” com o botão Traduzir independentemente.
Como transformar duplicatas em traduções independentes: clique em Traduzir independentemente na caixa Idioma da duplicata ou, para muitos produtos, vá para Produtos → Todos os produtos, mude para o idioma da tradução, marque os produtos e escolha Ações em massa → Traduzir independentemente.
O que os processos da Parte 2 criam: o Processo A cria traduções com o Traduzir tudo. O Processo B importa traduções independentes. Nenhum deles precisa de duplicatas.
Configure a loja antes que o primeiro produto chegue
Execute o assistente de configuração do WooCommerce Multilingual. Ele abre quando você ativa o WPML Multilingual & Multicurrency for WooCommerce. Suas telas são Store Pages, Global Attributes e Multiple Currencies. A primeira cria as páginas Loja, Carrinho, Checkout e Minha conta em todos os idiomas.
Torne seus atributos globais traduzíveis. Na tela do assistente “Which product attributes should be translatable?”, marque cada atributo, por exemplo, Cor e Tamanho. Mais tarde, a mesma configuração é a caixa de seleção Traduzível? em Produtos → Atributos → Editar.
Traduza os termos de atributos antes dos produtos. Vá para WPML → Traduções, abra a aba Taxonomia, escolha o atributo em “Select the taxonomy to translate” e traduza cada termo. Com o Traduzir tudo ativado (Processo A), o WPML traduz os novos termos para você.
Parte 2. Construa sem código
Escolha seu processo: um idioma ou todos os idiomas
O WPML marca a tradução como precisando de atualização; seu próximo arquivo traz o novo texto
Preços e estoque
Seguem o original
Seguem o original
O Processo A é adequado para uma loja que mantém um idioma e quer todos os outros idiomas sem arquivos de tradução. O Processo B é adequado para uma loja cujo PIM ou tradutores já possuem os textos em todos os idiomas.
Processo A com o importador de CSV do WooCommerce ou o WP All Import
Ative o Traduzir tudo uma vez:
Vá paraWPML → Traduções e clique em Configurar o Traduzir tudo.
Escolha o conteúdo. Em “Content to Translate”, mantenha All products e clique em Continue.
Escolha como as traduções são publicadas. Em “Publishing method”, mantenha Publish without review.
Clique em Ativar Traduzir tudo automaticamente.
Importe seus produtos apenas no idioma padrão da loja. Use Produtos → Importar (importador de CSV do WooCommerce) ou All Import → New Import (WP All Import com seu complemento para WooCommerce). Seu arquivo não precisa de colunas do WPML.
A própria importação coloca as traduções na fila. O WPML então traduz cada produto, variação, categoria e novo termo de atributo para cada idioma e os publica. Você não inicia nada manualmente, e nenhuma página do painel de administração do WPML precisa estar aberta. Você pode acompanhar o progresso em WPML → Traduções.
Quando você edita um original, o Traduzir tudo traduz apenas o que mudou. O restante da tradução permanece palavra por palavra.
O Traduzir tudo traduz produtos publicados, incluindo produtos externos. Ele não traduz produtos privados. Os rascunhos também aguardam: Translate drafts automatically (em WPML → Configurações → Tradução por IA, na caixa Editor de tradução avançado) está desativado por padrão e, quando você o ativa, o WPML traduz um rascunho apenas quando você o salva novamente. Para traduzir rascunhos e produtos privados, envie-os a partir de WPML → Traduções (consulte Solução de problemas).
Se você quiser alterar uma tradução, abra-a na caixa Idioma do produto (Edit the ... translation), edite-a no Editor de tradução avançado e clique em Save and Complete. Quando o original mudar mais tarde, sua edição das frases inalteradas permanecerá.
Processo B com o importador de CSV do WooCommerce
No Processo B, seu arquivo contém todos os idiomas.
Configure o Traduzir tudo para traduções importadas antes da primeira importação:
Vá paraWPML → Traduções. Se o Traduzir tudo estiver desativado, deixe-o desativado e vá para o arquivo.
Se você quiser que o WPML traduza suas páginas, posts e strings automaticamente, clique em Configurar o Traduzir tudo. Em “Content to Translate”, defina Products como None. Clique em Continue, mantenha Publish without review e clique em Ativar Traduzir tudo automaticamente.
Se o Traduzir tudo já estiver ativado, clique no menu de três pontos na caixa “Translate Everything Automatically is enabled”, escolha Adjust content limits, defina Products como None e clique em Save changes. As traduções já em andamento ainda serão concluídas.
Com Products definido como None, o WPML mantém as traduções de produtos importadas palavra por palavra. Quando um original muda, o WPML marca suas traduções como precisando de atualização, e seu próximo arquivo traz o novo texto.
Prepare um arquivo com todos os idiomas. Use as colunas normais do WooCommerce e adicione quatro colunas do WPML:
Coluna
O que ela contém
Exemplo
Meta: _wpml_import_translation_group
O valor que vincula os idiomas. Use o SKU.
HP-JK-SHELL
Meta: _wpml_import_language_code
O idioma da linha
de
Meta: _wpml_import_source_language_code
O idioma do original, que é o idioma padrão da loja. Vazio nas linhas originais.
en
Meta: _wpml_import_after_process_post_status
O status depois que o WPML vincula os produtos
publish
Ordene as linhas por idioma, originais primeiro. Em cada idioma, os produtos vêm antes de suas variações.
Importe produtos como rascunhos:Published = -1 nos produtos, 1 nas variações.
Dê a cada idioma seus próprios textos: nomes, descrições, categorias (Kleidung > Jacken) e valores de atributos (Blau, Grün).
Mantenha os nomes dos atributos da loja (Color, Size) em todos os idiomas. Traduza os rótulos dos atributos em WPML → Traduções → Taxonomia.
Forneça os produtos relacionados e produtos pai por SKU, o mesmo SKU em todos os idiomas.
Uma linha em alemão de um produto variável do nosso arquivo de exemplo:
Vá paraProdutos → Importar e escolha o arquivo em “Escolha um arquivo CSV do seu computador:”. Deixe Atualizar produtos existentes desmarcado. Clique em Continuar.
Verifique o mapeamento. As quatro colunas Meta: são mapeadas para Importar como metadados. Clique em Executar o importador.
Vá paraWPML → Exportação e importação. A tela exibe “Good job. We see 33 posts that are imported and need language information.”. Clique em Run WPML Import.
Aguarde por “Multilingual Import Complete”.
Até a etapa 3, cada produto é um rascunho em inglês e cada variação é uma variação em inglês, nenhum deles vinculado ao seu original. Depois dela:
Cada produto e cada variação está vinculado em todos os seus idiomas.
Tudo é publicado.
As traduções são traduções independentes.
Categorias e termos de atributos são vinculados entre os idiomas, e as variações de cada idioma usam seus próprios termos.
As vendas agregadas apontam para o produto no mesmo idioma, e cada idioma tem sua própria cópia das imagens.
As categorias e os termos de atributos viajam dentro das linhas do produto, portanto, esse importador não precisa de uma importação de taxonomia separada. Se já existirem termos de atributos traduzidos na loja, o importador os usará, e o Run WPML Import os conectará aos seus originais.
Para que o WPML traduza os produtos escolhidos automaticamente enquanto Produtos estiver definido como Nenhum:
Mantenha o Traduzir tudo ativado.
Adicione a coluna Meta: _wpml_import_tea ao arquivo, com o valor 1 em cada produto a ser traduzido.
Mantenha Meta: _wpml_import_translation_group no mesmo arquivo.
Importe o arquivo, depois vá para WPML → Exportação e importação e clique em Run WPML Import. A lista de progresso mostra “Sending Posts for Automatic Translation”, e o WPML traduz e publica esses produtos.
Processo B com o WP All Import
Você precisa do WP All Import Pro e de seu complemento para WooCommerce. A edição gratuita não importa campos personalizados, e as colunas do WPML são campos personalizados.
A ordem de trabalho é: primeiro os termos de atributos, com suas traduções conectadas, depois os produtos. As páginas de produtos traduzidas então oferecem cada valor de atributo em seu próprio idioma, por exemplo, Bleu marine e não Navy.
Conecte os termos traduzidos que a loja já tem. Para cada termo de atributo traduzido que já existe na loja, vá para Produtos → Atributos, clique em Configurar termos para o atributo, mude a barra do painel de administração para o idioma do termo e clique no nome do termo. Na caixa Idioma, escolha seu original em Esta é uma tradução de e clique em Atualizar. Cada termo conectado então mostra um lápis sob seu idioma em WPML → Traduções → Taxonomia.
Defina o idioma do painel de administração para o idioma padrão da loja no seletor de idiomas da barra do painel de administração antes de executar as importações.
Importe as categorias. Em All Import → New Import → Upload a file, escolha Taxonomias → Categorias de produto. Em Metadado de termo, adicione três linhas: _wpml_import_language_code, _wpml_import_source_language_code e _wpml_import_translation_group, cada uma mapeada para a coluna de mesmo nome do arquivo. Defina o ascendente em Other Category Options → Parent Term.
Importe os termos de atributos da mesma forma, por exemplo, Taxonomias → Product Color, com as mesmas três linhas de Metadado de termo.
Conecte os termos. Vá para WPML → Exportação e importação e clique em Run WPML Import. Verifique em WPML → Traduções → Taxonomia (escolha a taxonomia em “Select the taxonomy to translate”) se cada termo tem uma linha com um lápis sob a bandeira de cada idioma. Passe o mouse sobre um lápis para ver o nome traduzido. Um “+” significa que o idioma não tem tradução. Um termo traduzido listado em sua própria linha não está conectado.
Importe os produtos. Escolha WooCommerce Products. Na seção WooCommerce Add-On, mapeie o SKU, os preços, o estoque e os atributos. Em Campos personalizados, adicione as três linhas _wpml_import_*.
Execute Run WPML Import novamente e aguarde por Multilingual Import Complete.
Duas configurações para um arquivo de produto que contém todos os idiomas:
As linhas de variação carregam o tipo variable, o mesmo que seu ascendente, na coluna que você mapeia para Set Product Type With XPath.
Vincule as variações ao seu ascendente com uma chave por idioma. Em Variations, escolha All my variable products have SKUs or some other unique identifier... e mapeie SKU element for parent e Parent SKU element for variation para uma chave como HP-OW-RAIN-de. Mapeie o SKU real, o mesmo em todos os idiomas, para Geral → SKU e para o grupo de tradução. A outra maneira é uma importação por arquivo de idioma.
Essa ordem funciona quer você inicie as importações do WP All Import a partir do wp-admin, do WP-CLI ou de forma programada.
Atualize o estoque e os preços de forma programada
Atualize os produtos originais. O WPML copia o estoque e os preços para todos os idiomas imediatamente.
Com o importador de CSV do WooCommerce:
Envie apenas as colunas que você alterar. Uma coluna com uma célula vazia grava um valor vazio. Nosso arquivo de exemplo:
Adicione Meta: _wpml_import_language_code com o idioma do original em cada linha. Assim, cada linha atualiza o produto naquele idioma, o original. Sem a coluna, uma linha atualiza o produto no idioma atual do painel de administração, de modo que o resultado depende do seletor de idiomas do painel de administração.
Defina o idioma do painel de administração para o idioma padrão da loja no seletor de idiomas da barra do painel de administração.
Vá paraProdutos → Importar, escolha o arquivo, marque Atualizar produtos existentes, clique em Continuar e em Executar o importador.
Logo após a importação, todos os idiomas mostram o novo estoque, os preços e a faixa de preço.
Com o WP All Import, de forma programada:
All Import → Nova importação → Baixar um arquivo → Do URL, com o URL do feed do seu fornecedor. Escolha Produtos do WooCommerce.
Mapeie o SKU, Preço normal e Quantidade em estoque na seção do complemento WooCommerce.
Nas Configurações de importação, marque Tentar corresponder a produtos existentes do WooCommerce antes de criar novos e faça a correspondência por Campo personalizado_sku. Desative Criar novos produtos do WooCommerce a partir de registros recém-presentes neste arquivo de importação. Ative Atualizar produtos existentes do WooCommerce com os dados neste arquivo de importação.
Em Escolher quais dados atualizar, desative tudo, exceto Campos personalizados, e escolha Atualizar apenas estes Campos personalizados, deixar o resto como está: _regular_price, _price, _stock, _manage_stock.
Agende. Em All Import → Gerenciar importações → Opções de agendamento, o Agendamento manual mostra um URL de gatilho e um URL de processamento para o cron job do seu servidor.
Cada execução corresponde as linhas aos produtos originais, e todos os idiomas recebem os novos preços e estoque de cada produto e variação.
Se um arquivo completo do Processo B for importado novamente como uma atualização, defina Published como 1 em cada linha. Caso contrário, os produtos publicados irão para Rascunho até você executar a Importação do WPML. Marque Atualizar produtos existentes e, em seguida, clique em Executar importação do WPML. Os produtos permanecem publicados, e os textos no arquivo substituem as traduções imediatamente.
Adicione um idioma a um catálogo que você já tem
Processo A:
Vá paraWPML → Idiomas, clique em Gerenciar e ocultar idiomas do site, use Pesquisar e adicionar um idioma... e escolha o idioma.
Clique em Calcular custos. A caixa de diálogo "Custo para traduzir seu conteúdo para..." lista os itens e as palavras. Clique em Salvar.
O Traduzir tudo inicia o novo idioma sozinho, na próxima vez que uma página do painel de administração do WPML for carregada. O WPML traduz e publica cada produto e variação no novo idioma. Seus idiomas existentes não são afetados.
Processo B:
Prepare um arquivo apenas com as linhas do novo idioma. Use o SKU como o grupo de tradução, o idioma do original como o idioma de origem, Published = -1 e publish como o status final.
Vá paraWPML → Exportação e importação do WPML e clique em Executar importação do WPML.
Cada novo produto e variação se junta ao grupo de tradução do seu original, correspondido pelo SKU. Isso funciona em qualquer catálogo, inclusive em um que nunca foi importado. O novo idioma recebe suas próprias categorias e termos de atributos a partir do arquivo.
Atualizar produtos existentes não adiciona um idioma: o importador ignora essas linhas. Ele lista cada produto no novo idioma com "Nenhum produto correspondente existe para atualizar." e cada variação no novo idioma com "Uma nova variação não pode ser criada sem um produto pai."
Importe catálogos grandes
Importe um arquivo por idioma, os originais primeiro.
Execute a importação do WPML uma vez, após o último arquivo.
Para execuções longas, use o WP-CLI:wp wpml import process executa a mesma etapa que o botão e mostra a contagem de cada etapa.
Quanto tempo leva, a partir do nosso laboratório, com o importador do WooCommerce e um Executar importação do WPML para um catálogo em três idiomas:
Produtos por idioma
Importação inteira
Dessa parte, Executar importação do WPML
500
cerca de meia hora
alguns minutos
1.000
cerca de uma hora
cerca de 10 minutos
2.000
cerca de duas horas
cerca de meia hora
Cada tamanho foi concluído de uma só vez, com cada produto e variação presente e conectado em todos os idiomas. Cada número é uma execução em um servidor de laboratório compartilhado. A maior parte do tempo é do importador do WooCommerce, e isso depende do seu servidor. Leia esses números como uma ordem de grandeza.
Exporte produtos com seus idiomas (WP All Export)
O WP All Export adiciona as colunas do WPML _wpml_import_language_code, _wpml_import_source_language_code e _wpml_import_translation_group a uma exportação de Produtos do WooCommerce por padrão. Sua seção WPML exporta todos os idiomas ou apenas um. Exportações executadas manualmente e de forma programada preenchem as colunas. Leia mais em Exportar sites multilíngues usando o WP All Export.
Sincronize a partir de um ERP ou PIM
Um ERP (sistema de planejamento de recursos empresariais) é o software onde uma empresa mantém o estoque, os preços e os pedidos. Um PIM (sistema de gerenciamento de informações de produtos) é onde ela mantém os textos e dados dos produtos.
Um conector entre esse tipo de sistema e o WooCommerce normalmente:
Mantém o catálogo indexado por SKU, em um idioma
Encontra cada produto pelo SKU (GET /wc/v3/products?sku=...)
Atualiza o estoque e os preços de produtos existentes, e cria novos produtos, por meio da API REST do WooCommerce
É executado de forma programada
Este é o fluxo que funciona com o WPML:
O conector grava apenas no idioma padrão da loja.
O WPML copia o estoque e os preços para todos os idiomas na mesma requisição.
O Traduzir tudo traduz novos produtos para todos os idiomas (Processo A).
Um produto que o conector define como rascunho muda para rascunho em todos os idiomas.
Um produto que o conector exclui segue WPML → Configurações → Excluir conteúdo, linha Produtos. Ninguém é consultado durante uma sincronização, portanto, defina Excluir um original para o comportamento que você quer: Excluir todos os idiomas remove as traduções junto com ele; Apenas esse as mantém publicadas.
Faça três perguntas ao fornecedor do seu conector:
Ele grava por meio do WooCommerce ou direto no banco de dados? As alterações gravadas direto no banco de dados chegam apenas ao original. As traduções mantêm o estoque e os preços antigos.
Em qual idioma ele grava? Ele deve gravar no original. Um preço gravado em uma tradução não é armazenado: a tradução mantém o preço do original.
Ele cria um produto por idioma? O WooCommerce recusa um segundo produto com o mesmo SKU. Sem o SKU, as cópias são produtos separados que não recebem atualizações de estoque ou preço. Deixe o conector criar apenas o original e deixe o WPML traduzi-lo.
Parte 3. Crie fluxos personalizados (desenvolvedores)
Crie um produto e suas traduções com a API REST do WooCommerce
Crie os termos primeiro, depois o original e, em seguida, cada tradução com lang e translation_of.
Traduza a categoria (e quaisquer termos de atributos): POST /wp-json/wc/v3/products/categories
Crie cada tradução:POST /wp-json/wc/v3/products, com os textos traduzidos, a categoria traduzida, lang e translation_of (o ID do original). Não envie SKU, preço ou estoque: o WPML os copia do original.
Leia o resultado com um GET. A resposta à chamada de criação mostra SKU, preço e estoque vazios, porque o WPML os copia depois que a resposta é construída. GET /wc/v3/products/121 logo em seguida os mostra.
Para um produto variável, crie as variações do original apenas no original (POST /wc/v3/products/<id>/variations/batch). Em seguida, crie cada pai traduzido com lang e translation_of. O WPML cria as próprias variações traduzidas, vincula cada uma à sua variação original e copia o SKU, o preço, o estoque e os termos de atributos nesse idioma. Não publique variações em uma tradução.
Leia as variações de uma tradução com ?lang=:GET /wc/v3/products/137/variations?lang=fr. Cada variação carrega lang, seu mapa translations e os nomes das opções nesse idioma.
Uma tradução de produto por idioma. Uma segunda tradução de produto em um idioma que já tem uma é recusada com HTTP 400 wcml_translation_exists, e nada é criado. A mensagem informa o ID da tradução existente. Em vez disso, atualize a tradução existente.
Atualize o original. O WPML copia a alteração para todos os idiomas na mesma requisição.
PUT /wc/v3/products/123/variations/124 com {"regular_price": "59.00", "stock_quantity": 3} altera o preço e o estoque dessa variação em todos os idiomas, e a faixa de preço acompanha a alteração.
PUT /wc/v3/products/120 com um novo preço normal, preço promocional ou estoque os altera em todos os idiomas.
Novos termos de atributos são criados no atributo do original e traduzidos com lang e translation_of, como na etapa 1 acima.
Uma nova variação adicionada ao original (POST /wc/v3/products/123/variations ou .../variations/batch) chega a todos os idiomas na mesma requisição, vinculada, com seu preço e estoque. A resposta à chamada lista apenas o idioma do original; GET /wc/v3/products/130/variations?lang=de logo em seguida lista a nova variação traduzida.
Um preço ou atributos enviados para uma tradução não são armazenados: a tradução mantém os valores do original. Um valor de estoque enviado para qualquer idioma se torna o estoque de todos os idiomas.
Excluir por meio da API:DELETE /wc/v3/products/<id> segue WPML → Configurações → Excluir conteúdo, linha Produtos. A API nunca pergunta: em Perguntar a mim, ela exclui apenas o original. Defina Excluir um original para o comportamento que a sua loja quer. Com Excluir todos os idiomas, uma exclusão move todos os idiomas para a Lixeira, e ?force=true exclui todos os idiomas.
Escreva seu próprio importador ou conector
Use as funções de produto do WooCommerce. O WPML vê a alteração e a copia para todos os idiomas.
Após save(), as traduções mostram o novo preço e estoque.
Nunca grave dados de produtos diretamente no banco de dados (update_post_meta() ou SQL). O original muda, e as traduções mantêm os valores antigos.
Execute a etapa de importação do WPML a partir do código após uma importação com as colunas do WPML: wp wpml import process. Isso executa as mesmas etapas que o botão Run WPML Import e exibe cada uma com sua contagem.
Tarefas agendadas
Uma tarefa agendada (WP-Cron) que altera o original com as funções de produto do WooCommerce leva essas alterações para todos os idiomas na própria requisição da tarefa:
Preço, preço promocional e estoque, com o status de estoque decorrente disso
Uma categoria adicionada ao produto (como a categoria traduzida)
Um novo termo de atributo em um produto variável (como sua tradução)
A faixa de preço do produto variável
Parte 4. Solução de problemas
As traduções importadas aparecem como produtos separados e não vinculados
O que você vê: as linhas traduzidas estão ausentes ou aparecem como produtos em inglês (idioma padrão), muitas vezes como Privado, sem nenhum link para o original.
Por que isso acontece:
O arquivo não tem as colunas do WPML. O WooCommerce então ignora todas as linhas cujo SKU já exista: “A product with this SKU already exists.”
O arquivo tem as colunas do WPML, mas o Run WPML Import não foi executado. Até lá, cada linha é um produto no idioma padrão sem link para o seu original, com o status que a coluna Published do arquivo lhe dá (Privado para 0, Rascunho para -1). WPML → Exportação e importação do WPML mostra “Good job. We see 12 posts that are imported and need language information.”
Como corrigir isso agora:
Nenhuma etapa de importação do WPML foi executada: vá para WPML → Exportação e importação do WPML e clique em Run WPML Import.
Sem colunas do WPML: adicione as quatro colunas do WPML às linhas de tradução e importe-as novamente como uma nova importação, com a opção Atualizar produtos existentes desmarcada. Em seguida, clique em Run WPML Import. Cada tradução se junta ao seu original pelo SKU.
Como evitar isso: sempre inclua as colunas do WPML e execute Run WPML Import após cada importação.
As traduções importadas são substituídas pelo texto do original
O que você vê: você importou nomes e descrições traduzidos e, após o próximo salvamento do original, eles voltam para o idioma original.
Por que isso acontece: as traduções eram duplicatas. O WPML reescreve uma duplicata a cada salvamento do seu original.
Como corrigir isso agora:
Torne-os independentes. Vá para Produtos → Todos os produtos, mude para o idioma da tradução, marque os produtos e escolha Ações em massa → Traduzir independentemente.
Se o Traduzir tudo estiver ativado, defina Produtos como Nenhum. Em WPML → Traduções, clique no menu de três pontos na caixa “Translate Everything Automatically is enabled”, escolha Adjust content limits, defina Produtos como Nenhum e clique em Salvar Alterações.
Importe suas traduções novamente.
Depois disso, salvar o original mantém o texto importado.
Como evitar isso: antes de importar texto para traduções existentes, defina-as como Traduzir independentemente. Ou importe as traduções como novos produtos com as colunas do WPML (Processo B).
Os produtos traduzidos mostram os valores dos atributos no idioma original
O que você vê: a página do produto traduzido oferece “Blue”, “Green” em vez dos termos traduzidos.
Por que isso acontece: os produtos foram traduzidos antes que os termos dos seus atributos fossem traduzidos.
Como corrigir isso agora:
Vá paraWPML → Traduções e abra a aba Taxonomia.
Em "Selecione a taxonomia para traduzir", escolha o atributo, por exemplo, Cor do produto.
Traduza cada termo em cada idioma e clique em Salvar. Traduza o rótulo do atributo na mesma tela.
Os produtos traduzidos existentes adquirem cada termo à medida que você o salva. Nenhum produto precisa ser salvo novamente. Se um termo foi criado primeiro como uma cópia com o nome do original, seu slug mantém o texto do original; altere-o na mesma caixa de diálogo.
Como evitar isso: traduza os termos do atributo antes de traduzir ou importar os produtos.
Categorias ou termos traduzidos mantêm os nomes do original após uma importação
O que você vê: um produto traduzido fica em uma categoria chamada "Sunglasses" ou oferece "Blue" na loja traduzida.
Por que isso acontece: as linhas de tradução foram copiadas da exportação do original e mantiveram seus nomes de categoria, tag e termo de atributo. O WPML cria termos traduzidos com esses nomes e os vincula corretamente, mas não os renomeia. Upsells, vendas cruzadas, imagens, galerias e pais de variação fornecidos pelos IDs do original são remapeados para o idioma correto.
Como corrigir isso agora: renomeie os termos em WPML → Traduções → Taxonomia, como na seção acima. Breadcrumbs, links de termos, títulos de arquivos e opções de atributos mostram os novos nomes imediatamente, e nenhum produto precisa ser salvo novamente. Os slugs mantêm o texto do original, a menos que você os altere na mesma caixa de diálogo.
Como evitar isso: nas linhas de tradução, escreva os nomes traduzidos de categoria, tag e termo de atributo, na mesma ordem do original. Forneça os produtos relacionados e os pais por SKU.
O estoque ou os preços em outros idiomas estão desatualizados em relação ao original
O que você vê: o original mostra o novo estoque ou preço, e as traduções mostram o antigo.
Por que isso acontece: a alteração ignorou o WooCommerce ou o WPML:
Um conector gravou diretamente no banco de dados.
Uma importação foi executada enquanto o WPML estava desativado.
Como saber: abra o original no editor de produtos. Abaixo do editor de descrição, está escrito "Última edição em" com uma data e hora. Se essa hora for anterior ao novo preço ou estoque na caixa de dados do Produto, ou se a alteração foi feita enquanto o WPML estava inativo, a atualização ignorou a sincronização.
Como corrigir isso agora:
Para produtos variáveis:
Vá paraWPML → Suporte → Fix WCML translations. O Fix WCML translations faz parte do WPML Troubleshooting, um plugin separado.
Marque Sincronizar variações de produtos e clique em Executar as ferramentas selecionadas.
Todos os idiomas mostrarão os preços e o estoque da variação do original, além da faixa de preço do produto.
Para produtos simples, use um destes caminhos. Cada um deles leva o preço e o estoque do original para todos os idiomas:
Um produto por vez: abra cada original alterado e clique em Atualizar.
Muitos produtos por importação: com o idioma do painel de administração definido para o idioma padrão, importe os produtos novamente com Produtos → Importar e Atualizar produtos existentes marcado. O arquivo pode conter os valores que os originais já têm. Isso também realinha os produtos variáveis.
Muitos produtos por REST: envie PUT /wc/v3/products/<id> com o preço para cada produto, por exemplo, {"regular_price": "19.50"}.
Muitos produtos com o mesmo preço: em Produtos → Todos os produtos, marque os produtos, escolha Ações em massa → Edição em massa e clique em Aplicar. Em Preço, escolha Alterar para:, insira o preço e clique em Atualizar. Todos os produtos marcados recebem esse mesmo preço.
Executar wp wc product update com o valor que o original já tem não o leva para as traduções.
Como evitar isso: deixe o conector gravar por meio do WooCommerce (a API REST ou as funções do produto) e mantenha o WPML ativo durante as importações.
Os produtos criados por meio da API REST caem no idioma ou grupo errado
O que você vê: uma tradução aparece no idioma errado ou como um produto separado sem SKU e sem link para o original.
Por que isso acontece:
Um código de idioma desconhecido é recusado com HTTP 422 Invalid language parameter: "ge", e nada é criado.
Um código válido, mas errado, como um texto em alemão enviado com "lang": "fr", cria uma tradução nesse idioma.
A falta de translation_of cria um produto em seu próprio grupo, sem SKU e sem preço ou estoque copiado.
Como corrigir isso agora: envie o produto novamente com o idioma correto e o link, com PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
O produto é movido para o grupo do original e recebe seu SKU, preço e estoque. Para um produto variável, o WPML substitui as variações criadas sem um link por novas variações vinculadas. Leia os novos IDs de variação de volta.
Como evitar isso: envie lang e translation_of em cada tradução, crie os termos primeiro e deixe o WPML criar as variações das traduções.
Novos produtos importados não são traduzidos automaticamente
O que você vê: os produtos importados ficam apenas no idioma original.
Por que isso acontece: o Traduzir tudo estava desativado durante a importação, ou os produtos são privados, os quais o Traduzir tudo nunca traduz, ou são rascunhos, que ele traduz apenas quando Traduzir rascunhos automaticamente está ativado e o rascunho é salvo novamente.
Como corrigir isso agora:
Envie os produtos: vá para WPML → Traduções, abra a seção Produtos, marque os produtos, escolha Traduzir automaticamente para cada idioma, escolha Publicar sem revisar em "O que você gostaria de fazer quando o WPML terminar de traduzir seu conteúdo automaticamente?" e clique em Traduzir conteúdo. Isso também funciona para rascunhos e produtos privados; suas traduções recebem o status do original.
Ou ative o Traduzir tudo. Ele traduz todos os produtos publicados que ainda não foram traduzidos. O WPML os envia enquanto as páginas do painel de administração do WPML carregam.
Vá paraWPML → Traduções → Configurar o Traduzir tudo → Continuar → Ativar o Traduzir tudo automaticamente.
Permaneça emWPML → Traduções até que apareça "Terminou de traduzir seu conteúdo".
Como evitar isso: ative o Traduzir tudo antes da importação (Processo A) e importe os produtos como publicados.
Escrito porAmir·
Pesquise na documentação, blog, hooks e muito mais.