laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
73 Commits 1 Branch 0 Tags
d3070bea5b3eb0a649732eeae8a649ee073619bd
Commit Graph
5 Commits
Author SHA1 Message Date
laoyang cbe0f2dc59 3.2.18: 清明按节气换算、主题内 [TOC] 目录、重建评论区替代 wpDiscuz 
三项功能：

1. 清明不再用固定 04-04
   清明是节气，日期在 4/4~4/6 之间浮动。硬编码 04-04 实测 1900-2100
   共 201 年里只有 76 年是对的（约 38%）。改为内嵌逐年表换算真实日期，
   超出 1900-2100 返回 null 明确放弃，不退化成近似值。
   兼容 3.2.17 及以前勾过的 '04-04' 键，升级后勾选不会被静默丢弃。

2. 主题内实现 [TOC]
   文章里写 [TOC]，该位置输出本文目录，点击跳到对应标题。
   在 the_content 优先级 9 处理（早于 wpautop 10 / do_shortcode 11），
   保证"补 id"与"扫目录"用的是同一份文本，href 与 id 必然对得上。
   嵌套用深度归一化，h1→h3 跳级不会算错层级。
   scroll-margin-top 声明式让位，原生锚点/外部 #hash/后退全都生效。

3. 重建评论区
   旧实现的问题：列表渲染与 AJAX 渲染各写一份 HTML，已经分叉
   （AJAX 返回的新评论没有回复按钮）；<li> 被 <div> 包着，嵌套回复错位。
   现在统一到 yang_comment_html() 单一渲染函数，列表与 AJAX 只差一个
   is-new 类。同时修掉三处真实缺陷：
     · 评论项用 flex 会把 <ol class="yang-children"> 当成第三个 flex 项，
       子评论跑到父评论右侧、正文被挤到 156px、页面横向溢出 75px —— 改 grid
     · 成功提示在 exitReplyMode() 之前设置，被其末尾的 setStatus('','')
       擦掉，用户提交成功却看不到反馈 —— 调整顺序
     · 窄屏媒体查询打不过深层选择器（媒体查询不增加特异性），
       嵌套头像反向变大 —— 补深层覆盖

   与 wpDiscuz 解耦：邮件模块不再无条件 return false（那等于永久关掉
   notify_postauthor 且不报错）；插件在场时不加载主题评论资源，
   避免双份表单互抢。

验证：PHP 语法 73/73；_static_qingming 36、_test_toc 53、
_test_comments 62、_test_comments_falsify 17、
_toc_geometry 121、_toc_geometry_falsify 9、
_comments_geometry 98、_comments_geometry_falsify 23，全部 0 失败。
线上端到端 29/0（真实文章渲染目录 + 真实评论数据渲染）。
 2026-10-24 01:03:36 +08:00
laoyang 0799268661 3.2.16: 删三项无用功能、选项重排为 10 组、修移动端提示条偏左 
删除
- 微信二维码：配置项 s_wechat / 隐藏上传 s_wechat_url、footer 浮动块、
  默认图注册表条目、CSS 规则、wechat.png
- Font Awesome：选项 g_fontawesome、theme-core 入队、58KB 样式、
  assets/fonts/webfonts 全套字体（2.8MB，CSS 删后零引用）
- 多人模式：选项 multiusers、page-content / page-toolbar 两处分支

选项重排（9 组 → 10 组）
全站配置 / 顶部导航 / 首页配置 / 文章配置 / 站长信息 /
页脚配置 / 哀悼模式 / 收录与统计 / 邮件通知 / 自定义代码
哀悼 5 个字段从「首页配置」独立成「哀悼模式」——它不是首页专属功能。
g_404/g_chrome/g_animate/g_gravatar 等归「全站配置」，s_copyright 归「页脚配置」。

修复
- footer.php 版权行此前无条件硬编码，后台 s_copyright 填了不生效
- 附加日期命中时 yang_mourning_today_name() 返回空串，提示条退化成
  只说「今天是纪念日」而不给名字
- 小屏哀悼提示条 padding 写成 `7px 40px 7px 12px`（右宽左窄给关闭按钮
  让位），内容盒中心 181 vs 视口中心 195，整体偏左 14px。关闭按钮本就
  absolute 不占内部流，改为左右等宽 + 缩小按钮。桌面端同类错误 3.2.14 已修，
  此处漏了同一个断点。

