laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
82 Commits 1 Branch 0 Tags
1a31e412b09f93f6c6f8367a2682a64ef0c5bc33
Commit Graph
82 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
laoyang 99e5a1ec0a 版本号 3.2.8 -> 3.2.9（邮件版式重做：白底 + 深色头部 + 暖色点缀） 
用户对 3.2.8 的"整封同色系"给出了明确否定，并说明要什么：
背景要白的；顶部深蓝底白字；「新回复」标签不能用蓝色，
要黄或红、与头部有区分度；「查看完整讨论」按钮红底白字。

版式骨架改成了「白底 + 深头 + 暖色点缀」：
- page_bg 由主色浅底改为纯白；
- 头部改为主色的深版（deepen_to 压到白字 7:1），白字达 AAA；
- 标签用暖色族，具体哪个由"与头部色相距离"挑（pick_warm），
  主色偏红时金黄才撞得开；
- 按钮固定红 #c62828 + 白字（5.62:1）；
- 新回复竖线改用同一套暖色，与标签呼应。

顺带修掉两个真 bug：
- 标题色的循环从最暗档开始扫，实际取到的是最暗档（亮蓝下几乎全黑），
  注释还写着"取最亮的达标档"，方向与实现相反。改为从 0.90 往下扫，
  并加色度下限（不低于种子 70%），避免浅主色被压成黑色；
- 纯中性灰主色下 21px 标题取到 #717171 中灰，发虚。改为深墨色。

测试同步重写（旧判据服务的是"整封同色系"，在白底版式下必红）：
- mail_color_audit.py 改为守四条性质：白底、头部深且白字达标、
  标签暖色且撞开、按钮红底白字；定位靠结构不靠猜颜色；
- pixel_color_audit.py 改为像素级守同一组性质：白像素 ≥45%、
  顶部横跨的深色带、带内白字像素、带内撞色像素；
  撞色必须判「带内」（判全图会把底部红按钮算进来，没牙齿）；
- falsify_color.py 四处注入全部退回旧做法，两层都能抓住；
- run_tests/run_tests2/visual_audit/mail_design_audit/mail_shot 里
  写死 #24292e 或"按钮跟主色"的过期断言一并改成本质性质。

verify_all.sh 14 组 / 463 条断言全绿（上一轮 320 条）。
 2026-10-23 17:08:55 +08:00
laoyang 9c48ba56eb 版本号 3.2.7 -> 3.2.8（邮件配色整封同色系化 + 对比度修复） 
邮件模板原来只有品牌条一个色块，其余大面积底色全是中性灰，
主色稍朴素（主题默认 #24292e）整封信看起来就是黑白的。

- 新增 yang_mail_palette()：底色/描边/强调文字全部从主色同色系派生
- 新增 yang_mail_chroma()/hsl()/hsl_hex()/ensure_chroma()/has_hue()
- 修复深浅判定：白字对比度 = 黑字对比度的交叉点在 L≈0.179，不是 0.5。
  用 0.5 会把亮蓝 #00a2ff（L=0.331）判成深色配白字，只有 2.76:1
- 新增 yang_mail_fg_on()：在白与深之间取对比度更高者，
  中灰 #808080 上从 4.41 提到 5.32（AA 达标）
- 修复：与白混合是同比压缩色度，0.94 档压 16 倍 ⇒ 近中性主色
  派生出的浅底只剩 0.002，物理不可见。加彩度兜底，按各自亮度补足
- 修复：页脚改浅底后 12px 说明文字降到 4.26:1，muted 改为按背景推导
- 品牌条/按钮仍严格用用户填的原色，补彩度只作用于派生色
 2026-10-23 16:13:48 +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
laoyang 4f0d19fb91 版本号 3.2.4 -> 3.2.5（修 Prism 报错，项目地址改为自建 Git） 
## 修 Prism is not defined

首页控制台报 `Uncaught ReferenceError: Prism is not defined`，来源是
wp-editormd 插件（不是本主题）：它在 Prism 脚本加载之前就无条件执行了
`Prism.plugins.autoloader.languages_path = "..."`。

线上页面里的真实顺序：
    第 668 行  该赋值语句
    第 695 行  prism-core.min.js
    第 696 行  prism-autoloader.min.js

在 `wp_head` 优先级 0 垫一个最小空壳 `window.Prism`（含 plugins.autoloader
这条访问链路），让那句赋值有地方可写。已核对 prism-core.min.js 源码：它开头
只读 `u.Prism.manual` 与 `u.Prism.disableWorkerMessageHandler`，结尾
`global.Prism = Prism` 整体覆盖 —— 空壳必定被真实对象替换，不承担持久职责，
只为吸收那条过早的赋值。已用 jsdom 验证：去掉空壳重现原始报错，加上后消失，
且之后 `Prism.highlightAll` 仍可正常调用。

