从系统检查中复制调试信息区块
打开WPML支持系统检查。该页面会显示一个调试信息区块:包含 PHP 版本、WordPress 版本、每个 WPML 插件及其版本、服务器环境、语言配置以及 WPML 从 wp-config.php 读取的配置值。单击区块顶部的将系统信息复制到剪贴板,然后将其粘贴到您的支持问题中。
该区块可让支持团队了解您正在运行的各项内容的版本,以及站点当前的配置情况。这是进行任何深入调查前的基准信息。
复制已安装的插件列表
滚动到WPML支持的底部。已安装的插件部分列出了站点上的每个插件、其版本以及它是处于激活还是非激活状态。单击将列表复制到剪贴板并将其粘贴到您的支持问题中。
插件冲突是导致 WPML 出现问题的最常见原因之一。支持团队会使用此列表来发现已知的兼容性问题,并提出相关的后续问题。
复制相关日志
对于涉及专业翻译服务商的问题,WPML支持通信日志会捕获您的站点与翻译后端之间的 API 流量。如果翻译以不明显的方式失败,将最近的日志条目复制到支持问题中,可以为支持团队提供准确的服务器端响应。
对于高级翻译编辑器内部的问题,高级翻译编辑器错误日志会捕获 ATE 遇到的服务器端错误。
对于翻译任务出现的问题(任务未开始、任务未完成、任务消失),翻译管理作业日志会显示每个任务的生命周期。
有关在何种情况下应查看哪个日志,请参阅日志。
与支持团队共享实时诊断访问权限(可选)
WPML支持页面的顶部有一个与 WPML 支持团队共享诊断信息复选框。勾选该复选框,即可让 WPML 支持团队直接读取您站点的调试信息。不会共享任何密码或个人数据,仅共享调试信息区块。
这比将区块粘贴到问题中更快捷,因为支持团队可以在对话过程中重新读取最新数据。您可以随时通过同一个复选框将其关闭。
当支持团队要求提供调试日志时
对于更深层次的问题(ATE 行为异常、竞争条件、间歇性故障),支持团队有时会要求提供完整的 WPML 调试日志,该日志比调试信息区块更详细。
要启用调试日志记录:
- 将
define( 'WP_DEBUG', true );和define( 'WP_DEBUG_LOG', true );添加到wp-config.php中 “That’s all, stop editing!” 这一行的上方。WordPress 将开始把 PHP 错误和警告写入wp-content/debug.log。 - 在站点上重现该症状。
- 打开或下载
wp-content/debug.log并复制相关部分(根据症状发生前后的时间戳进行筛选)。 - 将其粘贴到您的支持问题中,或作为文件附加。
- 之后请将
WP_DEBUG重新关闭。在生产环境中保持开启状态会带来安全风险,因为错误中包含路径信息。
有关包括筛选 WPML 特定条目在内的完整步骤,请参阅调试 WPML 参考。
当支持团队要求提供站点副本时
对于支持团队无法仅通过日志重现的问题,他们可能会要求提供站点副本以进行调查。标准做法是使用备份或暂存工具打包整个站点,并通过 WPML 的安全上传表单进行共享(支持团队在提出要求时会向您提供链接)。
打包步骤的推荐工具:
- Duplicator。将数据库和文件打包成一个压缩包,外加一个安装脚本。
- All-in-One WP Migration。类似的打包方式,格式略有不同。
- 您的托管服务提供商内置的暂存/克隆工具(如果它能生成可移植的压缩包)。
在共享副本之前:
- 确保您共享的是站点的副本,而不是实时站点本身的访问权限。
- 如果您的站点包含客户数据,请从数据库中清除个人数据(Duplicator 和 AIOWP 为此提供了导出选项)。
- 在根据支持团队在副本上的发现进行更改之前,请确认您已拥有生产站点的有效备份。
WPML 会自动处理站点在服务器之间移动的情况;而向支持团队发送副本的情况则是指您将站点打包,以便托管环境之外的人员在本地启动。
查找您的 WPML 帐户凭据
如果支持团队询问此站点是在哪个 WPML 帐户下注册的,而您不记得了:
- WPML激活与更新上经过掩码处理的站点密钥可以标识站点使用的是哪个密钥(例如
******abcd)。将其与您的 WPML 帐户中列出的站点进行匹配。 - 如果您无法访问该帐户电子邮件,请在收件箱中搜索来自
accounts@wpml.org的邮件。最初的帐户创建电子邮件中包含凭据。