Comment Polylang stocke les traductions dans la base de données WordPress : une analyse technique approfondie

Robbert Vermeulen

Robbert Vermeulen

· 5 min de lecture

Comprendre comment Polylang gère le contenu multilingue au niveau de la base de données est essentiel pour les développeurs qui créent des outils de traduction avancés ou qui dépannent des problèmes de traduction. Après des recherches approfondies sur l’architecture de Polylang, nous avons cartographié précisément la façon dont ce populaire plugin multilingue pour WordPress organise les données de langue et les relations de traduction.

Les bases : les tables de taxonomie WordPress

Polylang exploite intelligemment le système de taxonomie natif de WordPress. Au lieu de créer des tables personnalisées, il utilise les tables existantes wp_term_relationships et wp_term_taxonomy pour stocker à la fois les attributions de langue et les relations de traduction. Cette approche maintient une structure de base de données légère tout en offrant de puissantes fonctionnalités.

Comment les articles sont liés aux langues

Lorsqu’un article se voit attribuer une langue, Polylang crée des entrées dans la table wp_term_relationships. Voici le processus :

Étape 1 : Attribution de la langue

Un article (par ex., ID 7834) possède un object_id correspondant dans wp_term_relationships avec plusieurs lignes, chacune ayant un term_taxonomy_id différent. Pour identifier la langue, vous :

  1. Recherchez les lignes correspondantes dans wp_term_taxonomy où la taxonomie est égale à 'language'
  2. Extrayez la colonne description, qui contient des données de langue sérialisées

Le champ description contient des données comme :

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

Pour filtrer les articles par langue, il suffit de vérifier si le term_taxonomy_id correspond au terme de langue spécifique (par ex., 140 pour l’anglais).

Étape 2 : Relations de traduction

Les liens de traduction entre articles utilisent la même structure de table avec une taxonomie différente :

  1. Interrogez wp_term_taxonomy où la taxonomie est égale à 'post_translations'
  2. La colonne description contient tous les ID de traduction

Un résultat typique ressemble à ceci :

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

Ce tableau sérialisé associe les codes de langue aux IDs d’article, créant le groupe de traduction.

Comment les termes (catégories/étiquettes) gèrent les langues

Les termes suivent un schéma similaire mais légèrement différent :

Attribution de la langue pour les termes

Pour un terme avec l’ID 14850 :

  1. Plusieurs lignes existent dans wp_term_relationships avec différentes valeurs de term_taxonomy_id
  2. L’entrée correspondante dans wp_term_taxonomy a pour taxonomie 'term_language' (remarque : pas seulement 'language')
  3. Le term_taxonomy_id pour les langues des termes est généralement l’ID de langue des articles + 1 (par ex., si les articles utilisent 140, les termes utilisent 141)

Relations de traduction des termes

Les relations de traduction pour les termes utilisent :

  1. La valeur de taxonomie 'term_translations' dans wp_term_taxonomy
  2. Le même format de tableau sérialisé dans la colonne description :
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}

Pourquoi c’est important pour les outils de traduction avancés

Comprendre cette structure de base de données est crucial pour développer des fonctionnalités de traduction sophistiquées. Lorsque nous avons développé le polylang ai bulk translator pour notre extension Polylang AI Automatic Translation, cette connaissance approfondie nous a permis de :

  • Interroger et traiter efficacement de grands lots de contenus non traduits
  • Maintenir des relations de traduction correctes entre articles, pages et taxonomies
  • Gérer des structures complexes de constructeurs de pages tout en préservant l’intégrité des données de Polylang
  • Créer des tâches de traduction qui fonctionnent de manière fluide avec l’architecture de Polylang

Points clés à retenir

  • Polylang utilise le système de taxonomie natif de WordPress pour stocker les données multilingues
  • Les articles utilisent les taxonomies 'language' et 'post_translations'
  • Les termes utilisent les taxonomies 'term_language' et 'term_translations'
  • Toutes les données de langue et de traduction sont sérialisées dans la colonne description de wp_term_taxonomy
  • Le term_taxonomy_id sert de lien entre le contenu et ses données de langue/traduction

Cette architecture est élégante dans sa simplicité, mais la comprendre pleinement nécessite d’examiner la structure de la base de données. Pour les développeurs d’extensions travaillant avec Polylang, cette connaissance est inestimable pour créer des outils qui s’intègrent correctement à l’écosystème multilingue.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Voir tous les articles →