保持 WPBakery Page Builder 与 WPML 的兼容性

WPBakery Page Builder 与 WPML 的兼容性是通过语言配置文件来保证的。了解如何使用此文件来保持兼容性。

本页面面向 WPBakery 开发团队、提供页面构建器定制版本的开发者、开发 WPBakery 附加组件的作者以及使用 WPBakery Page Builder 的 Web 开发者。

如果您是希望翻译使用 WPBakery 构建的网站的客户，请参阅我们的详细文档以详细了解使用 WPBakery Page Builder 和 WPML 构建多语言网站。

WPBakery Page Builder 与 WPML 的集成是如何工作的

为了解 WPBakery Page Builder 如何与 WPML 协同工作，我们将首先使用 WPBakery Page Builder 创建一个简单的页面。我们将包含几个模块，例如 Text Block（文本区块）、Message Box（消息框）和 Hover Box。（悬停框）

要翻译我们创建的页面，请单击右侧边栏语言元框中的加号图标。

这会将您带到高级翻译编辑器屏幕，您可以在其中翻译您的页面。填写每个句子的翻译，然后单击绿色复选标记进行确认。对所有翻译满意后，单击完成。

更新语言配置文件

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

1. 向页面构建器添加新简码
2. 向现有简码添加新属性
3. 删除废弃的简码

您可以从我们的存储库下载语言配置文件。将简码或属性添加到语言配置文件中的现有简码中。

对于在主题中捆绑 WPBakery Page Builder 定制版本的作者，请注意，您需要更新该定制版本插件的语言配置文件。

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

要从使用 WPBakery Page Builder 构建的页面中提取字符串并将其加载到翻译编辑器屏幕上，我们需要配置 WPML 以识别包含需要翻译的字符串的简码和属性。这可以通过添加一个名为 wpml-config.xml 的文件来完成，该文件通常放置在主题的根目录中。对于 WPBakery Page Builder，我们将语言配置文件托管在我们的服务器上。它被设置为覆盖放置在 WPBakery Page Builder 根目录中的本地配置文件，以确保配置文件始终是最新的。

wpml-config.xml 文件还用于配置以下元素：

1. 自定义字段
2. 自定义分类法
3. 管理文本 / wp_options
4. 语言切换器配置
5. 页面构建器简码

请参阅我们的详细文档，以详细了解语言配置文件的结构和语法。

作为一个示例，让我们看看如何将 Tabs 简码添加到 wpml-config.xml 文件中。

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

上述示例的结构可以分解如下：

• 所有简码都包裹在主 shortcodes（复数）标签中。
• shortcode 标签包裹属于单个简码的所有标签。
• tag 标签定义了简码的名称，在本例中为 vc_tta_tabs。
• 简码可以包含一个或多个属性；因此，我们将它们包裹在 attributes（复数）标签中，并使用 attribute（单数）标签来定义每个属性的标题。在本例中，我们有 title 属性。

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

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

测试语言配置文件

要测试更新后的语言配置文件，请按照以下步骤操作：

1. 设置一个同时激活了 WPBakery Page Builder 和 WPML 的安装。下载并激活字符串翻译和媒体翻译附加组件。
2. 您需要使用更新后的文件覆盖远程语言配置文件。为此，请导航至 WPML → 设置页面，然后单击自定义 XML 配置选项卡。将更新后的语言配置文件内容复制到编辑器中，然后单击保存。

3. 创建一个新页面并向其中添加新模块。如果您更新了现有模块的某些属性，也请将这些模块添加到页面中。在本例中，我们将假设 Call To Action 模块是新添加到 WPBakery Page Builder 中的。将其添加到页面并发布。

4. 单击加号图标以翻译页面。这会将您带到高级翻译编辑器屏幕。
5. 确保模块文本元素显示在高级翻译编辑器中。
6. 填写您的翻译并使用绿色复选标记进行确认。完成后，单击完成按钮。

7. 在前端检查已翻译的页面。

已翻译的页面显示了所有已翻译的字符串，这意味着更新后的语言配置文件正常工作。

请注意，页面元素的 CSS 样式会从原始语言复制到翻译语言。这可确保在不同语言之间一切看起来都正确。如果您想禁用此功能，请参阅本文以获取说明。

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

完成测试后，请向我们的存储库提交合并请求。我们的兼容性开发人员将收到您的请求并进行审核。

请注意，我们存储库中托管的语言配置文件适用于 WPBakery Page Builder 的默认版本。如果您要更新 WPBakery Page Builder 定制版本的语言配置文件，请将更改应用于插件根目录中的配置文件。