Como importar conteúdo multilíngue para o WordPress - WooCommerce, CSV e XML

A Exportação e importação do WPML funciona em conjunto com o plugin de importação do WordPress que você já usa. O plugin de importação move seus dados. A Exportação e importação do WPML adiciona as informações de idioma no final para que cada linha fique no idioma correto e cada tradução se vincule à sua origem.

Antes de começar

Instale e ative estes plugins no site para o qual você está importando:

Um plugin de importação: WP All Import Pro, WP All Export Pro, o importador de CSV nativo do WooCommerce ou o importador padrão do WordPress.
WPML e WPML Tradução de Strings.
Exportação e importação do WPML (o complemento abordado nesta página).
WPML Multilingual & Multicurrency for WooCommerce se você estiver importando produtos do WooCommerce.

No site de importação, configure o WPML com todos os idiomas que você planeja importar. Os idiomas de destino já devem existir em WPML → Configurações → Idiomas antes de você executar a importação.

Dois caminhos – escolha o que corresponde à sua origem

Existem dois caminhos de importação, dependendo de onde vêm os dados multilíngues:

Plugin de importação compatível. Se você estiver movendo o conteúdo de um site WordPress existente com o WP All Export Pro (ou outra ferramenta de exportação compatível), a Exportação e importação do WPML já está no arquivo de exportação – as informações de idioma são incluídas automaticamente. Pule para a etapa Execute a importação do WPML abaixo.
CSV ou XML personalizado. Se você mantém dados multilíngues em uma planilha ou sua origem é um sistema que não seja WordPress (PIM, MLS, ERP, plataforma de reservas), você adicionará três colunas de idioma ao seu arquivo manualmente. Continue para Prepare seu CSV ou XML abaixo.

Prepare seu CSV ou XML com três colunas de idioma

Para importações personalizadas, adicione três colunas a cada linha da sua planilha. É assim que o WPML agrupa as traduções e marca cada linha com o idioma correto:

_wpml_import_translation_group. Um valor exclusivo compartilhado por todas as versões de idioma de um conteúdo. Para produtos, use o SKU. Para todo o resto, gere seu próprio ID e reutilize-o para a linha de origem e cada tradução dela.
_wpml_import_language_code. O código de idioma ISO da linha (en para inglês, es para espanhol, fr para francês, pt-pt para português europeu e assim por diante).
_wpml_import_source_language_code. Apenas em linhas de tradução; o código de idioma do original. Deixe em branco para as linhas do idioma de origem.

Para o WP All Import Pro e ferramentas semelhantes, prepare duas planilhas: uma para taxonomias (categorias, tags, categorias de produtos) e outra para posts e produtos. O importador de CSV nativo do WooCommerce aceita uma única planilha porque as categorias de produtos ficam dentro das linhas do produto.

Atributos personalizados do WooCommerce para produtos variáveis

Se você tiver produtos variáveis com atributos personalizados, adicione uma quarta coluna às linhas de produtos traduzidos: _wpml_import_wc_local_attribute_labels. O valor é um objeto JSON de pares slug:translation. Para um produto variável em francês com os atributos Tamanho e Cor:

{"size":"Taille","color":"Couleur"}

O slug é o nome do atributo em letras minúsculas, com os espaços substituídos por traços.

Ordem de importação

Sempre importe as taxonomias primeiro quando você tiver um arquivo separado para elas. As categorias, as tags e quaisquer outras taxonomias precisam existir antes que os posts e produtos possam referenciá-las. Em seguida, importe os posts, as páginas, os produtos e outros tipos de conteúdo.

Se você dividir seus dados em um arquivo por idioma, importe todos os arquivos de idioma antes de executar a etapa de conexão do WPML.

Mapeie as colunas de idioma no seu plugin de importação

Cada plugin de importação lida com colunas personalizadas à sua própria maneira. A etapa crítica é mapear as três colunas do WPML para campos personalizados (ou metadado de termo, para taxonomias). No WP All Import Pro, isso acontece na Etapa 3 do assistente de importação:

Para posts e produtos. Abra Campos personalizados, adicione três campos, arraste as colunas de idioma para as caixas Value e use os nomes das colunas sem colchetes nas caixas Name.
Para taxonomias. Abra Metadado de termo, adicione três campos de metadado de termo e mapeie as colunas de idioma da mesma forma.

Se as colunas não estiverem mapeadas, o WPML não terá nada para ler quando você executar a etapa de conexão.

O que você verá entre a importação e a etapa de conexão

Até você executar a Exportação e importação do WPML, todo o conteúdo importado fica no seu idioma padrão, e o WPML mantém automaticamente os posts e os produtos no status Rascunho para manter o conteúdo com idiomas misturados fora do front-end. Esse é o estado intermediário esperado, não um sinal de falha na importação.

Para plugins de importação não compatíveis, você precisará publicar os posts manualmente após a conclusão da etapa de conexão.

Execute a importação do WPML

Assim que o plugin de importação terminar:

Abra WPML → Exportação e importação no painel de administração do WordPress.
Clique em Executar importação do WPML.

