使用 Multilingual Tools 插件注册自定义 Elementor 小工具以进行翻译

Multilingual Tools 插件是一个测试插件，您可以在注册自定义 Elementor 小工具以进行翻译时使用。该插件包含一个 WPML – Config Generator for Elementor，可自动为这些自定义小工具生成首个版本的 XML 代码。

使用此工具，您将能够获取注册小工具所需的信息。

本指南面向开发 Elementor 主题和插件并希望使其与 WPML 兼容的开发者。如果您不是开发者，请查看我们的如何使用 WPML 翻译 Elementor 网站指南。

快速上手

要开始使用：

在 WPML 4.9 及更新版本中，WPML 会自动识别自定义 Elementor 小工具并使其可翻译。然而，它可能会注册一些您不希望翻译的字符串。

因此，我们建议使用 Multilingual Tools 注册自定义 Elementor 小工具以进行翻译。这使您能够精确控制哪些字段可翻译。

当您使用 Elementor 页面构建器创建页面时，所有内容都会保存在 _elementor_data 自定义字段中。

将要注册翻译的自定义小工具添加到页面后，WPML – Config Generator for Elementor 会访问此 _elementor_data 字段以读取其内容。读取后，它会将数据转换为与页面上使用的自定义小工具相对应的 XML 代码。

要自动为自定义小工具生成 XML 代码：

重要提示：添加小工具以使其可翻译时，请务必填写所有字段并启用所有可用选项。

这是因为 WPML – Config Generator for Elementor 不会为任何未配置的字段或选项生成 XML 代码。

发布页面并返回该页面的 WordPress 编辑屏幕。向下滚动到标有 WPML: Elementor Widgets 的部分。您将看到为尚未注册翻译的小工具字段和设置生成的 XML 代码。

在向最终用户提供代码之前，请确保对其进行全面审核和测试。WPML – Config Generator for Elementor 只是一个起点。

要测试自动生成的 XML 代码：

从带有自定义小工具的页面的 WordPress 编辑屏幕上标有 WPML: Elementor Widgets 的部分复制 XML 代码。
前往 WPML → 设置，然后单击自定义 XML 配置选项卡。
将代码粘贴到编辑器中，然后按保存按钮。检查是否没有出现任何警告或验证错误。确保删除任何不应由用户翻译或修改的字段，例如配置字段和具有布尔值的字段。保留这些字段以供翻译可能会给最终用户带来问题和错误。

在语言框中，单击加号图标以翻译页面。高级翻译编辑器将打开，您应该会看到自定义小工具中已注册的字段可供翻译。审核自动翻译或输入您自己的翻译，完成后单击完成。

除了为自定义 Elementor 小工具自动生成 XML 代码外，WPML – Config Generator for Elementor 还提供其他调试信息。

这些信息使您能够检查并了解底层数据及其使用方式。在某些特定情况下，例如 XML 代码未按预期工作时，这可能会很有用。

作用：提供页面上所有小工具的 XML 代码，包括已注册翻译的小工具。

用途：允许您审核或编辑现有小工具设置的 XML 代码。

作用：显示文章 _elementor_data 字段的原始值。

用途：让您查看 WPML – Config Generator for Elementor Widgets 用于生成 XML 代码的数据。

作用：提供文章 _elementor_data 字段的值，已转换为数组。

用途：您可以使用该数组进行调试。

作用：显示插件能够从 _elementor_data 字段中提取并使用的自定义小工具。

用途：如果您在此处未看到自定义小工具、自定义小工具字段或自定义小工具选项，则它不会被添加到 XML 中。这对于调试非常有用。