WPML

Avada Builder 与 WPML 的兼容性通过语言配置文件来保证。我们将向您展示如何使用和更新此文件以维护兼容性。

此文档面向 Avada 开发团队和使用 Avada 的 Web 开发者。如果您是希望翻译使用 Avada 构建的网站的客户,请参阅我们关于使用 Avada 和 WPML 构建多语言网站的文档页面

开始使用

开始之前,请确保您的网站已安装并激活以下内容:

Avada Builder 与 WPML 的集成如何工作

要了解 Avada Builder 如何与 WPML 配合使用,让我们先使用 Avada Builder 创建一篇简单的文章。我们将包含几个模块,例如 Text BlockAlertFlip Box

使用 Avada Builder 构建的简单页面

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

单击加号图标以翻译文章

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

在高级翻译编辑器中翻译文章

更新语言配置文件

您可能因为不同的原因需要更新语言配置文件中的页面构建器简码:

  • 向页面构建器添加新简码
  • 向现有简码添加新属性
  • 删除已废弃的简码

您可以从我们的代码库下载语言配置文件。然后,您可以将新简码或属性添加到语言配置文件中的现有简码里。

语言配置文件中的页面构建器简码结构

要从使用 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_fronttitle_backtext_frontimage

对于包含链接属性的简码,您可以通过为属性使用 type 选项,使内部链接自动指向该文章的翻译版本。以下是一个示例:

包含链接属性的 Avada Builder 简码示例
<shortcode>
   <tag>fusion_soundcloud</tag>
   <attributes>
      <attribute type="link">url</attribute>
   </attributes>
</shortcode>

测试更新后的语言配置文件

要测试更新后的语言配置文件,请确认您的网站已安装并激活 Avada、WPML 核心插件和 WPML 字符串翻译

您需要首先使用更新后的文件覆盖远程语言配置文件。为此:

  1. 前往 WPML设置,然后单击自定义 XML 配置选项卡。将更新后的语言配置文件内容粘贴到编辑器中,然后单击保存
使用更新后的文件覆盖现有的语言配置文件
  1. 创建一个新页面并向其中添加新模块。如果您更新了现有模块的某些属性,也请将它们添加到页面中。出于演示目的,我们将创建一个包含 Button 模块的页面,并假设它是新添加到 Avada Builder 中的。
  1. 语言框中,单击加号图标以翻译页面。
单击加号图标以翻译包含新模块的测试页面
  1. 您将被带到高级翻译编辑器,您可以在其中单击每行旁边的加号图标来翻译模块的文本元素。
在高级翻译编辑器中翻译模块的文本元素
  1. 如果您想翻译按钮链接,请开始在页面顶部的搜索 搜索栏中输入 URL 名称。添加完翻译后,请记得单击完成按钮。
使用“搜索源”搜索栏翻译按钮链接

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

在前端查看新翻译的页面

获取帮助

如果您遇到任何问题,请联系我们的兼容性开发团队。他们将很乐意协助您检查与语言配置文件相关的问题。

完成测试后,请向我们的代码库提交合并请求。我们的兼容性开发人员将接收并审核您的请求。

作者:Amir · 最后更新时间:2025年12月24日