Hoe Polylang vertalingen opslaat in de WordPress-database: een technische deep dive

Robbert Vermeulen

Robbert Vermeulen

· 4 min leestijd

Begrijpen hoe Polylang meertalige content op databaseniveau beheert, is essentieel voor ontwikkelaars die geavanceerde vertaaltools bouwen of vertaalproblemen debuggen. Na uitgebreid onderzoek naar de architectuur van Polylang hebben we precies in kaart gebracht hoe deze populaire meertalige WordPress-plugin taalgegevens en vertaalrelaties organiseert.

De basis: WordPress-taxonomietabellen

Polylang maakt op een slimme manier gebruik van het native taxonomiesysteem van WordPress. In plaats van aangepaste tabellen te creëren, gebruikt het de bestaande tabellen wp_term_relationships en wp_term_taxonomy om zowel taaltoewijzingen als vertaalrelaties op te slaan. Deze aanpak houdt de databasestructuur slank en biedt tegelijk krachtige functionaliteit.

Hoe berichten aan talen worden gekoppeld

Wanneer een bericht een taal toegewezen krijgt, maakt Polylang regels aan in de tabel wp_term_relationships. Dit is het proces:

Stap 1: Taalkoppeling

Een bericht (bijv. ID 7834) heeft een overeenkomstige object_id in wp_term_relationships met meerdere regels, elk met een andere term_taxonomy_id. Om de taal te identificeren, doe je het volgende:

  1. Zoek overeenkomende regels in wp_term_taxonomy waar de taxonomy gelijk is aan 'language'
  2. Haal de kolom description op, die geserialiseerde taalgegevens bevat

Het description-veld bevat gegevens zoals:

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";}

Om berichten op taal te filteren controleer je simpelweg of de term_taxonomy_id overeenkomt met de specifieke taalterm (bijv. 140 voor Engels).

Stap 2: Vertaalrelaties

Vertaalverbindingen tussen berichten gebruiken dezelfde tabelstructuur met een andere taxonomy:

  1. Voer een query uit op wp_term_taxonomy waar de taxonomy gelijk is aan 'post_translations'
  2. De kolom description bevat alle vertaal-ID’s

Een typisch resultaat ziet er zo uit:

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

Deze geserialiseerde array koppelt taalcodes aan bericht-ID’s en vormt zo de vertaalgroep.

Hoe termen (categorieën/tags) met talen omgaan

Termen volgen een vergelijkbaar, maar iets afwijkend patroon:

Taalkoppeling voor termen

Voor een term met ID 14850:

  1. Er bestaan meerdere regels in wp_term_relationships met verschillende term_taxonomy_id‑waarden
  2. De bijbehorende regel in wp_term_taxonomy heeft taxonomy 'term_language' (let op: niet alleen 'language')
  3. De term_taxonomy_id voor termtalen is meestal de post-taal-ID + 1 (bijv. als berichten 140 gebruiken, gebruiken termen 141)

Relaties voor termvertalingen

Vertaalrelaties voor termen gebruiken:

  1. Taxonomie-waarde 'term_translations' in wp_term_taxonomy
  2. Dezelfde geserialiseerde array-indeling in de kolom description:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}

Waarom dit belangrijk is voor geavanceerde vertaaltools

Inzicht in deze databasestructuur is cruciaal voor het bouwen van geavanceerde vertaalfunctionaliteit. Toen we de polylang ai bulk translator ontwikkelden voor onze Polylang AI Automatic Translation-plugin, stelde deze diepgaande kennis ons in staat om:

  • Grote batches niet-vertaalde inhoud efficiënt op te vragen en te verwerken
  • Juiste vertaalrelaties te behouden tussen berichten, pagina’s en taxonomieën
  • Complexe pagebuilder-structuren te verwerken met behoud van de gegevensintegriteit van Polylang
  • Vertaaljobs te creëren die naadloos samenwerken met de architectuur van Polylang

Belangrijkste punten

  • Polylang gebruikt het native taxonomiesysteem van WordPress om meertalige gegevens op te slaan
  • Berichten gebruiken de taxonomieën 'language' en 'post_translations'
  • Termen gebruiken de taxonomieën 'term_language' en 'term_translations'
  • Alle taal- en vertaalgegevens worden geserialiseerd in de kolom description van wp_term_taxonomy
  • De term_taxonomy_id fungeert als de koppeling tussen content en de bijbehorende taal-/vertaalgegevens

Deze architectuur is elegant in zijn eenvoud, maar om haar volledig te begrijpen moet je je verdiepen in de databasestructuur. Voor plug-inontwikkelaars die met Polylang werken, is deze kennis van onschatbare waarde voor het creëren van tools die goed integreren met het meertalige ecosysteem.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Bekijk alle berichten →