Polylang 如何在 WordPress 数据库中存储翻译:技术深度解析

Robbert Vermeulen

Robbert Vermeulen

· 1 分钟阅读

理解 Polylang 在数据库层面如何管理多语言内容,对于正在构建高级翻译工具或排查翻译问题的开发者而言至关重要。在对 Polylang 的架构进行了大量研究之后,我们梳理出了这款流行的 WordPress 多语言插件究竟是如何组织语言数据以及翻译关联关系的。

基础:WordPress 分类法(Taxonomy)数据表

Polylang 以一种巧妙的方式利用了 WordPress 原生的 taxonomy 系统。它不创建自定义表,而是使用现有的 wp_term_relationships 和 wp_term_taxonomy 表来存储语言归属以及翻译关联关系。该方法在保持数据库结构精简的同时,仍能提供强大的功能。

文章如何与语言关联

当为一篇文章指定语言时,Polylang 会在 wp_term_relationships 表中创建记录。流程如下:

步骤 1:语言分配

一篇文章(例如 ID 为 7834)在 wp_term_relationships 中会有对应的 object_id,并且可能存在多行记录,每一行都有不同的 term_taxonomy_id。要识别其语言,你需要:

  1. 在 wp_term_taxonomy 中找到 taxonomy 等于 'language' 的匹配行
  2. 提取 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 是否与特定语言的 term(例如英语为 140)匹配即可。

步骤 2:翻译关联关系

文章之间的翻译链接使用相同的表结构,但采用不同的 taxonomy:

  1. 查询 wp_term_taxonomy,其中 taxonomy 等于 'post_translations'
  2. description 列包含所有翻译文章的 ID

一个典型的结果如下所示:

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

这个序列化数组将语言代码映射到文章 ID,从而创建翻译分组。

分类项(分类/标签)如何处理语言

分类项(term)遵循类似但略有不同的模式:

为分类项分配语言

对于一个 ID 为 14850 的分类项:

  1. 在 wp_term_relationships 中会存在多行记录,对应不同的 term_taxonomy_id 值
  2. 在 wp_term_taxonomy 中,与之匹配的条目的 taxonomy 为 'term_language'(注意:并非只是 'language')
  3. 用于分类项语言的 term_taxonomy_id 通常是文章语言 ID + 1(例如,文章使用 140,则分类项使用 141)

分类项翻译关联关系

分类项的翻译关联关系使用:

  1. wp_term_taxonomy 中的分类法值 'term_translations'
  2. 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 一起开发插件的开发者而言,这些知识对于创建能够正确融入多语言生态的工具极为宝贵。

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

查看所有文章 →