WPML

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.

Você precisa do WPML, do WPML Multilingual & Multicurrency for WooCommerce e, para importações com traduções, da Exportação e importação do WPML.

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:

  1. Ative o recurso multimoeda primeiro. Vá para WPMLConfiguraçõesMultimoeda, 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.
  2. 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.
  3. 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.
  4. 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.

DuplicataTradução independente
O que éUma cópia que o WPML mantémUma tradução com seu próprio texto
Texto após o próximo salvamento do originalSubstituído pelo texto do originalMantido apenas com o Traduzir tudo desativado ou com Produtos definido como Nenhum
Preço e estoqueSeguem o originalSeguem o original

Configure a loja antes que o primeiro produto chegue

  1. 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.
  2. 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 ProdutosAtributosEditar.
  3. Traduza os termos de atributos antes dos produtos. Vá para WPMLTraduçõ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

Processo A: o WPML traduzProcesso B: você importa todos os idiomas
O que o seu sistema contémApenas o idioma padrão da lojaTodos os idiomas
O que você importaProdutos originaisOriginais e suas traduções, vinculados pelo SKU
Quem traduzO Traduzir tudo, com a Private Translation Cloud (PTC) (abre em uma nova aba)Seus tradutores, antes da importação
Quando o texto de um original mudaO Traduzir tudo traduz a alteraçãoO WPML marca a tradução como precisando de atualização; seu próximo arquivo traz o novo texto
Preços e estoqueSeguem o originalSeguem 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:

  1. Vá para WPMLTraduções e clique em Configurar o Traduzir tudo.
  2. Escolha o conteúdo. Em “Content to Translate”, mantenha All products e clique em Continue.
  3. Escolha como as traduções são publicadas. Em “Publishing method”, mantenha Publish without review.
  4. Clique em Ativar Traduzir tudo automaticamente.

Importe seus produtos apenas no idioma padrão da loja. Use ProdutosImportar (importador de CSV do WooCommerce) ou All ImportNew 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 WPMLTraduçõ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 WPMLConfiguraçõesTraduçã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 WPMLTraduçõ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:

  1. Vá para WPMLTraduções. Se o Traduzir tudo estiver desativado, deixe-o desativado e vá para o arquivo.
  2. 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.
  3. 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:

ColunaO que ela contémExemplo
Meta: _wpml_import_translation_groupO valor que vincula os idiomas. Use o SKU.HP-JK-SHELL
Meta: _wpml_import_language_codeO idioma da linhade
Meta: _wpml_import_source_language_codeO idioma do original, que é o idioma padrão da loja. Vazio nas linhas originais.en
Meta: _wpml_import_after_process_post_statusO status depois que o WPML vincula os produtospublish

Uma linha em alemão de um produto variável do nosso arquivo de exemplo:

Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish

