与支持团队共享 WPML 调试信息
对于大多数支持问题,WPML 的支持团队通常会要求提供以下几项内容: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 调试日志,该日志比调试信息区块更为详细。
要启用调试日志记录:
- 在
wp-config.php中的 “That’s all, stop editing!” 行之前添加define( 'WP_DEBUG', true );和define( 'WP_DEBUG_LOG', true );。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 > Activate & Update 上经过掩码处理的站点密钥标识了网站使用的密钥(例如
******abcd)。将其与您的 WPML 帐户中列出的站点进行匹配。 - 如果您无法访问该帐户的电子邮件,请在收件箱中搜索来自
accounts@wpml.org的邮件。最初的帐户创建电子邮件中包含这些凭据。