Como o Polylang Armazena Traduções na Base de Dados do WordPress: Um Mergulho Técnico Profundo

Robbert Vermeulen

Robbert Vermeulen

· 4 min read

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:

  1. Encontrar linhas correspondentes em wp_term_taxonomy onde a taxonomia é igual a 'language'
  2. 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:

  1. Consultar wp_term_taxonomy onde a taxonomia é igual a 'post_translations'
  2. A coluna description conté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:

  1. Existem várias linhas em wp_term_relationships com diferentes valores de term_taxonomy_id
  2. A entrada correspondente em wp_term_taxonomy tem a taxonomia 'term_language' (nota: não é apenas 'language')
  3. O term_taxonomy_id para 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:

  1. O valor de taxonomia 'term_translations' em wp_term_taxonomy
  2. 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 description de wp_term_taxonomy
  • O term_taxonomy_id serve 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.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

View all posts →