Compreender como o Polylang gere conteúdo multilingue ao nível da base de dados é essencial para developers que estão a criar ferramentas avançadas de tradução ou a depurar problemas de tradução. Após uma pesquisa extensa sobre a arquitetura do Polylang, mapeámos exatamente como este popular plugin multilingue para WordPress organiza os dados de idioma e as relações de tradução.
A Base: Tabelas de Taxonomia do WordPress
O Polylang tira partido do sistema nativo de taxonomias do WordPress de forma inteligente. Em vez de criar tabelas personalizadas, utiliza as tabelas existentes wp_term_relationships e wp_term_taxonomy para armazenar tanto as atribuições de idioma como as relações de tradução. Esta abordagem mantém a estrutura da base de dados enxuta, ao mesmo tempo que oferece uma funcionalidade poderosa.
Como os Posts São Associados a Idiomas
Quando um post é atribuído a um idioma, o Polylang cria entradas na tabela wp_term_relationships. Eis o processo:

Passo 1: Atribuição de Idioma
Um post (por exemplo, ID 7834) tem um object_id correspondente em wp_term_relationships com várias linhas, cada uma com um term_taxonomy_id diferente. Para identificar o idioma, deve:
- Encontrar linhas correspondentes em
wp_term_taxonomyonde a taxonomia é igual a'language' - Extrair a coluna
description, que contém dados de idioma serializados
O campo description contém dados como:
a:4:{s:9:"fallbacks";a:0:{}s:6:"locale";s:5:"en_US";s:3:"rtl";i:0;s:9:"flag_code";s:2:"us";}
Para filtrar posts por idioma, basta verificar se o term_taxonomy_id corresponde ao termo de idioma específico (por exemplo, 140 para inglês).
Passo 2: Relações de Tradução
As ligações de tradução entre posts usam a mesma estrutura de tabelas, com uma taxonomia diferente:
- Consultar
wp_term_taxonomyonde a taxonomia é igual a'post_translations' - A coluna
descriptioncontém todos os IDs de tradução
Um resultado típico é semelhante a:
a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}
Este array serializado mapeia códigos de idioma para IDs de posts, criando o grupo de tradução.
Como os Termos (Categorias/Tags) Gerem Idiomas
Os termos seguem um padrão semelhante, mas ligeiramente diferente:

Atribuição de Idioma para Termos
Para um termo com o ID 14850:
- Existem várias linhas em
wp_term_relationshipscom diferentes valores determ_taxonomy_id - A entrada correspondente em
wp_term_taxonomytem a taxonomia'term_language'(nota: não é apenas'language') - O
term_taxonomy_idpara idiomas de termos é, normalmente, o ID do idioma dos posts + 1 (por exemplo, se os posts usam 140, os termos usam 141)
Relações de Tradução de Termos
As relações de tradução para termos utilizam:
- O valor de taxonomia
'term_translations'emwp_term_taxonomy - O mesmo formato de array serializado na coluna
description:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}
Porque Isto É Importante para Ferramentas Avançadas de Tradução
Compreender esta estrutura da base de dados é crucial para criar funcionalidades de tradução sofisticadas. Quando desenvolvemos o polylang ai bulk translator para o nosso plugin Polylang AI Automatic Translation, este conhecimento aprofundado permitiu-nos:
- Consultar e processar, de forma eficiente, grandes lotes de conteúdo não traduzido
- Manter relações de tradução corretas entre artigos, páginas e taxonomias
- Lidar com estruturas complexas de construtores de páginas, preservando a integridade dos dados do Polylang
- Criar trabalhos de tradução que funcionam perfeitamente com a arquitetura do Polylang
Principais Conclusões
- O Polylang utiliza o sistema de taxonomias nativo do WordPress para armazenar dados multilingues
- Os conteúdos (posts) usam as taxonomias
'language'e'post_translations' - Os termos usam as taxonomias
'term_language'e'term_translations' - Todos os dados de idioma e tradução são serializados na coluna
descriptiondewp_term_taxonomy - O
term_taxonomy_idserve de ligação entre o conteúdo e os respetivos dados de idioma/tradução
Esta arquitetura é elegante na sua simplicidade, mas compreendê-la por completo exige mergulhar na estrutura da base de dados. Para programadores de plugins que trabalham com o Polylang, este conhecimento é inestimável para criar ferramentas que se integrem corretamente no ecossistema multilingue.