Como Criar uma Migração Multilíngue do Shopify para WordPress

Você passou meses construindo uma loja Shopify multilíngue. Suas descrições de produtos estão traduzidas para francês, alemão e espanhol. Seu fluxo de checkout funciona em três idiomas. Então, você decide migrar para WordPress e WooCommerce para ter mais controle, melhores margens ou flexibilidade de plugins.

Os dados do produto são transferidos corretamente. As imagens são transferidas. Mas suas traduções? Elas desaparecem.

Este é o custo oculto de uma migração multilíngue do WordPress sobre o qual ninguém avisa. O Shopify bloqueia suas traduções em seu próprio sistema proprietário, e o WordPress usa uma arquitetura completamente diferente. Sem um plano claro, você gastará semanas reconstruindo o que já tinha. Este guia oferece esse plano.

Por Que as Migrações Multilíngues Falham (E o Shopify Piora a Situação)

As migrações de plataforma já são dolorosas o suficiente com lojas monolíngues. Adicione vários idiomas e a complexidade se multiplica. A causa principal é arquitetônica: Shopify e WordPress lidam com traduções de maneiras fundamentalmente diferentes.

O Modelo de Tradução do Shopify é um Jardim Murado

O Shopify armazena traduções como metadados anexados a recursos por meio da API Translate and Adapt. Cada produto, coleção e página tem entradas de tradução vinculadas aos IDs de recursos internos do Shopify.

Quando você exporta sua loja usando uma ferramenta de migração como Cart2Cart, LitExtension ou uma exportação CSV, você obtém o conteúdo do idioma padrão. As traduções? Elas vivem em uma camada separada que a maioria das ferramentas de migração ignora completamente.

O Que Realmente É Exportado (E O Que É Perdido)

Isto é o que uma ferramenta típica de migração do Shopify para WordPress transfere:

O padrão é claro. O conteúdo do seu idioma padrão é migrado. Suas traduções não são. E mesmo que você as extraia manualmente, não pode simplesmente colar as traduções do Shopify no WordPress. Os sistemas falam idiomas diferentes, literalmente.

Mapeando Idiomas do Shopify para Arquivos de Tradução do WordPress

Antes de começar a reconstruir, você precisa entender como o WordPress lida com conteúdo multilíngue. É aqui que a maioria dos guias de migração falha.

Entendendo o Sistema Gettext

O WordPress usa o sistema de localização Gettext. Em vez de armazenar traduções em uma camada de banco de dados, ele lê arquivos binários estáticos (arquivos .mo) compilados a partir de arquivos .po legíveis por humanos.

Um arquivo .po se parece com isto:

msgid "Add to Cart"
msgstr "Ajouter au panier"

msgid "Search results for %s"
msgstr "Résultats de recherche pour %s"

Cada tema e plugin do WordPress vem com um arquivo de modelo .pot contendo todas as strings traduzíveis. Você cria um arquivo .po para cada idioma, preenche as traduções, compila-o para .mo e o coloca no diretório correto.

Este é o sistema para o qual suas traduções do Shopify precisam ser mapeadas.

O Problema de Incompatibilidade de Código de Idioma

O Shopify usa tags de idioma IETF (en, fr, de). O WordPress usa códigos de localidade com variantes regionais (fr_FR, de_DE, es_ES). Durante a migração, você precisa mapear cada idioma do Shopify para a localidade correta do WordPress. Errar isso significa que o WordPress não consegue encontrar seus arquivos de tradução.

Mapeamentos comuns que confundem as pessoas:

• O pt do Shopify mapeia para pt_PT (Portugal) ou pt_BR (Brasil) do WordPress -- não são intercambiáveis
• zh-CN do Shopify mapeia para zh_CN do WordPress, mas zh-TW do Shopify mapeia para zh_TW
• nb (Norueguês Bokmal) do Shopify mapeia para nb_NO do WordPress

Nomeie seus arquivos .po e .mo com o código de localidade do WordPress: themename-fr_FR.po, woocommerce-de_DE.mo. Um código errado significa que o WordPress ignora o arquivo silenciosamente.

Um Fluxo de Trabalho Passo a Passo para Migração Multilíngue do WordPress

Aqui está o fluxo de trabalho concreto para preservar suas traduções durante uma migração do Shopify para WordPress.