O WPML lê as colunas de idioma de cada linha, atribui o idioma a essa linha e vincula as traduções à sua origem. Em catálogos grandes, isso pode levar vários minutos. Quando terminar, seu conteúdo importado será publicado no idioma correto, com cada tradução conectada à sua origem.

Faça uma verificação por amostragem no back-end e no front-end:

Abra a lista de tipos de post ou de produtos – confirme se cada linha aparece sob a bandeira do idioma correto.
Visite o front-end e alterne os idiomas – cada página traduzida deve carregar a sua versão traduzida, e não recorrer à origem.

Se a tradução de uma taxonomia não for vinculada, abra o termo no painel de administração do WordPress e use a caixa Idiomas do termo para conectá-lo ao termo do idioma padrão.

Automatize – execute a importação do WPML após cada importação agendada

Para sincronizações noturnas, feeds de fornecedores ou qualquer importação agendada, a etapa de conexão do WPML pode ser executada automaticamente logo após o término do plugin de importação. Há três maneiras de configurar isso:

Opção 1 – Endpoint POST (para importações baseadas em Cron, como WP All Import Scheduled Actions)

Esta é a forma recomendada. Adicione uma chave secreta forte ao wp-config.php:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

Em seguida, adicione um segundo comando à configuração da sua importação agendada. Ele envia uma requisição POST para o seu site e passa a chave no corpo da requisição:

curl -X POST https://yoursite.com/ \
  -d 'wpml_import_trigger=your-strong-secret-key-here'

A mesma chamada com wget:

wget -q -O - \
  --post-data='wpml_import_trigger=your-strong-secret-key-here' \
  https://yoursite.com/

Para o agendamento manual do WP All Import Pro, adicione qualquer um dos comandos logo após o comando de importação.

Quando a etapa de conexão é executada, o seu site responde com o status 200 e esta mensagem:

Import process completed

Outras duas respostas indicam o que aconteceu: 401 significa que a chave não corresponde e 204 significa que não havia mais nada a processar.

Opção 2 – Endpoint de URL (obsoleto)

Antes da Exportação e importação do WPML 1.2.0, você passava a chave na URL:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

Esta URL ainda funciona, então seus cron jobs atuais continuam sendo executados. Ela está obsoleta e o WPML a removerá na próxima versão principal.

O motivo é a chave. Uma URL passa pelos logs do servidor, pelo histórico do navegador e pelas ferramentas de análise, e a sua chave viaja com ela. Uma requisição POST mantém a chave no corpo da requisição. Mude suas importações agendadas para a chamada POST na Opção 1.

Opção 3 – Action hook (para importações agendadas por PHP)

Se você estiver agendando importações a partir do PHP com o Action Scheduler ou wp_schedule_single_event, acione a etapa do WPML com uma chamada de action:

do_action( 'wpml_import_process' );

Para executá-la como uma tarefa única em segundo plano logo após a sua action de importação:

wp_schedule_single_event( time(), 'wpml_import_process' );

Se algo falhar em qualquer um desses caminhos, ative WP_DEBUG_LOG no wp-config.php para capturar o erro no log de erros do PHP.

Execute a importação do WPML a partir da linha de comando

Para scripts de implantação, builds de contêineres ou qualquer pipeline onde a interface de administração não esteja disponível, execute a etapa de conexão a partir do WP-CLI:

wp wpml import process

O comando relata quantas traduções foram conectadas. É um substituto direto para o botão Executar importação do WPML.

Armadilhas comuns

Faltam as três colunas de idioma no arquivo de importação. O conteúdo é importado, mas chega como linhas do idioma de origem sem marcação; o Executar importação do WPML não tem nada para conectar. Correção: adicione as colunas aos seus dados de origem, exporte novamente e importe novamente.
O mapeamento de Campos personalizados / Metadado de termo do WP All Import foi ignorado. O mesmo problema das colunas ausentes. Os dados estão no arquivo, mas o plugin de importação não os armazenou no post. Execute a importação novamente com os campos mapeados.
Os idiomas de destino não estão configurados no site de importação. As linhas importadas para um idioma não configurado chegam no idioma padrão. Adicione os idiomas ausentes em WPML → Configurações → Idiomas primeiro e, em seguida, execute novamente.
Plugin de importação não compatível. Os posts importados permanecem em Rascunho após a etapa de conexão. Publique-os manualmente ou mude para um plugin compatível.
Scripts de importação personalizados que não repassam os dados de idioma. A correção é no nível do script. As três colunas de idioma (e a coluna de atributos do WooCommerce, quando aplicável) precisam chegar à linha.

Se as importações continuarem esbarrando no mesmo problema, a equipe de suporte do WPML responde a dúvidas sobre importação 24 horas por dia, 7 dias por semana.

Se você estava procurando o plugin WPML All Import

O WPML All Import é o plugin legado que antecede a Exportação e importação do WPML. Ele não é mais compatível nem recomendado. O procedimento acima é a maneira atualizada de importar conteúdo multilíngue para um site WordPress – use-o em vez de qualquer fluxo de trabalho descrito na documentação do plugin antigo.