Avada Builder 与 WPML 的兼容性通过语言配置文件来保证。我们将向您展示如何使用和更新此文件以维护兼容性。
此文档面向 Avada 开发团队和使用 Avada 的 Web 开发者。如果您是希望翻译使用 Avada 构建的网站的客户,请参阅我们关于使用 Avada 和 WPML 构建多语言网站的文档页面。
开始使用
开始之前,请确保您的网站已安装并激活以下内容:
Avada Builder 与 WPML 的集成如何工作
要了解 Avada Builder 如何与 WPML 配合使用,让我们先使用 Avada Builder 创建一篇简单的文章。我们将包含几个模块,例如 Text Block、Alert 和 Flip Box。

要翻译该文章,请找到右侧边栏中的语言框,然后单击您希望将文章翻译成的语言旁边的加号图标。

这会将您带到高级翻译编辑器,您可以在其中翻译页面。单击每行旁边的加号图标以添加翻译。全部完成后,单击完成按钮。

更新语言配置文件
您可能因为不同的原因需要更新语言配置文件中的页面构建器简码:
- 向页面构建器添加新简码
- 向现有简码添加新属性
- 删除已废弃的简码
您可以从我们的代码库下载语言配置文件。然后,您可以将新简码或属性添加到语言配置文件中的现有简码里。
语言配置文件中的页面构建器简码结构
要从使用 Avada Builder 构建的页面中提取字符串并将其加载到高级翻译编辑器中,需要配置 WPML 以识别包含需要翻译的字符串的简码和属性。
这是通过添加一个名为 wpml-config.xml 的文件来完成的,该文件通常放置在主题的根目录中。对于 Avada,我们将语言配置文件托管在我们的服务器上。它被设置为覆盖放置在 Avada 根目录中的本地配置文件,从而确保配置文件始终是最新的。
wpml-config.xml 文件还用于配置以下元素:
- 自定义字段
- 自定义分类法
- 管理文本 / wp_options
- 语言切换器配置
- 页面构建器简码
您可以访问我们关于语言配置文件的页面,了解有关语言配置文件结构和语法的更多信息。
例如,让我们看看如何将 Flip Box 简码添加到 wpml-config.xml 文件中:
语言配置文件中的 Avada Builder 简码示例
<shortcodes>
<shortcode>
<tag>fusion_flip_box</tag>
<attributes>
<attribute>title_front</attribute>
<attribute>title_back</attribute>
<attribute>text_front</attribute>
<attribute>image</attribute>
</attributes>
</shortcode>
</shortcodes>上述示例的结构可以分解如下:
- 所有简码都包裹在 shortcodes 标签中
- shortcode 标签包裹属于单个简码的所有标签。
- tag 标签定义简码的名称,在本例中为 fusion_flip_box。
- 简码可以具有一个或多个属性,这就是为什么我们将它们包裹在 attributes(复数)标签中,并使用 attribute(单数)标签来定义每个属性的标题。在本例中,我们有 title_front、title_back、text_front 和 image。
对于包含链接属性的简码,您可以通过为属性使用 type 选项,使内部链接自动指向该文章的翻译版本。以下是一个示例:
包含链接属性的 Avada Builder 简码示例
<shortcode>
<tag>fusion_soundcloud</tag>
<attributes>
<attribute type="link">url</attribute>
</attributes>
</shortcode>测试更新后的语言配置文件
要测试更新后的语言配置文件,请确认您的网站已安装并激活 Avada、WPML 核心插件和 WPML 字符串翻译。
您需要首先使用更新后的文件覆盖远程语言配置文件。为此:
- 前往 WPML → 设置,然后单击自定义 XML 配置选项卡。将更新后的语言配置文件内容粘贴到编辑器中,然后单击保存。

- 创建一个新页面并向其中添加新模块。如果您更新了现有模块的某些属性,也请将它们添加到页面中。出于演示目的,我们将创建一个包含 Button 模块的页面,并假设它是新添加到 Avada Builder 中的。
- 在语言框中,单击加号图标以翻译页面。

- 您将被带到高级翻译编辑器,您可以在其中单击每行旁边的加号图标来翻译模块的文本元素。

- 如果您想翻译按钮链接,请开始在页面顶部的搜索 源搜索栏中输入 URL 名称。添加完翻译后,请记得单击完成按钮。

要查看翻译后的页面是否显示所有翻译的字符串,以及更新后的语言配置文件是否正常工作,您可以在前端查看新翻译的页面。

获取帮助
如果您遇到任何问题,请联系我们的兼容性开发团队。他们将很乐意协助您检查与语言配置文件相关的问题。
完成测试后,请向我们的代码库提交合并请求。我们的兼容性开发人员将接收并审核您的请求。