laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
36 Commits 1 Branch 0 Tags
ef9a58dc51fc6a9962e0bab07028d3d011a6bb5e
Commit Graph
4 Commits
Author SHA1 Message Date
laoyang ef9a58dc51 v3.2.13 图片选项全部自带默认图，新装站点不再出现空洞/破图 
根本原因：kratos_option() 运行时只读数据库，`std` 仅在后台表单预填和
「恢复默认」时生效，前台根本读不到。因此新装站点所有图片项都是空值。
另外 isset() 挡不住「用户清空」——of_sanitize_upload() 对空输入返回 ''，
键存在且值为空串，调用方传的兜底值被绕过。

同时不能把绝对 URL 写进 std：它会随保存一起写库，主题目录改名/换 CDN/
迁站后永久 404。本站 s_wechat_url / g_donate_alipay / g_donate_wechat
三项就指向已删除的 kratos-master 目录，一直在破图（这三项是 hidden 字段，
后台界面上看不到，所以坏了很久没人发现）。

做法：
- 新增 inc/theme-option-defaults.php，图片默认值注册表（11 项），
  默认图一律运行时给出，不写数据库。
- yang_option_image() 三层判断：空/纯空白 → 默认图；指向已不存在的主题
  目录 → 默认图；文件不存在则不输出地址（避免换来一个 404）。
- 陈旧判断用 get_template()（主题 slug）而非 basename(目录名)，避免本地
  开发目录名与 slug 不一致时误伤当前主题自己的图。
- 模板统一走取值函数：header（logo/favicon/banner）、footer（微信码/国旗）、
  404、index、article 缩略图、widgets 头像、page-toolbar、theme-core 赞赏码。
- 国旗与 favicon 的渲染抽成 yang_flag_block() / yang_favicon_tag()，
  空值时不输出空 src / 空 href。
- 后台 9 处 std 改为 yang_options_default_img()，与前台默认图同源；
  该包装函数自带 function_exists 防护，单独加载 theme-options.php 不会 Fatal。

新增图片（本地生成，合计 291KB）：default-404 / default-share /
default-empty / default-avatar / default-banner / default-flag / favicon.ico。
favicon 为 WordPress 风格自绘（品牌蓝圆底 + 白色 W），非站长个人专用那张。

验证：run_tests 146 条（新增第 4 组图片默认值 22+ 条）；falsify 35 条注入
全部能被抓住（新增 10 条）；verify_all.sh 14 组全绿。
 2026-10-23 19:50:07 +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 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 a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00