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:
- Encontrar las filas coincidentes en
wp_term_taxonomydonde la taxonomía es igual a'language' - 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:
- Haz una consulta a
wp_term_taxonomydonde la taxonomía sea igual a'post_translations' - La columna
descriptioncontiene 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:
- Existen varias filas en
wp_term_relationshipscon diferentes valores determ_taxonomy_id - El registro correspondiente en
wp_term_taxonomytiene la taxonomía'term_language'(nota: no solo'language') - El
term_taxonomy_idpara 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:
- Valor de taxonomía
'term_translations'enwp_term_taxonomy - 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
descriptiondewp_term_taxonomy - El
term_taxonomy_idsirve 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.