Avia Layout Builder 与 WPML 的兼容性是通过语言配置文件来保证的。了解如何使用此文件来保持兼容性。
本页面面向 Enfold 开发团队、提供页面构建器定制版本的开发者、开发 Avia Layout Builder 附加组件的作者以及使用 Enfold 的 Web 开发者。
Avia Layout Builder 与 WPML 的集成方式
要了解 Avia Layout Builder 如何与 WPML 配合使用，让我们先使用 Avia Layout Builder 创建一个简单的页面。我们将包含几个模块，例如 Text Block、Icon Box 和 Button。
这些模块将内容包装在简码中：
要翻译我们创建的页面，请单击侧边栏语言元框中的加号图标。
这将在高级翻译编辑器中打开页面，您可以在其中翻译页面。添加您的翻译并单击完成。
现在，当我们在前端查看翻译后的页面时，可以看到已翻译的内容。
更新语言配置文件
您可能出于不同原因需要更新语言配置文件中的页面构建器简码：
- 向页面构建器添加新简码
- 向现有简码添加新属性
- 删除过时的简码
您可以从我们的存储库下载语言配置文件。将简码或属性添加到语言配置文件内的现有简码中。
语言配置文件中的页面构建器简码结构
要从使用 Avia Layout Builder 构建的页面中提取字符串并将其加载到翻译编辑器屏幕上，我们需要配置 WPML 以识别包含需要翻译的字符串的简码和属性。这是通过添加一个名为 wpml-config.xml 的文件来实现的，该文件通常放置在主题的根文件夹中。对于 Enfold，我们将语言配置文件托管在我们的服务器上。它被设置为覆盖放置在 Enfold 根文件夹中的本地配置文件，以确保配置文件始终是最新的。
wpml-config.xml 文件还用于配置以下元素：
- 自定义字段
- 自定义分类法
- 管理文本 / wp_options
- 语言切换器配置
- 页面构建器简码
请参阅我们的详细文档，了解有关语言配置文件结构和语法的更多信息。
举个例子，让我们看看如何将 Button 简码添加到 wpml-config.xml 文件中：
<wp-config>
<shortcodes>
<shortcode>
<tag>av_button</tag>
<attributes>
<attribute>label</attribute>
<attribute type="link" encoding="av_link">link</attribute>
</attributes>
</shortcode>
</shortcodes>
</wp-config>
上述示例的结构可以分解如下：
- 所有简码都包装在主 shortcodes（复数）标签中。
- shortcode（单数）标签包装属于单个简码的所有标签。
- tag 标签定义简码的名称，在本例中为 av_button。
- 简码可以包含一个或多个属性；因此，我们将它们包装在 attributes（复数）标签中，并使用 attribute（单数）标签来定义每个属性的标题。在本例中，我们有 label 和 link 属性。
对于包含链接属性的简码，如上一个示例所示，您可以通过为属性使用类型选项“link”，使内部链接自动指向该文章的翻译版本。
测试语言配置文件
要测试更新后的语言配置文件，请按照以下步骤操作：
- 设置一个同时激活了 Enfold 和 WPML 的站点环境。激活字符串翻译和媒体翻译附加组件。
- 您需要使用更新后的文件覆盖远程语言配置文件。为此，请前往 WPML → 设置页面，然后单击自定义 XML 配置选项卡。将更新后的语言配置文件的内容复制到编辑器中，然后单击保存。
- 创建一个新页面，并将新模块添加到其中。如果您更新了现有模块的某些属性，也请将它们添加到页面中。在本例中，我们将假设 Button 模块是新添加到 Avia Layout Builder 中的。将其添加到页面并发布。
- 单击加号图标以翻译页面。这会将您带到高级翻译编辑器屏幕。
- 确保模块的文本显示在高级翻译编辑器中。
- 添加您的翻译，然后单击完成以保存并应用翻译。
- 在前端检查翻译后的页面。
翻译后的页面显示了所有已翻译的字符串，这意味着更新后的语言配置文件工作正常。如果您遇到任何问题，请联系我们的兼容性开发团队。他们将很乐意检查与语言配置文件相关的问题。
完成测试后，请向我们的存储库提交合并请求。我们的兼容性开发人员将收到您的请求并进行审核。