## 项目地址统一到 code.yangyq.net

原作者署名、原主题地址、README、语言包、JS 里的控制台横幅全部换成自建仓库地址。
LICENSE 文件保持原样不动（MIT 要求保留原始版权声明）。

## CDN 分支改成拿不到就回退本地

原来的 `g_cdn` 分支指向 `cdn.jsdelivr.net/gh/vtrois/kratos`，本仓库在自建
Gitea 上，jsDelivr 只认 github/npm/wordpress，实测该地址 404。现改为仅在
`YANG_THEME_CDN_REPO` 常量存在时才走 CDN，否则一律用
`get_template_directory_uri()`。留一个 404 的地址比留空更危险：页面能开、
样式全丢，极难排查。

## 顺带

- `.gitattributes` 补 `*.mo binary`：原来是靠"含 NUL"启发式判定，不是契约
- `update.json` 的版本号跟进到 3.2.5
- `kratos.min.js` / `kratos.min.css` 用压缩器重新生成，不手工改产物
 2026-10-23 12:55:41 +08:00
laoyang b36f4b184a 版本号 3.2.3 -> 3.2.4（修复升级时二进制资源被行尾归一化破坏） 2026-10-23 12:27:05 +08:00
laoyang 1680ece73e 换主题缩略图，并把二进制文件锁进 .gitattributes 
缩略图：原图是 2740x1424 的宽屏截图，主题缩略图要求 1200x900（4:3），
按中心裁切后缩放到 1200x900。裁掉的是左右各 421px。

另加 .gitattributes：本仓库 core.autocrlf=true，工作区 CRLF、仓库 LF。
这条规则对源码是对的，但二进制文件里天然含 0x0D 0x0A，一旦被当成文本
转换就当场损坏 —— PNG 会变成 file 判不出的 "data"，getimagesize() 返回
false，WordPress 后台主题缩略图直接不显示。显式标 binary 后 git 不再动它们。

这次的损坏其实不是 git 干的，是打包脚本无差别 sed 's/\r$//' 造成的
（screenshot.png 少 3 个字节即 3 个 \r），脚本已同步修复。
 2026-10-23 11:17:55 +08:00
laoyang 16ea692e5d 版本号 3.2.2 -> 3.2.3（用于验证自动更新全链路） 2026-10-23 10:47:23 +08:00
laoyang eaabc7717f 把自定义样式从主题目录搬到主题选项，升级不再丢 
原来主题里有个 custom/ 目录（custom.css / custom.js / custom.php），
是给用户随手加样式的入口。问题是它位于主题目录内，而 WordPress 升级
主题的做法是把整个主题目录删掉再解压（class-theme-upgrader.php 里
clear_destination = true，随后 delete_old_theme() 递归删除），
所以每次升级这些文件都会丢。custom.php 还会被 require，
等于在主题里留了一个执行任意 PHP 的口子。

改成后台选项：
- 主题选项新增「自定义代码」组，含自定义 CSS / 自定义 JS 两个输入框
- 内容存在数据库的 kratos 选项里，与主题文件解耦，升级、重装都不影响
- 分别在主题样式和主题脚本之后加载，优先级最高

为此新增了 code 字段类型，没有复用 textarea：textarea 的 sanitizer
走 wp_kses()，CSS 的子选择器 > 和 JS 的 < 会被当成 HTML 标签剥掉，
样式会静默失效。code 类型只去掉 PHP 标签、打断 </style> 和 </script>，
其余原样保留。渲染时也不走公共的 stripslashes —— options.php 已经
wp_unslash 过，再剥一层会把 CSS 的 \f101、JS 的 \n 啃坏。

自定义 CSS 的默认值就是原来 custom.css 的内容，逐字节一致（354 字节），
所以升级瞬间站点外观没有任何变化。清空输入框保存即可彻底去掉。

验证：真实 WP 7.1.3 / PHP 8.5.12 环境 20 条断言全过（含 DB 往返、
子选择器 / 反斜杠保真、危险内容过滤），生产选项指纹前后一致；
反向注入「默认值改空」能立刻被抓到。
 2026-10-23 10:35:56 +08:00
