WPML 可以读取一个配置文件,该文件会告诉它主题和插件中需要翻译的内容。此文件名为 wpml-config.xml,放置在插件或主题的根目录中。
语言配置文件的用途
作为实现与 WPML 兼容性的一部分,您还应该创建一个配置文件,以帮助您在未来的版本中保持兼容性。WPML 可以翻译您的 WordPress 网站上的任何内容,但您需要告诉它哪些内容需要翻译。此文件就是用来完成这项工作的。
前往 WPML→ 设置页面。

此页面告诉 WPML 它需要知道的一切信息,包括要翻译或同步哪些自定义字段、哪些自定义文章类型和分类法应支持多语言,甚至要翻译哪些管理文本。
语言配置文件包含这些信息,因此每个用户都无需在管理后台页面中手动输入。
对于某些主题和插件,我们将语言配置文件托管在我们的服务器上。您可以在此处查看列表。它被设置为覆盖放置在主题或插件根目录中的本地语言配置文件。
WPML 还允许您手动覆盖由主题和插件语言配置文件加载的任何设置。这适用于主题或插件根目录中的语言配置文件,以及托管在我们服务器上的语言配置文件。
为第三方主题和插件设置翻译选项
WPML 兼容许多热门的主题和插件,对于它们,您不需要创建语言配置文件。
但是,如果您使用的主题或插件的内容在 WPML 的高级翻译编辑器中无法正确显示,您可能需要手动配置其翻译选项。
要为第三方主题和插件配置翻译选项,请前往 WPML → 设置,然后单击自定义 XML 配置选项卡。使用此页面上的文本编辑器输入代码,就像您创建 wpml-config.xml 文件时一样。

自动生成 wpml-config.xml 文件
如果您不熟悉创建 XML 文件,我们的团队创建了 Multilingual Tools 插件,使这项任务变得更加简单。虽然它最初是作为帮助主题和插件作者使其产品 Multilingual Ready(支持多语言)的工具而构思的,但它可以轻松用于生成您自己的 wpml-config.xml 文件。
要了解有关生成 wpml-config.xml 文件的更多信息,请访问 Multilingual Tools 插件页面。具体来说,请查看如何使用 Multilingual Tools 生成语言配置文件?部分。
获得配置文件后,将其添加到主题文件夹的根目录中。如果您已经有一个配置文件,请不要覆盖它。相反,请编辑原始的 XML 文件,并添加使用 Multilingual Tools 插件生成的代码。
请注意,此插件不适用于实时的生产站点。
要阅读本教程并为您的主题和插件构建语言配置文件,您可以从这个示例文件开始 – wpml-config.zip。
您需要对其进行编辑,但可以使用此文件的部分和结构。
结构和语法
WPML 允许您使用 wpml-config.xml 文件配置许多元素。使用以下指南查找有关如何使特定网站元素可翻译的更多信息和说明:
- 使用 WPML 翻译自定义简码
- 注册页面构建器内容以进行翻译
- 注册自定义页面构建器小工具以进行翻译
- 使用 WPML 配置文件为自定义字段设置翻译选项
- 将自定义项目、Types 和分类法注册为可翻译
- 使自定义 Gutenberg 区块可翻译
- 翻译主题和插件保存在 wp_options 中的文本
- 使用 WPML 配置文件自定义 WPML 语言切换器
- 启用数值以进行翻译
在子主题中使用 WPML 语言配置文件
如果您使用的是子主题,则父主题的语言配置文件将覆盖在子主题中找到的文件。WPML 提供了一个配置页面,允许您轻松使用任何自定义设置覆盖它。
让我们考虑一个示例,其中父主题的语言配置文件将自定义文章类型“Property”设置为可翻译。

如果您使用的是子主题,并希望将自定义文章类型“Property”设置为不可翻译,请导航至 WPML → 设置页面,然后单击自定义 XML 配置选项卡。使用编辑器将自定义文章类型“Property”设置为不可翻译。只需将 translate 属性值设置为 0 而不是 1 即可。
