Como traduzir um site WordPress

Traduzir um site WordPress é uma decisão arquitetônica, não uma tarefa de redação. Um site WordPress moderno combina marcação de blocos do Gutenberg, Advanced Custom Fields (ACF), metadados serializados do banco de dados e catálogos do WooCommerce. Para ampliar as traduções com segurança, é preciso separar o texto traduzível da sintaxe interna do banco de dados.

O WordPress é a plataforma de mais de 43% da web. Sua flexibilidade fez dele a base de tudo, de blogs pessoais a redes editoriais empresariais e grandes lojas WooCommerce.

No entanto, traduzir o WordPress é notoriamente complexo. O conteúdo não fica em um único arquivo de texto: está espalhado pelas tabelas do banco de dados MySQL (wp_posts, wp_postmeta, wp_terms), armazenado em tipos de post personalizados, incorporado aos modelos de tema e preso em comentários de blocos do Gutenberg.

Veja um guia de arquitetura para traduzir um site WordPress com segurança, sem danificar o tema, corromper campos personalizados ou aumentar demais o banco de dados.

Comparação das 3 arquiteturas de tradução para WordPress

Toda implementação multilíngue do WordPress se baseia em uma de três arquiteturas fundamentais. Entender as vantagens e desvantagens técnicas de cada uma é essencial antes de escolher uma ferramenta:

1. Duplicação de vários registros no banco de dados (WPML, Polylang)

Nesse modelo tradicional, o plugin de tradução duplica cada página, post e produto como um registro independente na tabela wp_posts, vinculando-os por meio de tabelas relacionais do banco de dados.

• Como funciona: Uma publicação em inglês com o ID 101 ganha uma publicação correspondente em espanhol com o ID 102 e outra em alemão com o ID 103.
• Vantagens: Você tem total independência editorial em cada idioma. Pode criar layouts diferentes, atribuir categorias exclusivas e personalizar as meta descriptions de SEO para cada localidade.
• Custos ocultos: O tamanho do banco de dados aumenta conforme o número de idiomas. Em uma loja WooCommerce com 10,000 produtos, adicionar quatro idiomas gera 50,000 registros de posts e centenas de milhares de linhas em wp_postmeta, o que pode reduzir significativamente o desempenho das consultas ao banco de dados em hospedagens padrão.

2. Tradução com proxy de borda dinâmica (Weglot)

Em vez de duplicar linhas no banco de dados, um proxy de tradução fica entre o servidor WordPress e seus visitantes, detectando e traduzindo textos na borda da rede ou do DNS.

• Como funciona: o banco de dados do WordPress permanece 100% em inglês. O proxy intercepta as solicitações de página, substitui os textos dinamicamente e entrega páginas pré-traduzidas.
• Vantagens: configuração instantânea, sem aumentar o volume do banco de dados do WordPress. Plugins e campos personalizados nunca entram em conflito, porque o site principal não é alterado.
• Custos ocultos: você paga uma assinatura mensal contínua de SaaS, calculada com base no total de palavras traduzidas. Se cancelar, suas páginas traduzidas desaparecem na hora.

3. Fluxo de trabalho desacoplado baseado em arquivos (exportações XLIFF, PO e CSV)

Equipes corporativas modernas estão cada vez mais desacoplando a tradução do WordPress: exportam o conteúdo traduzível em arquivos de intercâmbio padronizados (pacotes WPML XLIFF/ZIP, exportações CSV do WooCommerce ou arquivos .po de temas), refinam o conteúdo em mecanismos externos de IA e reimportam arquivos limpos.

• Vantagens: controle total dos dados, sem executar modelos pesados de IA no ambiente de execução PHP do WordPress. Você aplica glossários de marca a milhares de produtos e escolhe entre os níveis de qualidade Lite e Standard.

4 armadilhas técnicas que corrompem traduções do WordPress

Traduzir conteúdo do WordPress com chatbots genéricos de IA ou ferramentas básicas de tradução costuma causar falhas técnicas silenciosas:

1. Corrupção da sintaxe dos blocos Gutenberg

O editor de blocos Gutenberg do WordPress incorpora parâmetros de layout entre delimitadores de bloco:

wp:paragraph {"fontSize":"large","className":"hero-lead"}
Welcome to our global platform.
/wp:paragraph

