Capire come Polylang gestisce i contenuti multilingue a livello di database è fondamentale per gli sviluppatori che creano strumenti di traduzione avanzati o che effettuano il debug dei problemi di traduzione. Dopo un’approfondita analisi dell’architettura di Polylang, abbiamo mappato esattamente come questo popolare plugin multilingue per WordPress organizza i dati delle lingue e le relazioni di traduzione.
Le fondamenta: le tabelle di tassonomia di WordPress
Polylang sfrutta in modo intelligente il sistema di tassonomie nativo di WordPress. Invece di creare tabelle personalizzate, utilizza le tabelle esistenti wp_term_relationships e wp_term_taxonomy per archiviare sia le assegnazioni di lingua sia le relazioni di traduzione. Questo approccio mantiene la struttura del database snella offrendo al contempo funzionalità potenti.
Come i post sono collegati alle lingue
Quando a un post viene assegnata una lingua, Polylang crea delle voci nella tabella wp_term_relationships. Ecco il processo:

Passaggio 1: Assegnazione della lingua
Un post (ad esempio, ID 7834) ha un corrispondente object_id in wp_term_relationships con più righe, ognuna con un diverso term_taxonomy_id. Per identificare la lingua, devi:
- Trovare le righe corrispondenti in
wp_term_taxonomyin cui la taxonomy è uguale a'language' - Estrarre la colonna
description, che contiene i dati di lingua serializzati
Il campo description contiene dati del tipo:
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";}
Per filtrare i post per lingua, devi semplicemente verificare se il term_taxonomy_id corrisponde al termine di lingua specifico (ad esempio, 140 per l’inglese).
Passaggio 2: Relazioni di traduzione
I collegamenti di traduzione tra i post utilizzano la stessa struttura di tabella con una taxonomy diversa:
- Esegui una query su
wp_term_taxonomyin cui la taxonomy è uguale a'post_translations' - La colonna
descriptioncontiene tutti gli ID delle traduzioni
Un risultato tipico è simile a questo:
a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}
Questo array serializzato mappa i codici delle lingue agli ID dei post, creando il gruppo di traduzione.
Come i termini (categorie/tag) gestiscono le lingue
I termini seguono uno schema simile ma leggermente diverso:

Assegnazione della lingua per i termini
Per un termine con ID 14850:
- Esistono più righe in
wp_term_relationshipscon diversi valori diterm_taxonomy_id - La voce corrispondente in
wp_term_taxonomyha taxonomy'term_language'(nota: non solo'language') - Il
term_taxonomy_idper le lingue dei termini è in genere l’ID della lingua dei post + 1 (ad esempio, se i post usano 140, i termini usano 141)
Relazioni di traduzione dei termini
Le relazioni di traduzione per i termini utilizzano:
- Valore di tassonomia
"term_translations"inwp_term_taxonomy - Lo stesso formato di array serializzato nella colonna
description:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}
Perché questo è importante per gli strumenti di traduzione avanzati
Comprendere questa struttura del database è fondamentale per creare funzionalità di traduzione avanzate. Quando abbiamo sviluppato il polylang ai bulk translator per il nostro plugin Polylang AI Automatic Translation, questa conoscenza approfondita ci ha permesso di:
- Interrogare ed elaborare in modo efficiente grandi lotti di contenuti non tradotti
- Mantenere le corrette relazioni di traduzione tra articoli, pagine e tassonomie
- Gestire strutture complesse dei page builder preservando l’integrità dei dati di Polylang
- Creare job di traduzione che funzionano perfettamente con l’architettura di Polylang
Punti chiave
- Polylang utilizza il sistema di tassonomie nativo di WordPress per memorizzare i dati multilingue
- Gli articoli utilizzano le tassonomie
"language"e"post_translations" - I termini utilizzano le tassonomie
"term_language"e"term_translations" - Tutti i dati di lingua e traduzione sono serializzati nella colonna
descriptiondiwp_term_taxonomy - Il
term_taxonomy_idfunge da collegamento tra il contenuto e i suoi dati di lingua/traduzione
Questa architettura è elegante nella sua semplicità, ma per comprenderla appieno è necessario approfondire la struttura del database. Per gli sviluppatori di plugin che lavorano con Polylang, questa conoscenza è inestimabile per creare strumenti che si integrino correttamente con l’ecosistema multilingue.