Passo 1: Exporte e Audite Suas Traduções do Shopify

Antes de tocar no WordPress, extraia tudo do Shopify. Use a API Admin do Shopify ou uma ferramenta como o Shopify Translate CSV Export para colocar suas traduções em arquivos estruturados.

# Using Shopify CLI to export translations
shopify app translate export --locale fr
shopify app translate export --locale de
shopify app translate export --locale es

Audite as exportações. Conte quantas strings você tem por idioma. Identifique quais são traduções de conteúdo do produto (gerenciadas pelo seu CMS ou plugin multilíngue no WordPress) versus traduções de strings de tema/UI (gerenciadas por arquivos .po).

Passo 2: Configure Sua Estrutura de Idioma do WordPress e WooCommerce

Em sua nova instalação do WordPress, configure sua infraestrutura de idioma antes de importar qualquer conteúdo.

1. Vá para Configurações > Geral e defina o idioma do seu site
2. Instale pacotes de idiomas para cada idioma de destino via Configurações > Geral > Idioma do Site
3. Crie a estrutura de diretório de tradução:

/wp-content/languages/
/wp-content/languages/plugins/
/wp-content/languages/themes/

Para traduções de conteúdo do produto (títulos, descrições), você precisará de um plugin de conteúdo multilíngue como WPML ou Polylang. Mas para strings de tema e plugin UI -- os botões, rótulos, mensagens de erro e fluxo de checkout -- você quer arquivos .po/.mo estáticos. Esta é a abordagem baseada em nuvem que evita o inchaço do plugin.

Passo 3: Converta Suas Traduções para o Formato PO

Suas traduções de string de tema do Shopify precisam ser convertidas para o formato Gettext .po. É aqui que a migração se torna técnica.

Se suas traduções do Shopify estiverem em formato JSON ou CSV, você pode convertê-las para .po usando um script ou ferramenta. A chave é mapear cada string de origem para um par msgid/msgstr:

import csv

with open('shopify_translations_fr.csv', 'r') as infile, \
     open('theme-fr_FR.po', 'w') as outfile:
    outfile.write('msgid ""\nmsgstr ""\n')
    outfile.write('"Language: fr_FR\\n"\n\n')
    reader = csv.DictReader(infile)
    for row in reader:
        outfile.write(f'msgid "{row["key"]}"\n')
        outfile.write(f'msgstr "{row["translation"]}"\n\n')

Isto lhe dá um ponto de partida, mas seu novo tema WordPress e instalação do WooCommerce terão centenas de strings que não existiam no Shopify. Você não pode reutilizar uma tradução de "Adicionar ao Carrinho" do Shopify para WooCommerce porque o contexto do código circundante é diferente. A string do WooCommerce pode ser Add to cart (minúscula "c") ou incluir uma variável %s para o nome do produto.

É aqui que a maioria das pessoas fica presa. Você tem traduções parciais do Shopify e uma lacuna enorme de strings específicas do WordPress não traduzidas.

Como Traduzir as Lacunas Sem Começar de Novo

A boa notícia: você não precisa traduzir 5.000 strings do WooCommerce manualmente. A má notícia: você também não pode ignorá-las, ou sua loja mostrará uma mistura chocante de títulos em francês e mensagens de erro em inglês.

Strings de Tema e Plugin Ainda Precisam de Tradução

Seu tema WordPress tem seu próprio arquivo .pot. O WooCommerce tem o seu próprio. Cada plugin que você instala -- gateways de pagamento, calculadoras de frete, construtores de formulários -- cada um tem strings traduzíveis. Estes não existiam em sua loja Shopify.

A abordagem mais rápida é traduzir estes grandes arquivos .po em lote, em vez de string por string. Carregue o arquivo .pot do seu tema, selecione o idioma de destino e deixe a IA lidar com o trabalho pesado.

Traduzindo em Lote Grandes Arquivos do WooCommerce

O arquivo de idioma do WooCommerce é enorme. Com milhares de strings cobrindo tudo, desde mensagens de carrinho até códigos de erro de imposto, é a maior tarefa de tradução em qualquer migração. O SimplePoTranslate lida com isso por meio de Loteamento Inteligente -- dividindo arquivos superdimensionados em partes seguras, processando-as em paralelo e mesclando os resultados de volta em um único arquivo limpo.

