在向 WPML 请求支持之前 – 故障排除清单
大多数 WPML 问题都可以自行解决。在请求支持之前浏览此清单可以节省双方的时间,并且在许多情况下能直接解决问题。如果此清单未能解决问题,您也可以提前准备好支持团队首先会询问的信息,并将其包含在您的支持问题中。
-
确保系统满足 WPML 的最低要求
打开 WPML支持。如果您的站点未达到 WPML 的最低要求(PHP 版本、所需的 PHP 扩展(
SimpleXML等)或内存限制),该页面顶部会显示一个警告面板。该面板会列出每个未满足的要求以及相应的处理方法。如果面板中标记了任何内容,请先予以修复。许多“WPML 出现故障”的症状实际上是“服务器资源不足”造成的。
-
更新所有内容
WPML、WordPress、主题或其他插件的版本过旧是导致 WPML 问题的第二大常见原因。
- WPML 及其附加组件。打开 WPML激活与更新,单击检查更新,然后安装所有可用的更新。
- WordPress 核心。通过 仪表盘更新进行更新。
- 主题和其他插件。通过 插件已安装的插件和 外观主题进行更新。
在每批更新后重新测试症状。
请参阅更新 WPML。
-
检查是否存在冲突
如果症状是在安装新插件或切换主题后出现的,那么这便是首要怀疑对象。即使最近没有任何更改,插件或主题更新也可能是原因所在。
- 逐个(或分半)停用其他插件,并在每个步骤后重新测试。
- 暂时切换到默认主题(例如 Twenty Twenty-Four)。如果症状消失,则说明主题是原因所在。
当您找到触发原因时,这正是 WPML 支持团队所需的信息。
-
尝试使用相关的管理后台工具
大多数症状在 WPML支持中都有专门的工具。从 WPML 5.0 开始,修复工具随 WPML Troubleshooting 插件(WPML激活与更新)一起提供;只读工具和清除缓存功能则位于 WPML 本身中。使用该页面顶部的搜索框并输入症状:“卡住的翻译”、“语言数据”、“缓存”、“复制”、“评论”。合适的工具就会出现。
正如标签所示,可安全自行运行层级是安全的。如果翻译看起来卡住,请运行修复翻译;如果语言分配看起来有误,请运行修复语言数据。
有关每个工具的参考信息,请参阅WPML支持中的故障排除工具。
-
查看相关日志
如果症状是间歇性的或难以重现,WPML支持上的只读日志层级通常能提供答案。通信日志显示您的站点与专业翻译服务商之间的 API 流量;高级翻译编辑器错误日志显示服务器端错误;翻译管理作业日志显示特定翻译作业的情况。
有关在何种情况下应查看哪个日志的信息,请参阅日志。
-
收集调试信息
如果在执行上述步骤后症状仍然存在,请立即收集调试信息。支持团队首先会要求提供此信息。
- 打开 WPML支持系统检查。
- 将调试信息区块复制到剪贴板。
- 滚动到 WPML支持页面底部的已安装的插件部分,然后单击将列表复制到剪贴板。
- 将这两个区块粘贴到您的支持问题中。
有关应包含哪些内容以及支持团队何时需要站点副本的详细信息,请参阅与支持团队共享调试信息。
-
提出您的问题
如果上述清单未能解决问题,请在 WPML 支持中提出问题。在您的问题中:
- 描述症状。您看到了什么、您期望的结果是什么,以及症状是何时开始的。
- 列出您已经尝试过的操作。上述步骤以及其他任何操作。
- 粘贴您在第 6 步中收集的调试信息和已安装的插件列表。
- 如果您希望支持团队直接从您的站点读取实时调试信息,请在 WPML支持页面上勾选与 WPML 支持团队共享诊断信息。该复选框是可选的;您可以随时将其关闭。
附带这些信息的问题能让支持团队立即采取行动。