Cómo Polylang almacena las traducciones en la base de datos de WordPress: un análisis técnico en profundidad

Robbert Vermeulen

Robbert Vermeulen

· 4 min de lectura

Comprender cómo Polylang gestiona el contenido multilingüe a nivel de base de datos es esencial para los desarrolladores que crean herramientas de traducción avanzadas o depuran problemas de traducción. Tras una investigación exhaustiva de la arquitectura de Polylang, hemos mapeado exactamente cómo este popular plugin multilingüe para WordPress organiza los datos de idiomas y las relaciones de traducción.

La base: tablas de taxonomía de WordPress

Polylang aprovecha el sistema de taxonomías nativo de WordPress de una forma ingeniosa. En lugar de crear tablas personalizadas, utiliza las tablas existentes wp_term_relationships y wp_term_taxonomy para almacenar tanto las asignaciones de idioma como las relaciones de traducción. Este enfoque mantiene la estructura de la base de datos ligera a la vez que ofrece una funcionalidad potente.

Cómo se vinculan las entradas a los idiomas

Cuando se asigna un idioma a una entrada, Polylang crea registros en la tabla wp_term_relationships. Así es el proceso:

Paso 1: asignación de idioma

Una entrada (por ejemplo, ID 7834) tiene un object_id correspondiente en wp_term_relationships con varias filas, cada una con un term_taxonomy_id diferente. Para identificar el idioma, debes:

  1. Encontrar las filas coincidentes en wp_term_taxonomy donde la taxonomía es igual a 'language'
  2. Extraer la columna description, que contiene los datos de idioma serializados

El campo description contiene datos 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 las entradas por idioma, solo tienes que comprobar si el term_taxonomy_id coincide con el término de idioma específico (por ejemplo, 140 para inglés).

Paso 2: relaciones de traducción

Los enlaces de traducción entre entradas utilizan la misma estructura de tabla con una taxonomía diferente:

  1. Haz una consulta a wp_term_taxonomy donde la taxonomía sea igual a 'post_translations'
  2. La columna description contiene todos los IDs de traducción

Un resultado típico se ve así:

a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}

Este array serializado asigna los códigos de idioma a los IDs de las entradas, creando el grupo de traducción.

Cómo gestionan los términos (categorías/etiquetas) los idiomas

Los términos siguen un patrón similar pero ligeramente diferente:

Asignación de idioma para términos

Para un término con ID 14850:

  1. Existen varias filas en wp_term_relationships con diferentes valores de term_taxonomy_id
  2. El registro correspondiente en wp_term_taxonomy tiene la taxonomía 'term_language' (nota: no solo 'language')
  3. El term_taxonomy_id para los idiomas de términos suele ser el ID de idioma de las entradas + 1 (por ejemplo, si las entradas utilizan 140, los términos utilizan 141)

Relaciones de traducción de términos

Las relaciones de traducción para los términos utilizan:

  1. Valor de taxonomía 'term_translations' en wp_term_taxonomy
  2. El mismo formato de array serializado en la columna description:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}

Por qué esto importa para las herramientas de traducción avanzadas

Comprender esta estructura de base de datos es fundamental para crear funciones de traducción sofisticadas. Cuando desarrollamos el polylang ai bulk translator para nuestro plugin Polylang AI Automatic Translation, este conocimiento profundo nos permitió:

  • Consultar y procesar de forma eficiente grandes lotes de contenido sin traducir
  • Mantener relaciones de traducción correctas entre entradas, páginas y taxonomías
  • Gestionar estructuras complejas de maquetadores visuales preservando la integridad de los datos de Polylang
  • Crear trabajos de traducción que funcionen sin problemas con la arquitectura de Polylang

Puntos clave

  • Polylang utiliza el sistema nativo de taxonomías de WordPress para almacenar datos multilingües
  • Las entradas utilizan las taxonomías 'language' y 'post_translations'
  • Los términos utilizan las taxonomías 'term_language' y 'term_translations'
  • Todos los datos de idioma y traducción se serializan en la columna description de wp_term_taxonomy
  • El term_taxonomy_id sirve como enlace entre el contenido y sus datos de idioma/traducción

Esta arquitectura es elegante en su simplicidad, pero comprenderla a fondo requiere profundizar en la estructura de la base de datos. Para los desarrolladores de plugins que trabajan con Polylang, este conocimiento es invalorable para crear herramientas que se integren correctamente en el ecosistema multilingüe.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Ver todas las publicaciones →