加载顺序
theme-options.php 可能早于 theme-mourning.php / theme-custom-code.php 加载，
新增 yang_opt_* 四个 function_exists 包装，避免裸调用导致后台白屏。

验证：静态断言 62/0 · 后台面板 14/0 · 反向验证 7/7 与 44/0 ·
提示条 4 视口几何 20/0（注入旧 bug 精确复现 -14px）· 线上 3 视口 33/0
 2026-10-23 22:56:10 +08:00
laoyang 96bbb3d1b5 v3.2.14 哀悼提示条改到整页最上方正中，只在纪念日当天出现 
用户要求：哀悼说明「放在最上方的最中间，只在纪念日、哀悼模式开启时才显示，
其他时间不显示」。

改的过程中量出三个真问题：

1. 提示条与站点标题重叠 32px。提示条从 y=0 开始、高 40px，而导航栏
   .k-nav 是 position:absolute; top:0、z-index 1030；提示条 z-index 9990
   ⇒ 直接盖在 Logo 上。CSS 每个字都没写错，就是叠在一起。
2. 内容偏左 38px。为了给右侧关闭按钮让位写了 padding-right:46px、
   左侧只有 18px ⇒ 文字中心 602 vs 视口中心 640。"最中间"没做到。
3. 页脚有常驻的「纪念日哀悼说明」链接，一年 365 天都显示。平时打开
   站点的人既没看到黑白也不知在哀悼什么，这个入口本身就是困惑源。

修法：
- 提示条占文档流第一行、width:100%，内容交给内层 .ymb-inner 居中，
  左右 padding 等宽、关闭按钮 absolute 不占内部流 ⇒ 几何中心 = 视口中心。
- .k-nav 是绝对定位，body 的 padding 推不动它（这个原因单看代码想不到，
  是量几何量出来的）⇒ 单独补一条 body.has-yang-mourning-bar .k-nav{top:var(--ymb-h)}。
  偏移量由脚本读真实高度写入，窄屏换行后也准。
- 不用 fixed：那会滚动时顶部永远压一条深色带，内容从它下面穿过去。
- 移除页脚常驻入口与 wp_footer 注册，说明页入口只在提示条里。
  非哀悼日输出 0 字节。

验证：
- run_tests2 163 条（新增 9 条位置契约）
- _check_hidden.php 19 条（非哀悼日 0 字节、每个纪念日都能触发）
- mourning_bar_geometry.py 28 条（线上真实页面实测 4 种视口：
  顶部贴边、横跨整宽、居中误差 ≤1px、与标题和导航栏零重叠）
- falsify 44 条注入全被抓住（新增 9 条）

两个假绿当场被反面验证抓出并修掉：
- 判据照着 fixed 方案写，实现改成 relative 后 4 条断言集体假红
  （教训：设计前提变了，判据必须跟着改）。
- 页脚断言用 ob_start 取输出，但函数是 return 不是 echo ⇒ $fl 恒空
  ⇒ 注入"返回一个链接"仍全绿（教训：否定式断言在空输出上恒真）。
 2026-10-23 20:43:25 +08:00
laoyang 269364bed4 版本号 3.2.6 -> 3.2.7（纪念日全部默认不勾 + 彩色说明页 + 邮件彩色 + 双引用块） 
哀悼默认值全部改为不勾选
- 九个纪念日的 default 全改成 0。之前法定那三个是 1，导致全新安装的站点
  一到日子就自己变黑白，而站主根本没同意过这件事。
- 后台多选组件的 std 全为 0，打开设置页一个都不勾。
- 「从未保存过」与「保存过但全不勾」两条路径都返回空数组，
  不能因为结果为空就回退到默认 —— 那等于用户取消勾选无效。

新增彩色说明页（inc/theme-mourning-page.php + pages/page-mourning.php）
- 站点变黑白后必须有个地方解释清楚，否则访客只看到一片灰、以为站点坏了。
- 三处入口：顶部提示条（wp_body_open，首屏可见）、页脚常驻链接、
  [yang_mourning] 短代码。
- 页面内容由真实配置驱动，不是写死的文案：没勾的日期不会出现，
  今天在列表里带「今天」标记，一个都没勾时明说「不会生效」。