laoyang 8a55457210 版本号升到 3.2.1 
自动升级靠 style.css 的 Version 判断有没有新版本，不升号线上永远收不到更新。
同时 THEME_VERSION 是静态资源 ?ver= 的缓存键，升号后浏览器会重新拉取，
避免用户拿着旧 CSS 看不到本次的样式修复。
 2026-10-23 09:06:35 +08:00
laoyang ffbe1b9b73 修复压缩产物丢失的代码块样式，并把主题更新源收进主站 
1. kratos.min.css 补回 6 条代码块样式
   上次为了注释掉 max-height 把单行压缩版手工展开，展开时整组丢了
   .content 下的 pre / code / kbd / pre code / pre ol / pre li，
   而未压缩的 kratos.css 里它们都在，源与产物从此不一致。
   表现是行内 code 与 kbd 没有样式（代码块因插件主题覆盖才没露馅）。
   改为用 clean-css 从 kratos.css 重新生成，不再手工维护产物。

2. 删掉 max-height / text-overflow 两条声明，而不是注释掉
   注释会被压缩器剥掉，产物里等于没改过。

3. 补上 Prism 代码高亮兜底（此前只存在于线上，仓库里没有）
   语言包路径改用 plugins_url() 动态生成，换域名或加 CDN 不会静默 404。

4. 主题更新元数据从独立子域名迁到主站 /theme-update/
   地址可用 wp-config.php 的 YANG_THEME_UPDATE_URL 覆盖，换域名不必改主题代码。

5. footer 的主题链接指向自建源库；补文档说明自动升级会覆盖主题目录、
   以及发布新版本必须"先打包再改版本号"的顺序。

6. 顺带去掉 .a-post .header .label 里重复声明的 position。
 2026-10-23 09:06:16 +08:00
杨永全 61d0111e0b 因chrome版本更新，导致其中.k-main .board .article-panel .a-post .header这个标签中的max-height: 25px;失效，因此注释掉。 2026-07-03 13:11:34 +00:00
杨永全 f7d6c7197a 之前的版权信息，是放在配置中的，copyright后面的年份无法根据年份自动更新，所以抛弃了这种做法，直接在页面上显示版权信息，并增加了年份的自动显示。同时，All Rights Reserved被更改为中文：版权所有。 2026-01-20 08:59:09 +00:00
laoyang e61c07e6b0 Update single.php 删除空格。 2022-07-21 11:11:13 +08:00
laoyang a0967fb7a9 Update single.php 删除一些空格。 2022-07-21 11:10:40 +08:00
laoyang 80ebf82fc8 Update single.php 删除了上一篇，下一篇，感觉没啥用，精简。 2022-07-21 11:09:54 +08:00
laoyang 48cbed483d Merge branch 'main' of https://git.yangyq.net/laoyang/wordpress-kratos-yang.git 2022-07-21 11:03:43 +08:00
laoyang a604cc28bd Update kratos.css 2022-07-21 11:03:26 +08:00
laoyang 04e8eb5278 修改了列表行高，看起来更舒服。 2022-07-16 17:20:49 +08:00
laoyang dbd78621ec 更改了列表样式。 2022-07-16 08:10:00 +08:00
laoyang f71fcc5daf 修改了自定义样式,用户不需要的可以删除. 2022-07-15 11:34:51 +08:00
laoyang 749dfde6f1 更改了h2标题样式 2022-07-15 11:32:30 +08:00
laoyang 9fd59758f2 抓取社交媒体分享时的函数报错，删除。 2022-07-13 17:50:35 +08:00
laoyang 316661e595 添加了和wpdiscuz冲突的解决方法说明 2022-06-29 13:09:08 +08:00
laoyang 4b4bd9d0b2 解决了升级到php8之后，写文章时的警告。详情：https://yangyq.net/2022/06/wordpress-warning-metaboxes-nonce.html 2022-06-20 11:08:26 +08:00
laoyang dd6f9bc85e 修改了说明文件。 2022-05-14 18:38:57 +08:00
laoyang 8aac62115a 修改了说明文件。 2022-05-14 18:36:38 +08:00
laoyang e04b253429 修改了说明。加入了预览网址。 2022-05-14 17:53:21 +08:00
laoyang 8aba7d7cc3 发现之前的代码，好像和原主题的代码混合在一起，因此，重新提交一份纯净的代码，这样也不再和之前的主题进行关联了。完全由我自己来维护。 2022-05-14 17:50:47 +08:00
杨永全 56a190e082 Update README.md 2022-05-14 08:45:36 +00:00
laoyang a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00
杨永全 b46e3d988f Initial commit 2022-01-07 03:11:56 +00:00