侧栏挂一串「最近访客」,把留了网址的评论者按时间倒序列出来,每个名字随机染一种颜色。这段流传挺广的写法是「PHP 查评论 + 六个彩色 class + jQuery 随机上色」,思路很轻巧,放到博客侧栏里也确实热闹。
但真粘进 WordPress 主题模板,踩的坑一个比一个硬:最要命的是那行 PHP 字符串里双引号没转义,解析阶段就会报错;随机色有整整四成落在「根本没定义样式」的档位上;还有 $ 在 WordPress 里默认不可用、!important 把六条 padding 全废掉、访客网址和昵称不转义直接拼进 HTML。下面先放原版(只删了两处署名注释,逻辑一字未改)和逐条实测,再给一份自包含的修复版。本站的 博客组件、侧栏挂件 和 网站美化 栏目里还有不少这类小工具,写法可以对照着看。
原版 · 实际效果
<!--
最近访客(彩色标签)· 原版
用法:放进主题模板文件(如 sidebar.php),PHP 部分不在小工具里执行
-->
<template>
<?php
function Autofirst($af){
global $wpdb;
$queryaf="select comment_author, comment_author_url, comment_date from $wpdb->comments where comment_ID in (select max(comment_ID) from $wpdb->comments where comment_approved='1' and comment_author_url !='' and user_id='0' GROUP BY comment_author_email) ORDER BY comment_date DESC LIMIT $af";
$wally = $wpdb->get_results($queryaf);
foreach ($wally as $commentaf){
$tmpy= "<a target="_blank" href="".$commentaf->comment_author_url.""><span>✪</span>".$commentaf->comment_author."<span>,</span></a>";
$outputy .= $tmpy;
}
$outputy = "".$outputy."";
echo $outputy ;
}
?>
</template>
<style>
.demo{margin:0 auto;}
.taglist{padding:10px;}
.taglist a{padding:0 3px 0 0 !important;font-size:15px; display:inline-block;white-space:nowrap;}
.taglist span {padding:3px;font-size:15px!important;color:#004687}
a.size1{padding:1px;font-size:15px;color:#ea4563;}
a.size1:hover{color:#E13728;}
a.size2{padding:1px;font-size:15px;color:#004687;}
a.size2:hover{color:#E13728;}
a.size3{padding:1px;font-size:15px;color:#9F35FF;}
a.size3:hover{color:#E13728;}
a.size4{padding:1px;font-size:15px;color:#f99f13;}
a.size5:hover{color:#B46A47;}
a.size5{padding:1px;font-size:15px;color:#d378ec;}
a.size5:hover{color:#E13728;}
a.size6{padding:1px;font-size:15px;color:#89b6fe;}
a.size6:hover{color:#E13728;}
</style>
<script type="text/javascript">
$(document).ready(function(){
/*随机颜色*/
var tags_a = $("#tags").find("a");
tags_a.each(function(){
var x = 9;
var y = 0;
var rand = parseInt(Math.random() * (x - y + 1) + y);
$(this).addClass("size"+rand);
});
});
</script>
<div class="demo">
<div class="taglist" id="tags">
<?php Autofirst(25);?>
</div>
</div>
<?php get_template_part( 'common/caise-fangke' ); ?>
<!-- ↓↓ 预览适配:预览窗口里没有 PHP,PHP 标签会被浏览器整段吞掉,
所以这里补一组示例访客。复制到自己站点时把这一小段整段删掉 ↓↓ -->
<script>
(function () {
var box = document.getElementById('tags');
if (!box || box.querySelector('a')) return; /* 真站上 PHP 已输出,就不动 */
var names = ['阿远','小满','林间','阿哲','青禾','老周','木子','南风','阿岚','小舟',
'北辰','阿柚','星野','晚晴','一只鹿','半山','知夏','云舟','阿栗',
'江南','临风','白露','子墨','拾光','归舟'];
var html = '';
for (var i = 0; i < names.length; i++) {
html += '<a target="_blank" href="https://wxzcw.com/"><span>✪</span>' + names[i] + '<span>,</span></a>';
}
box.innerHTML = html;
})();
</script>
<!-- ↑↑ 预览适配结束 ↑↑ -->原代码一字未改,只删掉了原来首尾两处别人的署名注释。六个 sizeN 配色、✪ 星号、逗号分隔、25 条上限、按邮箱去重,都是它本来的样子。
两点先说明。一是这段含 PHP,只能放进主题模板文件(比如 sidebar.php),「自定义 HTML」小工具不解析 PHP;二是块内末尾附了一段「预览适配」——预览新窗口里没有 PHP,浏览器会把 PHP 标签整段吞掉,不补一组示例访客就是一片空白。那段适配只在预览里起作用,复制到自己站点时整段删掉即可。函数定义外面那层 <template> 也是同一个目的:挡住预览里漏出来的源码碎片,PHP 是服务端先执行的,这层标签对真站逻辑没有任何影响,想删也能删。
改外观只用动那六个 a.sizeN 的颜色;想改人数就改 Autofirst(25) 里的数字。
原版实测出的问题
① 双引号没转义,PHP 解析阶段就报错,函数根本不会执行
输出链接那一行是这么写的:
$tmpy= "<a target="_blank" href="".$commentaf->comment_author_url."">…
按 PHP 的双引号字符串词法,"<a target=" 在第一处引号就已经闭合,中间的 _blank 变成裸标识符,后面还跟着两个相邻的字符串字面量——这在解析阶段就会报错,不是运行时的警告。原作者写的多半是 \",转发、复制、过一遍编辑器之后反斜杠被吞掉了,这是最典型的一种粘贴损耗。沙箱里没有 PHP 运行时,这一条是按 PHP 8 语义做的静态词法审查,结论明确:整个文件连函数都定义不了。修复版改用单引号包 HTML、属性里用双引号,从根上不需要任何转义。
② WordPress 的 $ 默认不可用,随机色整段不跑
WordPress 自带的 jQuery 跑在 noConflict 模式下,全局 $ 并不存在,得写成 jQuery(function($){…}) 才行。Chromium 实测直接抛 ReferenceError: $ is not defined,25 个链接的计算颜色全是浏览器默认蓝 rgb(0, 0, 238),六个彩色 class 一个都没加上。
| 检查项 | 实测 |
|---|---|
| 脚本报错 | $ is not defined |
| 链接颜色 | rgb(0, 0, 238)(默认蓝) |
带 sizeN 类的链接 |
0 / 25 |
所以你在预览窗口里看到一排蓝名字,不是插件坏了,正是这一条的现场。代码块插件若在预览页补了 jQuery,会看到一部分彩色、一部分默认蓝(见下一条),两种都是原版本来的样子。
③ 随机色摇 0~9,CSS 只定义了 1~6:四成访客没有样式
脚本里 x=9, y=0,parseInt(Math.random()*(x-y+1)+y) 摇出的是 0~9 共 10 档;而 CSS 里只有 size1 到 size6 六条。摇到 size0 / size7 / size8 / size9 时,class 加得上、样式查不到,链接就退回默认色。跑 10 万次统计:
| 视口 | 落在未定义档 | 占比 |
|---|---|---|
| 390 宽 | 40145 / 100000 | 40.1% |
| 1200 宽 | 39907 / 100000 | 39.9% |
修复版改成按索引 i % 6 + 1 循环,实测 25 个链接六种颜色全覆盖、重复可预期,也不会每次刷新都换一套配色。
④ 一个 !important,把六条 padding 全废了
.taglist a{padding:0 3px 0 0 !important} 的优先级压过后面所有 a.sizeN{padding:1px}。实测计算值恒为 0px 3px 0px 0px,6 条 padding 声明一条都没生效;样式表里带 !important 的规则共 1 条。这种「写了但永远不生效」的死声明最费排查时间。修复版一个 !important 都不留,间距交给 gap。
⑤ a.size5:hover 写了两遍
实测样式表里同选择器 2 条,前一条 #B46A47 被后一条 #E13728 覆盖,纯属复制粘贴残留。修复版把悬停统一成一条下划线。
⑥ 星号和逗号永远是蓝色,随机色只染了半个链接
.taglist span{color:#004687} 直接给 <span> 定了色,优先级高于父级 <a> 的继承。给链接加上 size1(红)之后实测:
| 部位 | 计算颜色 |
|---|---|
| 名字 | rgb(234, 69, 99) 红 |
✪ 星号 |
rgb(0, 70, 135) 蓝 |
| 逗号 | rgb(0, 70, 135) 蓝 |
而且每条末尾都带一个逗号,实测最后一个是「归舟,」。修复版把分隔符单独抽成 .wxz-fv-sep 灰字,用 implode() 拼接,天然没有尾逗号。
⑦ 25 个人挤成 5 行,行距和间距都不可控
390 宽下实测 5 行 / 115px,line-height 是 normal,行与行紧贴;横向靠 inline-block 自然折行,没有 gap。修复版用 flex-wrap:wrap + gap:4px 8px,行数由容器宽度自己决定。
这里顺带更正一个容易想当然的判断:white-space:nowrap 看着像会把页面撑宽,实测 390 / 1200 两档 scrollWidth 都等于视口宽——因为 25 个 <a> 是 inline-block,会自然折行,并不会把页面顶出去。这条不算 bug,之前有几篇代码确实会撑宽页面,别混为一谈。
⑧ 安全三处:SQL 拼接、输出不转义、target="_blank" 缺 rel
这一组是静态审查(沙箱无 PHP 运行时):
$af直接拼进LIMIT $af,没强转也没$wpdb->prepare()。调用处虽然写死 25,但只要有人把这个函数接到请求参数上就是注入口子。comment_author和comment_author_url裸拼进 HTML,没有esc_html()/esc_url()。网址里塞javascript:或者昵称里塞引号,就是存储型 XSS。- 25 个链接全部缺
rel(实测 25/25),target="_blank"不带noopener noreferrer会留下window.opener。 $outputy没初始化就.=,开着错误显示时会冒Undefined variable。
修复版:(int) 强转 + prepare('%d')、esc_url() 过协议白名单、esc_html() 转昵称、implode() 替掉累加、rel="noopener noreferrer" 补齐。
⑨ 预览空白、一页两份串台、别人主题残留
实测把原版直接塞进预览文档,<?php … ?> 被浏览器当成 bogus comment 整段吞掉,body.innerText 是空字符串——块1 必然一片白。这不是插件问题,是 PHP 片段在纯 HTML 预览里的固有表现,所以这篇在两个块内都附了预览适配,没有动插件。
另外 id="tags" 是硬编码的,一页放两份实测 #tags 出现 2 个,getElementById 仍然只指向第一份,随机色只会加到第一份上。末尾那行 get_template_part( 'common/caise-fangke' ) 是别人主题里的模板文件,JustNews 里并不存在,get_template_part() 找不到会静默失败——修复版直接删掉了。
说句公道话:按邮箱取每人最新一条评论、六个配色轮换、25 条上限,这几个思路都挺利落,修复版只是把引号、作用域和输出安全理顺,外观骨架沿用原版。
修复版 · 自包含 + 零外部依赖
<!--
维形筑网 www.wxzcw.com · 最近访客彩色标签(自包含修复版)
更多 WordPress 小工具:https://wxzcw.com/
用法:整段放进子主题模板(sidebar.php / footer.php);含 PHP,不能放「自定义 HTML」小工具
想放小工具就把下面那行 PHP 调用换成手写的 <a> 列表
改动要点:SQL 参数化 + 输出转义 / 零依赖原生 JS / 六色全覆盖 / 全 wxz-fv- 前缀
/ 零 id 一页可放多份 / 无 !important / 带上色的预览适配
-->
<template>
<?php
/* 维形筑网 www.wxzcw.com · 最近访客:按邮箱取每人最新一条已通过评论 */
function wxz_fv_recent($af) {
global $wpdb;
$af = max(1, min(100, (int) $af)); /* 强转,挡住拼进 LIMIT 的注入 */
$sql = "SELECT comment_author, comment_author_url, comment_date
FROM $wpdb->comments
WHERE comment_ID IN (
SELECT MAX(comment_ID) FROM $wpdb->comments
WHERE comment_approved = '1'
AND comment_author_url <> ''
AND comment_author_url IS NOT NULL
AND user_id = '0'
GROUP BY comment_author_email
)
ORDER BY comment_date DESC
LIMIT %d";
$rows = $wpdb->get_results($wpdb->prepare($sql, $af));
$out = array();
foreach ($rows as $r) {
/* esc_url 只放行 http/https 等安全协议,javascript: 会被丢掉 */
$url = esc_url($r->comment_author_url);
if (!$url) continue;
$name = esc_html($r->comment_author);
/* esc_html 在属性里也可用;名字里带引号不会撑破标签 */
$out[] = '<a target="_blank" rel="noopener noreferrer" href="' . $url . '">' . $name . '</a>';
}
/* implode 天然没有尾逗号,$out 也不用先声明再 .= */
echo implode('<span class="wxz-fv-sep">,</span>', $out);
}
?>
</template>
<style>
.wxz-fv-demo{max-width:100%;margin:0 auto}
.wxz-fv-list{display:flex;flex-wrap:wrap;align-items:center;gap:4px 8px;
padding:10px;margin:0;list-style:none;overflow-wrap:anywhere}
.wxz-fv-list a{display:inline-block;font-size:15px;color:#004687;
text-decoration:none;white-space:nowrap}
.wxz-fv-list a:hover{text-decoration:underline}
.wxz-fv-list a.wxz-fv-c1{color:#ea4563}
.wxz-fv-list a.wxz-fv-c2{color:#004687}
.wxz-fv-list a.wxz-fv-c3{color:#9f35ff}
.wxz-fv-list a.wxz-fv-c4{color:#d98310}
.wxz-fv-list a.wxz-fv-c5{color:#d378ec}
.wxz-fv-list a.wxz-fv-c6{color:#3a7bd5}
.wxz-fv-list .wxz-fv-sep{color:#9aa5b5;font-size:13px}
@media (max-width:480px){
.wxz-fv-list{gap:4px 6px;padding:8px}
.wxz-fv-list a{font-size:14px}
}
</style>
<div class="wxz-fv-demo">
<div class="wxz-fv-list" data-wxz-fv><?php wxz_fv_recent(25); ?></div>
</div>
<!-- ↓↓ 预览适配:预览窗口不执行 PHP,补一组示例访客;复制到自己站点时删掉 ↓↓ -->
<script>
(function () {
var box = document.querySelector('[data-wxz-fv]');
if (!box || box.querySelector('a')) return; /* 真站上 PHP 已输出,就不动 */
var names = ['阿远','小满','林间','阿哲','青禾','老周','木子','南风','阿岚','小舟',
'北辰','阿柚','星野','晚晴','一只鹿','半山','知夏','云舟','阿栗',
'江南','临风','白露','子墨','拾光','归舟'];
var html = '';
for (var i = 0; i < names.length; i++) {
if (i) html += '<span class="wxz-fv-sep">,</span>';
html += '<a target="_blank" rel="noopener noreferrer" href="https://wxzcw.com/">' + names[i] + '</a>';
}
box.innerHTML = html;
})();
</script>
<!-- ↑↑ 预览适配结束 ↑↑ -->
<script>
(function () {
function boot() {
if (window.__wxzFvBooted) return; /* 脚本被合并输出两次也只跑一遍 */
window.__wxzFvBooted = true;
var boxes = document.querySelectorAll('[data-wxz-fv]');
Array.prototype.forEach.call(boxes, function (box) {
var links = box.querySelectorAll('a');
Array.prototype.forEach.call(links, function (a, i) {
a.classList.add('wxz-fv-c' + (i % 6 + 1)); /* 1..6,六种颜色都定义过 */
});
});
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', boot);
} else {
boot();
}
})();
</script>修复版把 PHP、CSS、JS 收在一段里:wxz_fv_recent() 负责查库和转义输出,六色按索引循环,容器靠 data-wxz-fv 找,零 id、零 !important、零 jQuery。注释里写的是本站地址 https://wxzcw.com/,整段不加载任何外部文件、不请求第三方接口。
修复版逐项实测:
| 检查项 | 原版 → 修复版 |
|---|---|
| 预览 390 宽 | 空白 → 25 个访客可见 |
| 上色 | 默认蓝 / 四成无色 → 六色齐全(6/6) |
| JS 报错 | $ is not defined → 0 |
!important / 重复规则 |
1 处 / 2 条 → 0 / 0 |
硬编码 id / 缺 rel |
1 个 / 25 个 → 0 / 0 |
| 尾逗号 | 有 → 无 |
| 390 / 1200 横向溢出 | 0 → 0 |
预览舞台框里单独复测过:两个块各 25 个链接,框内 scrollWidth 与 clientWidth 同为 348px、页面 390px,没有 fixed 层,顶条底部 50px 没被压住,修复版 JS 报错 0。
怎么调
- 改人数:把
wxz_fv_recent(25)里的 25 换掉,函数里已经把范围夹在 1~100。 - 改配色:注入样式里
.wxz-fv-c1到.wxz-fv-c6六行,改完 JS 的i % 6 + 1不用动。 - 改间距:
.wxz-fv-list的gap:4px 8px(行距 / 列距),padding:10px是外留白。 - 改分隔符:
implode('<span class="wxz-fv-sep">,</span>', …)里的逗号换成·之类,颜色在.wxz-fv-sep里改。 - 换去重口径:现在按
comment_author_email分组,同一人换邮箱算两位、不留邮箱的会并成一组;想按昵称分组就把GROUP BY那行改成comment_author。 - 窄屏字号:
@media (max-width:480px)里那两条,默认 14px。
为什么类名带 wxz-fv- 前缀
CSS 是全局生效的。只要 <style> 进了页面,里面的规则就作用于整个站点,而不只是你粘的那一块。原版用的 .demo、.taglist、a.size1 都是极常见的短名,JustNews 里有 .card、.hd、.bd 这类,WPCOM Member 的登录弹窗、WPOPT 的优化样式也都在同一张样式表里;撞上之后站上别处跟着变样,还不报错,最难查。#tags 这种 id 选择器特异性更高,主题想覆盖得写更狠的选择器,「标签云」插件也爱用这个名字。
所以修复版做了三件事:
- 类名、CSS 变量、data 属性全部带
wxz-fv-前缀,照抄时别图省事改回短名。 - 样式里 0 个
html/body/*选择器,也没有position:fixed和document.body.appendChild——预览新窗口的返回条和舞台框都不受影响。 - DOM 里一个 id 都不用,容器靠
data-wxz-fv找,同一页放几份各自独立上色。
装 vs 不装的逐项对比也跑了:模拟 JustNews 骨架(fixed 顶栏 + sticky 侧栏 + 导航 + 小工具内 code),390 宽下顶栏 z-index:100 / 高 50、侧栏 top:80px、.card 背景、小工具里 code 颜色、html / body 的 overflow-x、导航点击数 1 且未被 preventDefault、页面 scrollWidth 390、JS 报错 0——逐项全部一致。
改的时候注意这几点
- 这段代码含 PHP,「自定义 HTML」小工具里不解析。放小工具就只留 HTML + CSS + JS,把
<?php wxz_fv_recent(25); ?>换成手写的一组<a>,PHP 函数那段删掉。 - 两段「预览适配」复制到自己站点时删掉:它们只在预览窗口没有 PHP 时补示例访客,真站上 PHP 已经输出过链接,脚本会自己跳过。
<template>那层可留可删:PHP 在服务端先执行,不影响函数定义;删掉只是预览里可能漏出源码文字。- 引号别被弯引号化:经典编辑器会过
wptexturize。本页代码块里的引号已转成实体并标了escaped="on",点「复制全文」粘就没问题;别手动框选页面上的代码。 - 预览里原版全蓝是正常的:见问题②,不是代码块插件坏了,也不用升级插件。
- 和代码块插件的复制版权不叠加:这段不监听
copy事件,各管各的。 - 改完清一次缓存:WPOPT 开了页面缓存或 JS / CSS 合并时,保存后顺手清一下。
怎么用
整段(PHP + CSS + HTML + JS)粘在一起,不依赖 jQuery、不加载任何外部文件、不请求第三方接口。
- 子主题模板(推荐):放进
sidebar.php或footer.php想显示的位置,PHP 直接执行。 - 代码片段插件:用 WPCode 之类新建一个 PHP 片段,把
wxz_fv_recent()注册成一个短代码,再插到侧栏;别用「仅 HTML」类型的片段。 - 只想要前端版:删掉 PHP 函数定义与调用,把示例访客换成自己的
<a>列表,就能放进「自定义 HTML」小工具。 - 一页多份:复制两段整段代码即可,脚本有单例锁,两份都会各自上色。
两个小提醒:样式只留一份,手动拆到「额外 CSS」的话就别再留 <style> 那段;和代码块预览不冲突,这段不往 body 追加节点、不加 fixed 层,预览新窗口的返回条和舞台框都不受影响。
兼容性
PHP 7.4+ / WordPress 5.0+ 即可:esc_url()、esc_html()、$wpdb->prepare() 都是 WordPress 自带函数,不用装扩展。前端只用了 querySelectorAll、classList、Array.prototype.forEach.call、flex-wrap,IE11 以上都支持;DOMContentLoaded 加 readyState 判断,脚本被优化插件提到 <head> 也能初始化。
没有容器查询、没有动画、没有 position:fixed,所以不涉及 prefers-reduced-motion;overflow-wrap:anywhere 在老浏览器里退化成默认换行,只是很长的昵称可能顶宽,本站访客昵称一般不会那么长。
代码仅供学习交流,禁止商用。更多 网站美化 代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com