最近访客彩色标签:25 位评论访客排成彩色名单,SQL 和输出都得先收拾干净

侧栏挂一串「最近访客」,把留了网址的评论者按时间倒序列出来,每个名字随机染一种颜色。这段流传挺广的写法是「PHP 查评论 + 六个彩色 class + jQuery 随机上色」,思路很轻巧,放到博客侧栏里也确实热闹。

但真粘进 WordPress 主题模板,踩的坑一个比一个硬:最要命的是那行 PHP 字符串里双引号没转义,解析阶段就会报错;随机色有整整四成落在「根本没定义样式」的档位上;还有 $ 在 WordPress 里默认不可用、!important 把六条 padding 全废掉、访客网址和昵称不转义直接拼进 HTML。下面先放原版(只删了两处署名注释,逻辑一字未改)和逐条实测,再给一份自包含的修复版。本站的 博客组件、侧栏挂件 和 网站美化 栏目里还有不少这类小工具,写法可以对照着看。

原版 · 实际效果

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 条上限,这几个思路都挺利落,修复版只是把引号、作用域和输出安全理顺,外观骨架沿用原版。

修复版 · 自包含 + 零外部依赖

HTML最近访客彩色标签 · 自包含修复版
<!--
  维形筑网 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

赞 (0)
大眼睛时钟挂件:瞳孔跟着鼠标转,窄栏日期自动变短
上一篇 2026年11月3日 上午7:52
左上角 Logo 秋千摇摆:免查 class 的写法,和预览、冲突那点事
下一篇 2026年11月3日 下午4:02

相关推荐

维 形 筑 网