Importe-o:

  1. Vá para ProdutosImportar e escolha o arquivo em “Escolha um arquivo CSV do seu computador:”. Deixe Atualizar produtos existentes desmarcado. Clique em Continuar.
  2. Verifique o mapeamento. As quatro colunas Meta: são mapeadas para Importar como metadados. Clique em Executar o importador.
  3. Vá para WPMLExportaçã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.
  4. 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:

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:

  1. Mantenha o Traduzir tudo ativado.
  2. Adicione a coluna Meta: _wpml_import_tea ao arquivo, com o valor 1 em cada produto a ser traduzido.
  3. Mantenha Meta: _wpml_import_translation_group no mesmo arquivo.
  4. Importe o arquivo, depois vá para WPMLExportaçã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.

  1. Conecte os termos traduzidos que a loja já tem. Para cada termo de atributo traduzido que já existe na loja, vá para ProdutosAtributos, 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 WPMLTraduçõesTaxonomia.
  2. 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.
  3. Importe as categorias. Em All ImportNew ImportUpload a file, escolha TaxonomiasCategorias 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 OptionsParent Term.
  4. Importe os termos de atributos da mesma forma, por exemplo, TaxonomiasProduct Color, com as mesmas três linhas de Metadado de termo.
  5. Conecte os termos. Vá para WPMLExportação e importação e clique em Run WPML Import. Verifique em WPMLTraduçõesTaxonomia (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.
  6. 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_*.
  7. Execute Run WPML Import novamente e aguarde por Multilingual Import Complete.

Nosso arquivo de termos de exemplo:

name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy

Duas configurações para um arquivo de produto que contém todos os idiomas:

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:

  1. Envie apenas as colunas que você alterar. Uma coluna com uma célula vazia grava um valor vazio. Nosso arquivo de exemplo:
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. 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.
  3. 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.
  4. Vá para ProdutosImportar, 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:

  1. All ImportNova importaçãoBaixar um arquivoDo URL, com o URL do feed do seu fornecedor. Escolha Produtos do WooCommerce.
  2. Mapeie o SKU, Preço normal e Quantidade em estoque na seção do complemento WooCommerce.
  3. 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.
  4. 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.
  5. Agende. Em All ImportGerenciar importaçõesOpçõ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:

  1. Vá para WPMLIdiomas, clique em Gerenciar e ocultar idiomas do site, use Pesquisar e adicionar um idioma... e escolha o idioma.
  2. 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:

  1. 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.
  2. Vá para ProdutosImportar. Deixe Atualizar produtos existentes desmarcado. Execute o importador.
  3. Vá para WPMLExportaçã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

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 idiomaImportação inteiraDessa parte, Executar importação do WPML
500cerca de meia horaalguns minutos
1.000cerca de uma horacerca de 10 minutos
2.000cerca de duas horascerca 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:

Este é o fluxo que funciona com o WPML:

  1. O conector grava apenas no idioma padrão da loja.
  2. O WPML copia o estoque e os preços para todos os idiomas na mesma requisição.
  3. O Traduzir tudo traduz novos produtos para todos os idiomas (Processo A).
  4. Um produto que o conector define como rascunho muda para rascunho em todos os idiomas.
  5. Um produto que o conector exclui segue WPMLConfiguraçõesExcluir 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:

  1. 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.
  2. 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.
  3. 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.

  1. Traduza a categoria (e quaisquer termos de atributos): POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    Para termos de atributos, use POST /wc/v3/products/attributes/<id>/terms/batch com os mesmos dois campos em cada termo.

  2. Crie o original: POST /wp-json/wc/v3/products
    JSON
    {
      "name": "Stoneware Coffee Mug",
      "type": "simple",
      "status": "publish",
      "sku": "HP-HG-MUG",
      "regular_price": "16.00",
      "manage_stock": true,
      "stock_quantity": 60,
      "categories": [ { "id": 32 } ],
      "lang": "en"
    }
  3. 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.
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. 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.

Referência completa de campos: API REST do WooCommerce Multilingual.

Atualize produtos com a API REST do WooCommerce

Atualize o original. O WPML copia a alteração para todos os idiomas na mesma requisição.

Excluir por meio da API: DELETE /wc/v3/products/<id> segue WPMLConfiguraçõesExcluir 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.

PHP
$id      = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();

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:

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:

Como corrigir isso agora:

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:

  1. Torne-os independentes. Vá para ProdutosTodos os produtos, mude para o idioma da tradução, marque os produtos e escolha Ações em massaTraduzir independentemente.
  2. Se o Traduzir tudo estiver ativado, defina Produtos como Nenhum. Em WPMLTraduçõ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.
  3. 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:

  1. Vá para WPMLTraduções e abra a aba Taxonomia.
  2. Em "Selecione a taxonomia para traduzir", escolha o atributo, por exemplo, Cor do produto.
  3. 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 WPMLTraduçõesTaxonomia, 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:

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:

  1. Vá para WPMLSuporteFix WCML translations. O Fix WCML translations faz parte do WPML Troubleshooting, um plugin separado.
  2. 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:

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:

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:

Como evitar isso: ative o Traduzir tudo antes da importação (Processo A) e importe os produtos como publicados.

Escrito porAmir