 laoyang
|
492d8e11a6
|
3.2.48: 归档倒序/字号/底边对齐/共N篇 + 评论标题线等长 + 工具条分隔线统一 #18
工单 #18 八条诉求逐条落地：
1. 月份、日期、年份全部倒序（最近的在最上面）
- PHP 侧 `krsort($years[$y]['months'])`（原来是 ksort）
- JS 侧 `Object.keys(...).sort((a,b)=>b-a)` —— 对象键序对纯数字整数键
会强制升序，服务端顺序传不过来，必须前端自己再排一次
- 年份本来就是 krsort，日期本来就是倒序，本次只补月份
2. 年份字体再大一点
- 原来 CSS 写的 22px **从来没有生效过**：`.yang-archives .ar-year` 是
(0,2,0)，被 `.k-main .details .article .content h3` 的 (0,4,1) 压死，
线上实际是 18px
- 改为带 `.k-main` 前缀（提到 (0,5,0)）+ 26px + 700
- `.ar-month-title` 同一个坑，一并修（写 14px/600，线上实际 16px/500）
3. 「共 N 篇」太高、比年份还高 → 下移与年份底边对齐
- `.ar-head` 的 `align-items: center` → `flex-end`
- `.ar-year` 的 margin 显式清零（kratos 的 `h1..h6 { margin: 0 0 30px 0 }`）
- 窄屏媒体查询同步改，否则手机上又回到居中
- 注意 `flex-end` 对的是 margin box，所以 margin 不清零等于没改
4. 每月后面的裸数字 → 「共 N 篇」
- PHP：`sprintf(esc_html__('共 %s 篇'), number_format_i18n(...))`
- JS：同一个文案键 `i18n.monthCount`，服务端输出到 `yangArchivesData`
- 新增 `monthCount` 键，**没有复用** `totalFmt`（两处语义不同，
以后要分别改文案时不至于互相牵连）
5. 上一年/下一年按钮看不清 → 与「写下你的评论」同款观感
- 平时：`1px solid #cfe6fb` 浅蓝框 + 透明底 + `--yq-primary-dark` 蓝字
- 悬停：主色实底 + 白字（`.ar-nav-year` / `.ar-nav-arrow` 也要跟白，
否则图标还是蓝的在蓝底上看不见）
- 禁用态保持灰（`is-disabled` + opacity .42），不能跟可用态一个样
6. 评论「评论者」下面的灰线太短 → 延长到与评论分隔线等长、右侧到头
- 🔴 这里改过一次方案：一开始以为把 h3 `flex: 1 1 auto` 撑宽就行，
实测发现 `.comments-head` 是 flex 行，右边还有「写下你的评论」按钮
（flex: 0 0 auto），h3 撑满也只能长到按钮左边缘 —— 原理上到不了右端
（实测 h3 110.5px / li 561.98px，差的 451px 就是按钮 + gap）
- 最终方案：**线从 h3 搬到 `.comments-head` 容器上**，
h3 显式 `border-bottom: none` 干掉 kratos 的 #f0f0f0，
否则会出现一短一长两条线，比原来更难看
- 容器那条规则**还必须带 `.k-main` 前缀**（(0,5,0)），否则压不过
kratos 的 `.comments .title`。发布判据当场抓到这一条：注释里写了
「带 .k-main 前缀」，代码里漏了 —— 注释不能当证据
7. 工具条分隔细线不统一 → 5 个按钮 4 条线
- 原来 B/I 之间没有线，其余有 ⇒ 现在统一
- 写成「每条后面跟一条」会在末尾多出贴容器边缘的孤线，所以是 5 按钮 4 线
8. 清理无用 JS/CSS
- 四轮查证结论：**没有可安全删除的**，代码一行未动
- 排查过程已作为评论发到工单
测试：归档单测 113/0（反向 13 真红）、归档 e2e 112/0（反向 24 真红）、
评论几何 157/0（反向含新增 5 条，覆盖"线搬回标题""两处都画"两种错误形态）。
线上真实页面几何探针发布前 17 通过/16 失败（每条都对应上面某一条诉求），
发布后要求全绿。
|
2026-10-26 18:42:40 +08:00 |
|
|
laoyang
|
db2e9c4230
|
3.2.47: 修 [Archives] 首字母大写不生效（WP 短代码标签区分大小写）#17
用户线上实测：页面 /blogtime 写 [Archives] 原样输出 <p>[Archives]</p>，
看起来像"短代码没装/被 markdown 插件转义"，实际是标签名大小写对不上。
根因（内核证据，wp-includes/shortcodes.php）：
· get_shortcode_regex() 用 implode('|', array_map('preg_quote',$tagnames))
拼正则，不做任何大小写归一化
· do_shortcode() 的 preg_match_all('/'.get_shortcode_regex().'/') 没有 i 修饰符
· do_shortcode_tag() 用 $m[2] 精确查 $shortcode_tags
⇒ add_shortcode('archives') 只匹配全小写，[Archives] 完全匹配不上。
线上实测（真实 WP 环境跑 do_shortcode）：
[archives] 长度=209239 解析=是
[Archives] 长度=10 解析=否（原样返回）
[ARCHIVES] 长度=10 解析=否（原样返回）
3.2.46 里我写的注释"WP 短代码标签大小写不敏感、内部统一 strtolower"
是错的，这一版一并改正。
改动：
· inc/theme-archives.php
- 同时注册 archives / Archives / ARCHIVES 三种写法
（不为任意混合大小写膨胀正则，[aRcHiVeS] 刻意不支持，已加断言锁住）
- 修短代码签名：$atts, $content, $tag —— 补上中间的 $content
WP 通过 call_user_func($fn, $attr, $content, $tag) 传三个参数，
漏掉 $content 会让 $tag 落到第 2 个形参上，实际收到空串，
shortcode_atts_{$tag} 退化成无主的 shortcode_atts_
- shortcode_atts 第 3 参数改为实际命中的 $tag（原来写死 'archives'）
· style.css 版本号 3.2.46 -> 3.2.47
测试也一并修（这才是本轮最值得记的）：
· _archives_unit.php 的 add_shortcode 桩原来写了 strtolower($tag)，
比真实 WP 宽容 ⇒ 产品坏着、94 条断言全绿。
现在照抄内核不归一化，并新增真实的 do_shortcode 解析实现。
· ⑪ 组从"查注册表有没有 archives 这个键"改成"拿真实写法解析一遍"
· 新增断言：三种写法都渲染出 .yang-archives、
混合大小写原样返回（刻意不支持）、未注册标签原样保留、
shortcode_atts 收到的 tag 恰好是实际命中的那个
· _archives_unit_falsify.py 新增 R5~R8 四条注入：
R5 只注册小写（3.2.46 的错误形态）→ 红 10 条
R6 大写注册指向不存在的回调 → 红 4 条
R7 shortcode_atts 的 tag 写死小写 → 红 2 条
R8 签名去掉中间的 $content → 红 3 条
验证：
2j 评论关闭零输出 通过 54 / 0 失败
2k 评论关闭反向验证 真红 13 / 0 无效
2l 归档单测 通过 109 / 0 失败（原 94，新增 15 条）
2m 归档端到端 通过 109 / 0 失败
2n 归档端到端反向 真红 21 / 0 无效
2o 归档源码级反向 真红 10 / 0 无效（原 6，新增 4 条）
lint 96 个 PHP 文件全过
线上验证（真实 WordPress，不是模拟）：
补注册前：只 ["archives"]，[Archives] 原样返回
补注册后：["archives","Archives","ARCHIVES"]，三种写法长度全是 209239
发布：已推 3.2.47 到 /theme-update/，update.json 已落 3.2.47；
服务器 wp-content/themes/kratos_yang/ 仍为 3.2.46（未覆盖，
等用户在后台点升级）。
|
2026-10-26 14:04:12 +08:00 |
|
|
laoyang
|
7047ab3ece
|
3.2.46: 新增 [Archives] 归档短代码 + 评论关闭时整块零输出 #15
需求一：[Archives] 短代码 —— 归档式全站文章列表
· 在文章/页面正文写一行 [Archives]，该位置渲染全站文章的年月归档
· 默认显示今年，按月份归类；每篇带浏览/评论/点赞三个数
· 上下两排各有一组「上一年 / 下一年」按钮（四角），JS 切换不刷新页面
· 地址栏同步 ?arc_year=，刷新与分享链接都能保持同一年
· 只在用到短代码的页面才加载 assets/js|css/archives.js|css
· 参数：year="2025" 指定首年；month="0" 不按月分组
需求二：评论关闭时评论区整块消失
· comments.php 在**任何输出之前** `if (!comments_open()) return;`
—— 零字节，不是空容器、不是 display:none、不留提示文字
· 已有评论的老文章关评论后也不再显示（需求原话：正文之外什么都没有）
· inc/theme-comments.php 的资源守卫与之同口径：关评论时不加载
约 10KB 的 comments.css / comments.js
· 删掉 .comments-closed 样式与两处「评论已关闭」提示分支
开发中实测抓到并修掉的三个真实 bug（都是"测试把期望值写对之后"才显形）：
· 年份标题 / 导航年份过了 number_format_i18n() ⇒ 输出「2,025」，
而 JS 侧 String(year) 输出「2025」⇒ 首屏与切年后不一致
· 月份标题同样过 number_format_i18n()，与 JS 侧 String(m) 口径不一致
· yang_archives_render_nav() 把 ar-nav-top 写死，而下排也调它生成
⇒ 下排被叫成 top（视觉上被更高特异性规则压住，看不出问题）
验证：
归档 _archives_unit.php 94 通过 / 0 失败
_archives_e2e.js 109 通过 / 0 失败
_archives_e2e_falsify.js 反证 25 真红 / 0 无效
_archives_unit_falsify.py 反证 6 真红 / 0 无效
评论 _comments_closed_test.php 54 通过 / 0 失败
_comments_closed_falsify.py 反证 13 真红 / 0 无效
回归 _test_comments.php 64 通过 / 0 失败
_hl_unit_run.py 24 通过 / 0 失败
全量 96 个 PHP 文件语法检查通过；包内 lint 通过
发布 已推 3.2.46 到 /theme-update/，update.json 已落 3.2.46；
服务器 wp-content/themes/kratos_yang/ 仍为 3.2.45（未覆盖）
另：把 _archives_unit.php 从 `__DIR__` 定位改为接受根目录参数，
否则它无法登记进 verify_all.sh，只能手动跑（手动跑 = 长期不跑）。
5 个新套件已登记进 verify_all.sh（2j ~ 2o）。
|
2026-10-26 13:25:51 +08:00 |
|