WPML

复制系统检查中的调试信息区块

打开 WPML > 支持 > 系统检查。该页面会显示一个调试信息区块:PHP 版本、WordPress 版本、每个 WPML 插件及其版本、服务器环境、语言配置,以及 WPML 从 wp-config.php 中读取的配置值。单击该区块顶部的 Copy system info to clipboard,然后将其粘贴到您的支持问题中。

此区块可告知支持团队您运行的各项组件版本以及网站当前的配置情况。这是进行任何深入调查之前的基准信息。

复制已安装的插件列表

滚动到 WPML > 支持的底部。已安装的插件部分列出了网站上的每个插件、其版本以及激活或未激活状态。单击 Copy list to clipboard 并将其粘贴到您的支持问题中。

插件冲突是导致 WPML 出现问题的最常见原因之一。支持团队使用此列表来发现已知的兼容性问题,并提出相关的后续问题。

复制相关日志

对于涉及翻译服务的问题,WPML > 支持 > 通信日志会捕获您的网站与翻译后端之间的 API 流量。如果翻译以不明显的方式失败,将最近的日志条目复制到支持问题中,可为支持团队提供准确的服务器端响应。

对于高级翻译编辑器内部的问题,高级翻译编辑器错误日志会捕获 ATE 遇到的服务器端错误。

对于翻译作业的问题(作业未开始、作业未完成、作业消失),翻译管理作业日志会显示每个作业的生命周期。

有关在不同情况下应查看哪种日志的说明,请参阅日志

与支持团队共享实时诊断访问权限(可选)

WPML > 支持页面顶部有一个 Share diagnostic information with WPML Support 复选框。勾选该复选框,即可让 WPML 的支持团队直接读取您网站的调试信息。此操作不会共享任何密码或个人数据,仅共享调试信息区块。

这比将区块粘贴到问题中更快捷,因为支持团队可以在交流过程中重新读取最新数据。您可以随时通过同一个复选框将其关闭。

当支持团队要求提供调试日志时

对于更深层次的问题(如 ATE 行为异常、竞态条件、间歇性故障),支持团队有时会要求提供完整的 WPML 调试日志,该日志比调试信息区块更为详细。

要启用调试日志记录:

  1. wp-config.php 中的 “That’s all, stop editing!” 行之前添加 define( 'WP_DEBUG', true );define( 'WP_DEBUG_LOG', true );。WordPress 将开始把 PHP 错误和警告写入 wp-content/debug.log
  2. 在网站上重现该问题。
  3. 打开或下载 wp-content/debug.log 并复制相关部分(根据问题发生时的时间戳进行筛选)。
  4. 将其粘贴到您的支持问题中或作为文件附加。
  5. 之后请将 WP_DEBUG 重新关闭。在生产环境中保持开启状态会带来安全风险,因为错误中包含路径信息。

有关包括筛选 WPML 特定条目在内的完整过程,请参阅调试 WPML 参考

当支持团队要求提供网站副本时

对于仅通过日志无法重现的问题,支持团队可能会要求提供网站副本以进行调查。标准方法是使用备份或暂存工具将整个网站打包,并通过 WPML 的安全上传表单进行共享(支持团队在提出要求时会向您提供链接)。

打包步骤的推荐工具:

  • Duplicator. 将数据库和文件打包为一个压缩包,并附带安装程序脚本。
  • All-in-One WP Migration. 类似的打包方式,格式略有不同。
  • 您的托管服务提供商内置的暂存/克隆工具(如果它能生成可移植的压缩包)。

在共享副本之前:

  • 请确保您共享的是网站的副本,而不是实时网站本身的访问权限。
  • 如果您的网站包含客户数据,请从数据库中剥离个人数据(Duplicator 和 AIOWP 提供了相应的导出选项)。
  • 在根据支持团队在副本上发现的问题进行更改之前,请确认您已有生产环境的有效备份。

WPML 会自动处理网站在服务器之间移动的情况;而在向支持团队发送副本的情况下,您需要将网站打包,以便托管环境之外的人员在本地启动它。

查找您的 WPML 帐户凭据

如果支持团队询问此网站是在哪个 WPML 帐户下注册的,而您不记得了:

  • WPML > Activate & Update 上经过掩码处理的站点密钥标识了网站使用的密钥(例如 ******abcd)。将其与您的 WPML 帐户中列出的站点进行匹配。
  • 如果您无法访问该帐户的电子邮件,请在收件箱中搜索来自 accounts@wpml.org 的邮件。最初的帐户创建电子邮件中包含这些凭据。