O detalhe crítico: seus arquivos traduzidos devem preservar cada variável de código exatamente como aparece na fonte. Um marcador de posição %s em um modelo de e-mail do WooCommerce não pode ter um espaço adicionado ou uma posição trocada durante a tradução. É aqui que o bloqueio de sintaxe impede que variáveis quebradas cheguem à sua loja de produção.

Com a Saída Multi-Formato do SimplePoTranslate, você obtém arquivos .po, .mo, .json, .php e .xliff em um único download ZIP. Isso é particularmente útil durante a migração, porque diferentes partes da sua pilha WordPress podem consumir traduções em diferentes formatos. Seu tema lê arquivos .mo. Um front-end headless pode precisar de .json. Uma integração personalizada pode esperar .xliff. Uma execução de tradução cobre todos eles.

Evitando as Três Falhas de Tradução de Migração Mais Comuns

Mesmo com o fluxo de trabalho correto, existem armadilhas específicas para migrações de plataforma que pegam desenvolvedores experientes desprevenidos.

Variáveis Quebradas em E-mails Transacionais

Os e-mails transacionais do WooCommerce são densos com marcadores de posição: {order_number}, {customer_name}, %1$s, %2$s. Se o seu processo de tradução corromper até mesmo um destes, os clientes recebem e-mails como "Olá {customer_name}" literalmente, ou pior, e-mails com dados trocados.

Sempre valide seus arquivos traduzidos em relação ao arquivo .pot de origem antes de implantar. Ferramentas como o Poedit sinalizarão incompatibilidades de marcadores de posição, e tradutores baseados em nuvem com bloqueio de sintaxe eliminam completamente esta classe de erro.

Regras de Pluralização Ausentes

O Shopify lida com plurais de forma simples. O WordPress Gettext suporta formas plurais complexas que variam de acordo com o idioma. O russo tem três formas plurais. O árabe tem seis. Se o seu arquivo .po traduzido não incluir o cabeçalho Plural-Forms correto e as entradas msgstr[0], msgstr[1], msgstr[2] correspondentes, o WordPress volta para a string não traduzida.

# Correct Russian plural forms header
"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : "
"n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);\n"

msgid "%s item"
msgid_plural "%s items"
msgstr[0] "%s товар"
msgstr[1] "%s товара"
msgstr[2] "%s товаров"

Isto é algo que o Shopify nunca exigiu que você pensasse. No WordPress, isso importa.

Strings Órfãs Após Trocas de Plugin

Quando você migra do Shopify, você não está apenas mudando de plataforma. Você está substituindo todo um ecossistema de plugins. Seu gateway de pagamento Shopify se torna WooCommerce Payments ou Stripe para WooCommerce. Seu sistema de avaliação se torna um plugin WordPress. Cada troca introduz novas strings traduzíveis e torna as traduções antigas obsoletas.

Construa uma lista de verificação de cada plugin que você instala após a migração e verifique se cada um tem um arquivo .mo traduzido correspondente em /wp-content/languages/plugins/. A falta de até mesmo um plugin significa que seus clientes veem strings em inglês no meio de uma interface traduzida.

Lance Sua Loja Multilíngue no WordPress

Uma migração multilíngue do WordPress não é apenas uma transferência de dados. É uma re-arquitetura de como sua loja se comunica com clientes internacionais. As lojas que acertam isso veem taxas de conversão mais altas em mercados não ingleses porque a experiência parece nativa, em vez de improvisada.

O fluxo de trabalho é simples: exporte suas traduções do Shopify, mapeie-as para códigos de localidade do WordPress, converta para o formato .po, preencha as lacunas com tradução de IA em lote, valide suas variáveis e implante arquivos .mo estáticos. Sem inchaço do banco de dados. Sem sobrecarga de tradução em tempo de execução. Apenas comércio multilíngue rápido e confiável.

Se você está enfrentando uma migração com milhares de strings do WooCommerce não traduzidas, a abordagem do SimplePoTranslate para localização de arquivos grandes pode economizar semanas de trabalho manual.

Pronto para traduzir sua loja WooCommerce após a migração? Experimente o SimplePoTranslate gratuitamente -- nenhum cartão de crédito é necessário. Envie seu arquivo .pot e obtenha traduções prontas para produção em minutos.