Polylang がデータベースレベルで多言語コンテンツをどのように管理しているかを理解することは、高度な翻訳ツールを構築したり、翻訳の問題をデバッグしたりする開発者にとって不可欠です。Polylang のアーキテクチャを徹底的に調査した結果、この人気の WordPress 多言語プラグインが言語データと翻訳の関連付けをどのように整理しているのかを正確に整理しました。
基盤:WordPress のタクソノミーテーブル
Polylang は WordPress のネイティブなタクソノミーシステムを巧みに活用しています。カスタムテーブルを作成する代わりに、既存の wp_term_relationships と wp_term_taxonomy テーブルを使用して、言語の割り当てと翻訳の関連付けの両方を保存します。このアプローチにより、データベース構造をスリムに保ちながら強力な機能を提供できます。
投稿が言語に紐づく仕組み
投稿に言語が割り当てられると、Polylang は wp_term_relationships テーブルにエントリを作成します。手順は次のとおりです:

ステップ1:言語の割り当て
投稿(例:ID 7834)は、wp_term_relationships 内に対応する object_id を持ち、複数の行(それぞれ異なる term_taxonomy_id を持つ)が存在します。言語を特定するには、次のようにします:
- taxonomy が
'language'に等しいwp_term_taxonomyの一致する行を見つける - シリアライズされた言語データを含む
descriptionカラムを抽出する
description フィールドには次のようなデータが含まれます:
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";}
言語で投稿を絞り込むには、term_taxonomy_id が特定の言語ターム(例:英語なら 140)と一致するかどうかを確認するだけです。
ステップ2:翻訳の関連付け
投稿間の翻訳リンクは、同じテーブル構造を別のタクソノミーで使用します:
- taxonomy が
'post_translations'に等しいwp_term_taxonomyをクエリする -
descriptionカラムにすべての翻訳 ID が含まれる
典型的な結果は次のようになります:
a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}
このシリアライズ配列は、言語コードを投稿 ID にマッピングし、翻訳グループを作成します。
ターム(カテゴリー/タグ)が言語を扱う仕組み
タームも同様ですが、少し異なるパターンに従います:

タームの言語割り当て
ID 14850 のタームの場合:
-
term_taxonomy_idの値が異なる複数の行がwp_term_relationshipsに存在する -
wp_term_taxonomyの一致するエントリの taxonomy は'term_language'(注:単なる'language'ではない) - ターム言語の
term_taxonomy_idは通常、投稿言語 ID + 1(例:投稿が 140 を使用する場合、タームは 141 を使用)
ターム翻訳の関連付け
タームの翻訳の関連付けでは、以下を使用します:
-
wp_term_taxonomy内のタクソノミー値'term_translations' -
descriptionカラム内の同じシリアライズ配列形式:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}
高度な翻訳ツールにとってこれが重要な理由
このデータベース構造を理解することは、高度な翻訳機能を構築するうえで不可欠です。私たちが Polylang AI Automatic Translation プラグイン向けに polylang ai bulk translator を開発した際、この深い知識によって次のことが可能になりました:
- 未翻訳コンテンツの大量バッチを効率的にクエリし、処理する
- 投稿、固定ページ、タクソノミー全体で適切な翻訳の関連付けを維持する
- Polylang のデータ整合性を保ちながら、複雑なページビルダー構造を扱う
- Polylang のアーキテクチャとシームレスに連携する翻訳ジョブを作成する
重要なポイント
- Polylang は、多言語データの保存に WordPress ネイティブのタクソノミーシステムを使用する
- 投稿は
'language'と'post_translations'のタクソノミーを使用する - タームは
'term_language'と'term_translations'のタクソノミーを使用する - 言語および翻訳のデータはすべて、
wp_term_taxonomyのdescriptionカラムにシリアライズされて保存される -
term_taxonomy_idは、コンテンツと言語/翻訳データを結び付けるリンクとして機能する
このアーキテクチャはシンプルさの点で洗練されていますが、完全に理解するにはデータベース構造を掘り下げる必要があります。Polylang を扱うプラグイン開発者にとって、この知識は多言語エコシステムに適切に統合されるツールを作るうえで非常に貴重です。