继上一篇《前台编辑框空白》之后,又发现一个后台的小问题,同样记录一下。这次的问题不复杂,但现象挺迷惑人的。
一、问题现象
进入 WP 后台,左侧菜单栏里「zibll主题设置」下的「商城&商品」这一项,名字后面跟着一串奇怪的英文代码(-badge style="background...">v8.2 之类的乱码文字),看着像是报错。但点进主题设置页面里面,同样的「商城&商品」栏目却是正常的,还带着一个漂亮的 V8.2 小徽章。
修复前(菜单栏显示乱码文字):

这就是主题自带的「V8.2 新功能」角标,在侧边栏没有正常渲染,HTML 代码原样显示出来了。
二、排查过程
1. 先确认不是浏览器问题:换浏览器、清缓存,乱码依旧;
2. 对比发现只有侧边栏乱,主题设置页内部正常,说明「同一段内容、两个地方渲染方式不一样」;
3. 上服务器查主题代码,找到了生成这个角标的位置,再查它把菜单注册到侧边栏的过程,发现了问题。
三、真正原因
这个 V8.2 角标本体是一小段 HTML 代码。主题的选项框架把它写进菜单标题时,对侧边栏菜单多做了一步「转义」处理——本意是安全,结果把 HTML 代码变成了纯文字,浏览器就把代码原样显示出来了。
而主题设置页内部渲染这段标题时没有做转义,所以显示正常。一句话总结:同一段带角标的标题,侧边栏被过度转义、设置页正常渲染,表现就不一样了。
四、修复方法
在服务器上加了一个几行代码的小兼容插件,作用是在后台菜单加载完成后,把被误转义的菜单标题还原回来,让角标正常显示。已验证修复效果:
修复后(V8.2 徽章正常显示):

这个修复不改主题文件,主题以后升级也不会丢,只影响后台菜单的显示,不碰任何功能。
五、小结
① 这类「HTML 变成文字」的乱码,多半是转义问题(代码被当成文本显示了),不是数据损坏,看到不用慌;
② 判断方法很简单:同一个东西在一个地方正常、另一个地方乱码,基本都是两个地方的处理方式不一致导致的;
③ 之前那篇《前台编辑文章编辑框空白》的问题已经修复,这两个问题相互独立、都已解决,有问题欢迎在本板块反馈。





没有回复内容