- 页面必须保持彩色，否则解释「为什么是灰的」的页面自己也是灰的。
  取消灰度做了两层：filter:none 与 grayscale(0%) 都写，且带 !important；
  优先级放在 wp_head 的 2，晚于灰度样式的 1。
- 路由走 parse_request 优先级 5 而非 template_redirect：
  避免先走一遍 404 判定与 404 模板。带子目录安装时先剥掉前缀再比对。
- 不抢占用户自己建的页面：如果站里已有同名 slug 的页面就放手。
  否则用户会觉得「我建的页面坏了」，且没有任何提示。

邮件不受影响，且回复邮件同时给出双方内容
- 邮件是独立 HTML，不走 wp_head，结构上就不可能被灰度，已断言验证。
- theme-mail-template 的单个 quote 改成 quotes 列表，一个模板同时渲染
  「被回复的那条」与「新的回复」，最后一块用主色高亮（回复是重点），
  前面的用弱化色。只有一块时退化为主色，与旧行为一致。
- 通过 wpdiscuz_email_content 重建整封邮件，不需要改插件。
  审核通过通知用 wpdiscuz_comment_approved_email_content 走同一模板，
  但它只给 post_id、不给评论对象，能放的内容受此限制。

两个必须记下来的坑
- wpDiscuz 在过滤器之后还会做一次 html_entity_decode 再发信。
  esc_html 的输出会被那一步还原成真标签，评论里的 <script> 直接生效。
  所以返回前先把 & 编码一次。本地 stub 没有这一步，测试看不出来。
- header.php 从来没有调用 wp_body_open，挂在上面的东西全部静默失效。
  不调用不会报错，只会「什么都没发生」。已补在 <body> 之后。

yang_mail_text 保留换行
- 原来用 wp_strip_all_tags($t, true)，第二个参数 remove_breaks 会把换行
  压成空格；而 strip_tags 遇到 <br> 是直接删掉不补换行的。
  结果整条评论被拍成一行，模板里的 nl2br 成了死代码。
- 改为先把块级边界降级成 \n，再去标签（remove_breaks=false）。
  收行内空白用 [^\S\n] 而不是 [ \t\f\v]：PCRE 的 \v 是垂直空白类，
  会把 \n 一起匹配掉。

说明页对比度修正（WCAG AA）
- 金色 #b8860b 在白底只有 3.06:1，当装饰色没问题，当 12-15px 文字偏虚。
  拆成 --ym-gold（装饰）与 --ym-gold-text（#946600，4.75:1，仍属金色）。
- 分组小标题 #9aa5b1 只有 2.36:1，改用 #5f6b78（5.12:1）。
- 「今天」标签白字压金底 3.25:1，改用 #8a6100（5.54:1）。
 2026-10-23 14:43:47 +08:00
laoyang 37c52948c4 版本号 3.2.5 -> 3.2.6（统一邮件出口 + 邮件模板 + 纪念日自动哀悼 + 去掉广告位） 
评论邮件重复的根因是发信源不止一个，分两层处理：一层管「谁发」，一层管「发几封」。
只做前者的话邮件照样重复，只是都从同一个 SMTP 出去。

邮件治理（新增 inc/theme-mail.php）
- phpmailer_init 优先级 9999 接管通道，保证主题配置优先于其它 SMTP 插件；
  接管前先重置可能被别的插件设过的字段，避免残留半套配置。
- From 强制等于 SMTP 登录账号。QQ / 163 会以「发件人不符」拒收。
- wp_mail 优先级 99 统一 From 与 Content-Type；调用方自带的 From 与
  Content-Type 被剥离后重建，自定义 header 保留。
- wp_mail 优先级 100 做短期去重：同一收件人 + 同主题 + 同正文，90 秒内只发一次。
  用 transient 是因为评论通知跨请求（wpDiscuz 走 AJAX、审核通知走后台请求），
  静态变量跨不过去。90 秒足够宽（一次提交引发的通知都在同一秒）也足够窄
  （手动重发通常隔几分钟，不该被吞）。
- 被去重的那次把 to 置空并由 pre_wp_mail 返回 true，而不是 return null：
  返回 null 会改变 wp_mail 返回值语义，有的插件据此判定失败并重试，反而更多封。
