暂无菜单项

配置自定义界面和错误语言文案

发布于 更新于
3

01 入门与基础 / 01.02 语言与货币

一、这个功能能做什么

「自定义 JSON 语言包」用于界面文字,「服务端错误 JSON」用于 Node 返回的已接入业务错误。两者在语言设置中分别上传,不能互换。

作用范围

Node 服务端按请求语言处理错误,浏览器只显示结果。但不能承诺全部旧接口或嵌套结果已接入:当前下载领取的嵌套错误链路仍有覆盖差异;WP 后台翻译按钮直接返回的错误也不能一概用 Node 字典解释。

某句没有变时,先确认发生在 WP 后台还是前台、具体错误码是否接入、目标语言与配置是否正确,再检查文件格式。界面切换语言不会自动翻译后台所有报错。

先认识这几个词

  • JSON:一种保存结构化文字数据的文件格式;修改时需要保持正确格式。
  • 占位符:发送或显示时自动替换的标记,例如用站点名称或当前订单号替换。
  • 前端:访客实际打开和使用的网站;同一后台可以对应多个前端网址。

逐项设置与效果

设置 功能与效果
界面语言包 使用自定义 JSON 文件覆盖适用界面文字
服务端错误语言包 配置对应语言的错误文案文件,按当前页面语言显示适用错误

二、设置后会有什么效果

你可以把界面中的默认文字改成更适合自己网站的说法,也可以调整已支持错误码的提示。界面文字与文章译文分别管理,修改按钮文案不会翻译文章正文。

三、怎么使用

界面文案

从对应语言标准文件制作副本,只修改译文,保留键名、结构和占位符。上传到该语言的「自定义 JSON 语言包」,保存配置后检查目标前端。留空使用 Node 项目自带语言包。

服务端错误文案

  1. 从后台提供的错误模板开始编辑。
  2. 按错误码修改允许公开的文字,保留 {limit} 等占位符。
  3. 文件不超过 256KB,上传到对应语言「服务端错误 JSON」。
  4. 保存配置;即使只替换了同地址文件,也需要再次保存。
  5. 在对应语言下触发已知错误,核对显示结果。

删除条目、空文字或移除自定义文件时,对已接入的错误恢复默认文案。不要将内部堆栈、密钥或上游原始响应写成客户提示。

完成配置并检查结果

在对应语言项分别配置界面 JSON 和错误文案文件,确认文件可读取且格式正确。保存语言配置后检查目标前端的页面文字和一个可重复的业务错误。替换同地址文件后仍要重新保存配置,触发前端更新。

四、常见问题

换了语言文件内容,页面为什么还是旧文字?

替换同地址文件后还需要重新保存对应配置,触发更新。先分清你改的是界面语言包还是服务端错误文件,再检查目标前端和语言。

更多使用问题

改了界面语言包,为什么错误提示没有改变?

界面文字和服务端错误使用不同配置。检查是否更新了正确的错误文案文件,以及该错误是否已接入对应翻译流程。

0 / 600
0 讨论
热门最新
总结
暂无总结
嗨,下午好!
所有的成功,都源自一个勇敢的开始