WPML

向 WPML 寻求支持之前 – 故障排除清单

大多数 WPML 问题都可以自行解决。在寻求支持之前，浏览此清单可以节省双方的时间，并在许多情况下直接解决问题。如果清单未能解决问题，您将准备好支持团队首先会要求提供的信息，以便将其包含在您的问题中。

  1. 确保系统满足 WPML 的最低要求

    打开 WPML > 支持。如果您的网站低于 WPML 的最低要求（PHP 版本、所需的 PHP 扩展（SimpleXML 及其他）、内存限制），该页面顶部会显示一个警告面板。该面板列出了每个未满足的要求以及相应的处理方法。

    如果面板中标记了任何内容，请首先进行修复。许多“WPML 损坏”的症状实际上是“服务器资源不足”。

  2. 更新所有内容

    过时的 WPML、WordPress、主题或其他插件版本是导致 WPML 问题的第二大常见原因。

    • WPML 及其附加组件。打开 WPML > 激活和更新，单击检查更新，然后安装所有可用的更新。请参阅更新 WPML。
    • WordPress 核心。通过仪表盘 > 更新进行更新。
    • 主题和其他插件。通过插件 > 已安装的插件和外观 > 主题进行更新。

    在每批更新后重新测试症状。

  3. 检查冲突

    如果症状是在安装新插件或切换主题后出现的，那么这便是首要怀疑对象。即使最近没有任何更改，插件或主题更新也可能是原因所在。

    • 一次（或分批）停用其他插件，在每步操作后重新测试。
    • 暂时切换到默认主题（例如 Twenty Twenty-Four）。如果症状消失，则说明原因是主题。

    当您找到触发原因时，这正是 WPML 支持团队需要的信息。

  4. 尝试相关的管理后台工具

    大多数症状在 WPML > 支持中都有专用的工具。使用该页面顶部的搜索框并输入症状：“stuck translation”（卡住的翻译）、“language data”（语言数据）、“cache”（缓存）、“duplicate”（重复）、“comments”（评论）。随后会出现合适的工具。

    正如标签所示，可安全自行运行层级是安全的。如果翻译看起来卡住了，请运行修复翻译；如果语言分配看起来有误，请运行修复语言数据。有关逐个工具的参考，请参阅WPML > 支持中的故障排除工具。

  5. 查看相关日志

    如果症状是间歇性的或难以重现，WPML > 支持上只读的日志层级通常会提供答案。通信日志显示您的网站与翻译服务之间的 API 流量；高级翻译编辑器错误日志显示服务器端错误；翻译管理作业日志显示特定翻译任务的发生情况。

    有关在何种情况下查看哪个日志，请参阅日志。

  6. 收集调试信息

    如果经过上述步骤后症状仍然存在，请立即收集调试信息。支持团队首先会要求提供该信息。

    1. 打开 WPML > 支持 > 系统检查。
    2. 将调试信息区块复制到剪贴板。
    3. 滚动到 WPML > 支持页面底部的已安装的插件部分，然后单击将列表复制到剪贴板。
    4. 将这两个区块粘贴到您的支持问题中。

    有关要包含的内容以及支持团队何时需要网站本身的副本，请参阅与支持团队共享调试信息。

  7. 提出您的问题

    如果上述清单未能解决问题，请在 WPML 支持中提出问题。在您的问题中：

    • 描述症状。您看到了什么、您期望什么以及何时开始出现。
    • 列出您已经尝试过的操作。上述步骤以及任何其他操作。
    • 粘贴调试信息和已安装的插件列表（您在第 6 步中收集的内容）。
    • 如果您希望支持团队直接从您的网站读取实时调试信息，请在 WPML > 支持页面上勾选与 WPML 支持团队共享诊断信息。该复选框需要选择加入；您可以随时将其关闭。

    附有此信息的问题，支持团队可以立即采取行动。