WPML

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

更新日期：2026年2月4日

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

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

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

快速上手

要开始使用：

  1. 从 OnTheGoSystems GitHub 页面下载 Multilingual Tools 插件 （在新标签页中打开）。
  2. 确保您的网站上已安装并激活 WPML Multilingual CMS 核心插件和 WPML 字符串翻译附加组件。
  3. 确保您的网站上已有一些使用 Elementor 创建的内容。

为何使用 Multilingual Tools 插件

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

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

工作原理

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

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

使用 WPML — Config Generator 生成 XML 代码

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

  1. 新建一个页面并单击使用 Elementor 编辑。
  2. 将您想要注册翻译的自定义小工具添加到页面中。

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

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

将要注册翻译的自定义小工具添加到页面中
将要注册翻译的自定义小工具添加到页面中
  1. 发布页面并返回该页面的 WordPress 编辑屏幕。打开 Meta Boxes 面板，向下滚动到 WPML – Config Generator for Elementor。自 WPML 4.9 起，WPML 会自行注册自定义 Elementor 小工具，因此该部分顶部的框会显示该页面的小工具已注册。您需要的 XML 位于其下方的 WPML Config XML (generated for all widgets in the page) 面板中。
为自定义小工具自动生成的 XML 代码
为自定义小工具自动生成的 XML 代码

测试自动生成的 XML 代码

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

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

  1. 从带有自定义小工具页面的 WordPress 编辑屏幕上，复制WPML Config XML (generated for all widgets in the page)面板中的 XML 代码。
  2. 前往 WPML设置，然后单击自定义 XML 配置选项卡。
  3. 将代码粘贴到编辑器中，然后按保存按钮。检查是否没有出现任何警告或验证错误。确保删除任何不应由用户翻译或修改的字段，例如配置字段和具有布尔值的字段。保留这些字段以供翻译可能会给最终用户带来问题和错误。
将代码粘贴到“自定义 XML 配置”选项卡中的编辑器中
将代码粘贴到“自定义 XML 配置”选项卡中的编辑器中
  1. 返回带有自定义小工具的页面的编辑屏幕。对页面进行细微更改，例如编辑页面标题，然后单击更新。
  1. 在语言框中，单击加号图标以翻译页面。高级翻译编辑器将打开，您应该会看到自定义小工具中已注册的字段可供翻译。审核自动翻译或输入您自己的翻译，完成后单击保存并完成。
在高级翻译编辑器中翻译自定义小工具字段
在高级翻译编辑器中翻译自定义小工具字段
  1. 在前端查看翻译后的页面，确保自定义小工具字段正确显示。

使用其他检查功能

包含 XML 的面板是四个面板之一。其余面板是WPML – Config Generator for Elementor保留在其旁边的调试信息。

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

WPML – Config Generator for Elementor 提供的其他调试信息
WPML – Config Generator for Elementor 提供的其他调试信息

WPML Config XML（为页面中的所有小工具生成）

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

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

来自 _elementor_data 的 RAW 值（JSON）

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

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

从 _elementor_data 生成的数组

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

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

从 _elementor_data 提取的小工具

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

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

作者：Amir