Ferramentas de tradução genéricas frequentemente traduzem as chaves JSON dentro do delimitador de bloco (por exemplo, convertem "large" em "grand"), corrompem a sintaxe do delimitador ou alteram as aspas. Quando você reabre a publicação no painel de administração do WordPress, o Gutenberg exibe um erro irrecuperável: “Este bloco contém conteúdo inesperado ou inválido”.

2. Corrupção de arrays serializados em PHP em wp_postmeta

O Advanced Custom Fields (ACF), as configurações de widgets e as opções de temas costumam armazenar dados estruturados como strings PHP serializadas:

a:2:{s:5:"title";s:12:"Case Studies";s:4:"link";s:23:"https://example.com/cs/";}

Em PHP serializado, o marcador s:12: declara explicitamente que a string seguinte tem exatamente 12 bytes. Se uma ferramenta de tradução sem controle traduzir "Case Studies" para o francês ("Études de cas", 14 bytes) sem atualizar o contador de bytes, o PHP não conseguirá desserializar a string (unserialize() retornará false), removendo completamente o campo personalizado do front-end.

3. Destruição de atributos de shortcode

Muitos temas antigos e construtores de páginas (Elementor, Divi, WPBakery) dependem de shortcodes:

[cta_box title="Summer Sale" button_url="https://example.com" button_text="Shop Now"]

Ferramentas de IA sem validação frequentemente traduzem os nomes dos parâmetros funcionais (title=, button_url=), em vez de traduzir apenas o texto voltado ao usuário entre aspas, deixando o shortcode completamente inoperante.

4. Descompasso entre o feed de produtos do WooCommerce e os SKUs

As exportações do WooCommerce contêm dezenas de colunas operacionais que não devem ser traduzidas: ID, SKU, Tax:class, In stock?, Regular price, Attribute 1 name e Attribute 1 value.

Se quem traduz alterar os atributos dos produtos de forma inconsistente ou mexer nos identificadores SKU, a sincronização do estoque será interrompida, e o WooCommerce criará produtos duplicados em vez de traduções localizadas.

O fluxo de tradução de WordPress que acompanha o crescimento do seu site

Para localizar sites grandes em WordPress sem complicações, use o AI Glot para cuidar do fluxo de exportação e importação:

Etapa 1: Exporte o conteúdo do WordPress

Exporte os materiais que precisam de tradução de acordo com a configuração dos seus plugins:

• Do WPML: Exporte pacotes de tradução como arquivos XLIFF ou arquivos ZIP.
• Do WooCommerce: Use o exportador nativo em Produtos > Exportar para baixar um arquivo CSV.
• De temas e plugins: Localize os arquivos de localização gettext .po ou .pot.

O AI Glot oferece suporte nativo a XLIFF, PO, POT, CSV e XLSX, além de mais de 35 outros formatos de localização.

Etapa 2: Defina o escopo com uma instrução simples em inglês

Envie seu arquivo de exportação para o AI Glot e especifique suas regras em inglês simples:

Translate the post_title and post_content fields into French and German. Preserve all Gutenberg block syntax (wp:...), shortcodes, and HTML markup. Leave IDs, URLs, and slugs untouched. Use formal register throughout.

O mecanismo separa o texto traduzível do código estrutural, garantindo que a sintaxe dos blocos e os atributos do banco de dados continuem válidos byte a byte.

Etapa 3: Revise o plano detalhado e importe

Confira o plano prévio para verificar os campos identificados, a contagem de palavras traduzíveis e o custo em créditos. Depois de aprovar, baixe o arquivo localizado e importe-o diretamente de volta para o WordPress pelo WPML ou pelo importador de CSV do WooCommerce.

Resumo: crie um site WordPress pronto para crescer no mundo todo

Traduzir um site WordPress não deve colocar em risco o desempenho do banco de dados nem o layout do tema. Ao combinar formatos de exportação confiáveis, como XLIFF ou CSV, com uma tradução por IA que entende a estrutura dos dados, você pode localizar catálogos empresariais e grandes arquivos de blog em poucos minutos.

Teste seus arquivos de exportação do WordPress com a amostra grátis de 5,000 palavras do AI Glot: cadastre-se gratuitamente.