Come Polylang memorizza le traduzioni nel database di WordPress: un’analisi tecnica approfondita

Robbert Vermeulen

Robbert Vermeulen

· 4 min di lettura

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:

  1. Trovare le righe corrispondenti in wp_term_taxonomy in cui la taxonomy è uguale a 'language'
  2. 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:

  1. Esegui una query su wp_term_taxonomy in cui la taxonomy è uguale a 'post_translations'
  2. La colonna description contiene 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:

  1. Esistono più righe in wp_term_relationships con diversi valori di term_taxonomy_id
  2. La voce corrispondente in wp_term_taxonomy ha taxonomy 'term_language' (nota: non solo 'language')
  3. Il term_taxonomy_id per 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:

  1. Valore di tassonomia "term_translations" in wp_term_taxonomy
  2. 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 description di wp_term_taxonomy
  • Il term_taxonomy_id funge 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.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Vedi tutti gli articoli →