- 用 filter 关掉核心的 notify_postauthor / notify_moderator，不改进数据库里的
  comments_notify / moderation_notify。改用户设置属于越权，而且用户下次进后台
  一勾又回来了；filter 是可逆的。只拦通知，不影响评论审核流程。
- 线上站点 m_smtp=1 但 m_host 为空时判定为「未就绪」并完全放手。只勾开关不填
  主机时若强行接管，所有邮件会静默失败，比回退到 mail() 更糟。

邮件模板（新增 inc/theme-mail-template.php）
- 表格布局 + 全内联样式：Outlook 2007-2019 用 Word 引擎，不认 flex / grid；
  Gmail 会剥掉 <head> 里的 style 块（含 media query）。
- 不用外部图片、不用 CSS 变量、不用 ::before。按钮的 padding 放在 td 上，
  因为 Outlook 忽略 a 的 padding。
- 宽度用混合写法：HTML 属性 width=600 给 Outlook，CSS 的
  width:100% + max-width:600px 让手机窄屏自动收窄。只写死 600px 会让手机横向滚动。
- badge 背景用预算的实色而非 rgba。Outlook 不支持 rgba，会当成非法值丢掉，
  半透明背景变成全透明，badge 直接消失。
- 主色下沿那条 3px 深色带必须 height 同时写成 HTML 属性和 CSS，
  否则 Outlook 把它撑成一行文字高，比例就毁了。
- 用 WCAG 相对亮度判断主色深浅来决定叠在上面的文字用白还是深色。
  简单取平均会把 #00ff00 判成中等亮度（人眼对绿最敏感、蓝最不敏感）。
- 次要文字统一调到 #5f6b78。原来的浅灰在白底上只有 1.84:1，看着"高级"但读不出来；
  现在最低 4.62:1，全部过 AA。

theme-smtp.php
- 删掉 comment_notify / comment_approved 两个钩子及其硬编码模板。这两个钩子与
  wpDiscuz 的 notifyCommentSubscribers 完全重复，是重复收信的直接来源。

纪念日自动哀悼（新增 inc/theme-mourning.php）
- 法定纪念日三个默认勾选：09-03 抗战胜利纪念日、09-30 烈士纪念日、
  12-13 南京大屠杀死难者国家公祭日。依据是 2014 年全国人大常委会两次决定，
  已在代码注释里记下来源。
- 民间通行做法（05-12、09-18 等）默认不勾，由用户自己决定。替用户做价值判断不合适。
- 一次性全国哀悼日（2020-04-04 等）支持 YYYY-MM-DD 写法，只在当年生效。
  不能当周年循环，否则明年 4 月 4 日又自动变黑白。
- 按站点时区判断（current_time），不按服务器时区。服务器在 UTC 时会晚 8 小时生效。
- 只挂 wp_head 而不限定 is_home()：老代码限定首页，详情页不黑白，那是 bug。
- 打印时取消灰度，否则打印出来是灰的。
- 保留旧的 g_rip 手动常开开关。不能因为升级把原本黑白中的站点变回彩色。

options-framework
- 补 multicheck 的渲染分支与 of_sanitize_multicheck。框架原来只在保存侧处理了
  这个类型，没有渲染分支，所以这个类型此前根本不可用。
- 值存成 array(键 => 1|0) 而不是「勾选了的键组成的列表」：列表无法区分
  「用户明确全部取消」和「从未配置」，会导致取消勾选后静默回退到默认值。
- 读取侧用 array_key_exists 判断是否保存过，而不是判断值是否为空。
- 配套补上 of-multicheck 样式，没有样式时 9 个选项会挤成一行流水文字。

去掉广告配置
- 删除主题选项里的广告配置段，以及 single.php 里上下两处广告位输出。

验证
- 全主题 68 个 PHP 文件语法检查通过。
- 行为测试 82 条、multicheck 闭环 25 条、邮件几何 15 条、设计审计 23 条。
- 反向验证 16 个注入 bug 全部被断言抓住（去重失效、不写标记、to 未清空、
  From 未剥离、亮度算法退化、时区改用 date()、全不勾回退默认等）。
- 邮件最低文字对比度 4.62:1；320px 视口下卡片自动收窄到 296px 不溢出。
 2026-10-23 13:55:23 +08:00