【已解决】后台菜单栏“商城&商品”显示乱码代码的原因与修复(带图解)

继上一篇《前台编辑框空白》之后,又发现一个后台的小问题,同样记录一下。这次的问题不复杂,但现象挺迷惑人的。

一、问题现象

进入 WP 后台,左侧菜单栏里「zibll主题设置」下的「商城&商品」这一项,名字后面跟着一串奇怪的英文代码(-badge style="background...">v8.2 之类的乱码文字),看着像是报错。但点进主题设置页面里面,同样的「商城&商品」栏目却是正常的,还带着一个漂亮的 V8.2 小徽章。

修复前(菜单栏显示乱码文字):

修复前:菜单栏显示乱码文字

这就是主题自带的「V8.2 新功能」角标,在侧边栏没有正常渲染,HTML 代码原样显示出来了。

二、排查过程

1. 先确认不是浏览器问题:换浏览器、清缓存,乱码依旧;

2. 对比发现只有侧边栏乱,主题设置页内部正常,说明「同一段内容、两个地方渲染方式不一样」;

3. 上服务器查主题代码,找到了生成这个角标的位置,再查它把菜单注册到侧边栏的过程,发现了问题。

三、真正原因

这个 V8.2 角标本体是一小段 HTML 代码。主题的选项框架把它写进菜单标题时,对侧边栏菜单多做了一步「转义」处理——本意是安全,结果把 HTML 代码变成了纯文字,浏览器就把代码原样显示出来了。

而主题设置页内部渲染这段标题时没有做转义,所以显示正常。一句话总结:同一段带角标的标题,侧边栏被过度转义、设置页正常渲染,表现就不一样了。

四、修复方法

在服务器上加了一个几行代码的小兼容插件,作用是在后台菜单加载完成后,把被误转义的菜单标题还原回来,让角标正常显示。已验证修复效果:

修复后(V8.2 徽章正常显示):

修复后:V8.2徽章正常显示

这个修复不改主题文件,主题以后升级也不会丢,只影响后台菜单的显示,不碰任何功能。

五、小结

① 这类「HTML 变成文字」的乱码,多半是转义问题(代码被当成文本显示了),不是数据损坏,看到不用慌;

② 判断方法很简单:同一个东西在一个地方正常、另一个地方乱码,基本都是两个地方的处理方式不一致导致的;

③ 之前那篇《前台编辑文章编辑框空白》的问题已经修复,这两个问题相互独立、都已解决,有问题欢迎在本板块反馈。

请登录后发表评论

    没有回复内容

随便看看