laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

3.2.49: 修「文章聚合→热点」只显示一条（换全站累计热度算法） #19

Browse Source 
根因不是排序，是候选池：旧 SQL 先圈「最近 30 天发布」再按评论排序取 6。
本站实测 30 天只有 1 篇 post（7 天 0 / 90 天 1 / 180 天 6 / 365 天 15 / 全站 967），
候选池只有 1 条，LIMIT 6 也只能返回 1 条。

改成全站累计热度，三项取对数加权：
  3*log10(views+1) + 5*log10(love+1) + 4*log10(comments+1)
· 取 log10：views 中位 4981/最大 56075，而 love 最大 40、评论最大 93，
  不压缩则 views 一项吃掉全部权重。
· 权重 3/5/4（不是通用 1/3/5）：用通用值实测前 8 名 6 篇是 2009 年老随笔
  —— 评论 1.97*5=9.86 > views 4.75*1=4.75，退化成「评论数排行榜」。
· 有意不加时间衰减：HN/Reddit 那套是「新内容榜」，会把老文压到看不见，
  正好回到原问题。要时效榜是另一个功能。
· 仍限定 post_type='post'（用户要求只看文章，不看 page；
  ID 217「留言本」/522「博客时间」核查过都是 page，天然被挡掉）。

顺手修掉三处旧问题：
· 删 date_default_timezone_set("PRC") —— 它会改掉整个 PHP 请求的全局时区
· 标题进属性改 esc_attr()（旧代码裸拼，含双引号会截断 title 属性）
· get_posts 参数从 'numberposts=6 & offset=0' 字符串改成数组
  （字符串里那个空格让参数名变成 ' offset'，offset=0 实际从未生效）

后台：「统计天数」输入框下线（它控制的就是那个缩死候选池的时间窗），
update() 不再保存 days，老实例残留值下次保存时丢掉。

验证：
· 主测试 33/0（分数用独立实现重算比对，不调用产品函数算期望值）
· 反向验证 20/0（基线 2 + 框架自检 2 + 注入 8 组×2）
  八组注入：时间窗加回 / 去 post_type / 去 log10 / 权重改 1-3-5 /
  标题退裸拼 / 全局时区加回 / 排序改升序 / 后台加回统计天数
· 真浏览器几何 22/0（1440+1180 两视口）：6 条真画出来、宽度等于面板、
  图标存在、不重叠、长标题走省略号不溢出
· 发布反证 8/8、线上包校验 10/10
This commit is contained in:
laoyang
2026-10-26 22:30:02 +08:00
parent 492d8e11a6
commit d3070bea5b
2 changed files with 192 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
inc/theme-widgets.php
+191 -31
View File
@@ -35,26 +35,163 @@ function widgets_init()
}
add_action('widgets_init', 'widgets_init');
// 小工具文章聚合 - 热点文章
function most_comm_posts($days = 30, $nums = 6)
/* ==========================================================================
* 热度算法（3.2.49）
*
* ── 为什么废弃旧的 most_comm_posts() ──────────────────────────────────
* 旧实现的候选池是「最近 N 天（默认 30）**发布**的文章」：
*
* WHERE post_date BETWEEN '$daysago' AND '$today'
* ORDER BY comment_count DESC LIMIT 6
*
* 对日更站点没问题，对低频更新的站点直接失效。本站实测（2026-10-26）：
* 7 天内发布 0 篇 / 30 天内 1 篇 / 90 天内 1 篇 / 180 天内 6 篇
* 30 天候选池只有 1 篇 ⇒ LIMIT 6 也只能返回 1 条。
* 这就是侧栏「热点」永远只显示一条的真正原因 —— **不是排序错，是池子空**。
*
* 而且「最近 30 天发布」本身就不是「热」的定义：热是累计互动，不是新鲜度。
*
* ── 现在的算法 ────────────────────────────────────────────────────────
* 候选池：全站所有已发布 post（不含 page —— 「留言本」这种页面 views 214 万，
* 它的热度对"最热文章"没有意义；`post_type='post'` 天然挡掉）。
* 打分：三个指标各取 log10 后加权求和
*
* score = 3*log10(views+1) + 5*log10(love+1) + 4*log10(comments+1)
*
* 为什么取 log10：本站 views 中位数 4981、最大 56075（差 11 倍），
* 但 love 最大只有 40、评论最大 93。不取对数的话 views 一个指标就吃掉
* 全部权重，点赞和评论等于没参与。取对数后三者量级被拉平到可比的区间。
*
* 为什么权重是 3 / 5 / 4（不是常见的 1 / 3 / 5）：
* 用通用值实测，前 8 名有 6 篇是 2009 年的老随笔 —— 因为那批文章评论
* 80~93 条，仅评论一项（1.97×5=9.86）就压过 views 最大值的贡献（4.75×1=4.75），
* 结果变成"评论数排行榜"。把 views 权重提到 3 之后三个指标影响力均衡：
* 点赞最高（5）—— 点👍 是比评论更强的认可信号，且本站只有 197 篇有点赞，
* 稀缺性让它更有区分度；评论次之（4）—— 要付出打字成本；浏览最轻（3）。
*
* 实测这组权重的排名（前 8）：Anaconda多用户安装(love=40) · kratos主题发布(love=9,评论37)
* · LaTex上划线(love=19) · 那一年2009 · LaTex字体(love=12) · Windows7自带WMP(评论93)
* → 技术文章与高互动随笔混合出现，2009 年那批也没有被完全埋掉。
*
* ── 有意不加时间衰减 ──────────────────────────────────────────────────
* 「全站历史最热」是累计榜，不是时效榜。Hacker News / Reddit 那套
* gravity 衰减是给「新内容榜」用的，加上去会把老文章压到看不见，
* 那就又回到"只有最近几条"的老问题。要时效榜是另一个功能，不塞在这里。
*
* ── 顺手修掉的两个坑 ──────────────────────────────────────────────────
* ① 旧代码里 `date_default_timezone_set("PRC")` 直接改 **PHP 全局时区**，
* 影响同一请求里之后所有时间函数。已删。
* ② 旧代码把 `$title` 原样插进 `title="..."` 属性，标题里有双引号就会
* 截断属性（甚至注入）。已改用 esc_attr()。
* ====================================================================== */
if (!function_exists('yang_hot_score')):
/**
* 单篇文章的热度分。
*
* @param int $views 浏览数
* @param int $love 点赞数
* @param int $comments 评论数
* @return float
*/
function yang_hot_score($views, $love, $comments)
{
return 3 * log10((int) $views + 1)
+ 5 * log10((int) $love + 1)
+ 4 * log10((int) $comments + 1);
}
endif;
if (!function_exists('yang_hot_posts')):
/**
* 取热度最高的文章。
*
* 为什么在 PHP 里算分、不在 SQL 里 ORDER BY：
* 分值是三项 log 加权和，SQL 里要写三段 LOG10 + COALESCE + 两个
* LEFT JOIN 到 postmeta，可读性极差，而且没法复用 yang_hot_score()
* （测试和产品必须是同一份实现，不能各写一遍）。
* 代价是要把候选行取回来 —— 本站 967 篇 post，一次取 4 个字段
* 内存占用可忽略；如果将来文章上万，再加 LIMIT / 缓存。
* 为防止极端情况，SQL 侧先用 views 粗排取前 N*10（对数排序里
* 真正的高分不会来自 views 极低的文章，这个粗排是安全的）。
*
* @param int $nums 返回条数
* @return array 文章对象数组，每项含 ID/post_title/views/love/comments/score
*/
function yang_hot_posts($nums = 6)
{
global $wpdb;
date_default_timezone_set("PRC");
$today = date("Y-m-d H:i:s");
$daysago = date("Y-m-d H:i:s", strtotime($today) - ($days * 24 * 60 * 60));
$result = $wpdb->get_results("SELECT comment_count, ID, post_title, post_date FROM $wpdb->posts WHERE post_date BETWEEN '$daysago' AND '$today' and post_type='post' and post_status='publish' ORDER BY comment_count DESC LIMIT 0 , $nums");
$nums = max(1, (int) $nums);
// 粗排窗口：给足余量。views 前 200 名以外不可能靠 love/评论翻盘
// （log10 域下，love 满分 1.61×5=8.05，补不回 views 差 1 个数量级的 3 分）。
$pool = max(200, $nums * 20);
$sql = $wpdb->prepare(
"SELECT p.ID, p.post_title, p.post_date, p.comment_count,
COALESCE(CAST(mv.meta_value AS UNSIGNED), 0) AS views,
COALESCE(CAST(ml.meta_value AS UNSIGNED), 0) AS love
FROM {$wpdb->posts} p
LEFT JOIN {$wpdb->postmeta} mv ON mv.post_id = p.ID AND mv.meta_key = 'views'
LEFT JOIN {$wpdb->postmeta} ml ON ml.post_id = p.ID AND ml.meta_key = 'love'
WHERE p.post_status = 'publish'
AND p.post_type = 'post'
ORDER BY views DESC
LIMIT %d",
$pool
);
$rows = $wpdb->get_results($sql);
if (empty($rows)) {
return array();
}
$scored = array();
foreach ($rows as $r) {
$r->views = (int) $r->views;
$r->love = (int) $r->love;
$r->comments = (int) $r->comment_count;
$r->score = yang_hot_score($r->views, $r->love, $r->comments);
$scored[] = $r;
}
usort($scored, function ($a, $b) {
if ($a->score == $b->score) {
// 同分按浏览数兜底，保证顺序稳定（否则每次刷新顺序会跳）
return $b->views <=> $a->views;
}
return $b->score <=> $a->score;
});
return array_slice($scored, 0, $nums);
}
endif;
/**
* 小工具文章聚合 —— 热点文章
*
* ⚠️ 这个函数名和签名保留着，因为 `widget_posts::widget()` 里有一句
* `if (function_exists('most_comm_posts'))` 调用它。留着旧名不破兼容，
* 但内部已经完全换成 yang_hot_posts()。
*
* @param int $days 已废弃。旧实现用它当"最近 N 天发布"的时间窗，
* 那正是只显示一条的根因。保留参数只为不破坏调用签名。
* @param int $nums 返回条数
*/
function most_comm_posts($days = 30, $nums = 6)
{
$posts = yang_hot_posts($nums);
$output = '';
if (!empty($result)) {
foreach ($result as $topten) {
$postid = $topten->ID;
$title = $topten->post_title;
$commentcount = $topten->comment_count;
if ($commentcount >= 0) {
$output .= '<a class="bookmark-item" title="' . $title . '" href="' . get_permalink($postid) . '" rel="bookmark"><i class="kicon i-book"></i>';
$output .= strip_tags($title);
$output .= '</a>';
}
}
foreach ($posts as $p) {
$output .= '<a class="bookmark-item" title="' . esc_attr($p->post_title) . '"'
. ' href="' . esc_url(get_permalink($p->ID)) . '" rel="bookmark">'
. '<i class="kicon i-book"></i>'
. esc_html(wp_strip_all_tags($p->post_title))
. '</a>';
}
echo $output;
}
@@ -314,8 +451,10 @@ class widget_posts extends WP_Widget
public function widget($args, $instance)
{
$number = !empty($instance['number']) ? $instance['number'] : '6';
$days = !empty($instance['days']) ? $instance['days'] : '30';
$number = !empty($instance['number']) ? (int) $instance['number'] : 6;
if ($number < 1) {
$number = 6;
}
echo '<div class="widget w-recommended">';
?>
@@ -331,16 +470,37 @@ class widget_posts extends WP_Widget
</div>
<div class="tab-content" id="nav-tabContent">
<div class="tab-pane fade show active" id="nav-new" role="tabpanel" aria-labelledby="nav-new-tab">
<?php $myposts = get_posts('numberposts=' . $number . ' & offset=0');foreach ($myposts as $post): ?>
<a class="bookmark-item" title="<?php echo $post->post_title; ?>" href="<?php echo get_permalink($post->ID); ?>" rel="bookmark"><i class="kicon i-book"></i><?php echo strip_tags($post->post_title) ?></a>
<?php
/* 🔴 原来写的是 `'numberposts=' . $number . ' & offset=0'` ——
* 字符串里带空格，WP_Query 解析时参数名变成 `' offset'`（前面
* 有空格），`offset=0` 实际没生效。offset=0 本身是默认值，
* 所以症状看不出来，但这是错的写法。改成数组传参。 */
$myposts = get_posts(array(
'numberposts' => $number,
'offset' => 0,
));
foreach ($myposts as $post): ?>
<a class="bookmark-item" title="<?php echo esc_attr($post->post_title); ?>" href="<?php echo esc_url(get_permalink($post->ID)); ?>" rel="bookmark"><i class="kicon i-book"></i><?php echo esc_html(wp_strip_all_tags($post->post_title)) ?></a>
<?php endforeach;?>
</div>
<div class="tab-pane fade" id="nav-hot" role="tabpanel" aria-labelledby="nav-hot-tab">
<?php if (function_exists('most_comm_posts')) {most_comm_posts($days, $number);}?>
<?php
/* 热点：全站累计热度（views/love/评论 三项 log 加权），
* 不再受「最近 N 天发布」的时间窗限制。原因见 most_comm_posts()
* 上方的注释块。 */
if (function_exists('most_comm_posts')) {
most_comm_posts(0, $number);
} ?>
</div>
<div class="tab-pane fade" id="nav-random" role="tabpanel" aria-labelledby="nav-random-tab">
<?php $myposts = get_posts('numberposts=' . $number . ' & offset=0 & orderby=rand');foreach ($myposts as $post): ?>
<a class="bookmark-item" title="<?php echo $post->post_title; ?>" href="<?php echo get_permalink($post->ID); ?>" rel="bookmark"><i class="kicon i-book"></i><?php echo strip_tags($post->post_title) ?></a>
<?php
$myposts = get_posts(array(
'numberposts' => $number,
'offset' => 0,
'orderby' => 'rand',
));
foreach ($myposts as $post): ?>
<a class="bookmark-item" title="<?php echo esc_attr($post->post_title); ?>" href="<?php echo esc_url(get_permalink($post->ID)); ?>" rel="bookmark"><i class="kicon i-book"></i><?php echo esc_html(wp_strip_all_tags($post->post_title)) ?></a>
<?php endforeach;?>
</div>
</div>
@@ -351,25 +511,25 @@ class widget_posts extends WP_Widget
{
$instance = array();
$instance['number'] = (!empty($new_instance['number'])) ? $new_instance['number'] : '';
$instance['days'] = (!empty($new_instance['days'])) ? $new_instance['days'] : '';
$instance['number'] = (!empty($new_instance['number'])) ? (int) $new_instance['number'] : 6;
/* `days` 已废弃：旧实现拿它当「最近 N 天发布」的时间窗，
* 那正是热点只显示一条的根因。这里不再保存，
* 老实例里残留的 days 值会在下次保存时被丢掉。 */
return $instance;
}
public function form($instance)
{
global $wpdb;
$number = !empty($instance['number']) ? $instance['number'] : '6';
$days = !empty($instance['days']) ? $instance['days'] : '30';
?>
<div class="media-widget-control">
<p>
<label for="<?php echo $this->get_field_id('number'); ?>"><?php _e('展示数量：', 'kratos');?></label>
<input class="widefat" id="<?php echo $this->get_field_id('number'); ?>" name="<?php echo $this->get_field_name('number'); ?>" type="text" value="<?php echo esc_attr($number); ?>" />
</p>
<p>
<label for="<?php echo $this->get_field_id('days'); ?>"><?php _e('统计天数：', 'kratos');?></label>
<input class="widefat" id="<?php echo $this->get_field_id('days'); ?>" name="<?php echo $this->get_field_name('days'); ?>" type="text" value="<?php echo esc_attr($days); ?>" />
<p class="description">
<?php _e('「最新」「随机」「热点」三个标签页都用这个数量。', 'kratos'); ?><br>
<?php _e('「热点」按全站累计热度排序：浏览量、点赞数、评论数三项分别取对数后加权（3 : 5 : 4），不受发布时间限制。', 'kratos'); ?>
</p>
</div>
<?php
style.css
+1 -1
View File
@@ -1,7 +1,7 @@
/*
Theme Name: Kratos_Yang
Text Domain: kratos_Yang
Version: 3.2.48
Version: 3.2.49
Requires PHP: 7.0
Description: 这是一个Kratos主题的分支版本，用来增加一些定制化功能。
Tags: 博客, 双栏, 响应式, 自定义背景, 自定义颜色, 自定义图标, 自定义菜单, 特色图像, 收录优化, 邮件中心, 主题选项, 小工具, 文章置顶, 无障碍友好