laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
94 Commits 1 Branch 0 Tags
ba1245191c0aa06055b80a6c7954c2a8798ed529
Commit Graph
8 Commits
Author SHA1 Message Date
laoyang c058ecc827 4.2.0 控制台标识改为 Kratos Yang + 当前版本号，版本号只剩一份真源 #35 
原来控制台打印 "Kratos v3.1.8"，硬编码在 assets/js/kratos.js 的
KRATOS_VERSION 变量里，只在 consoleConfig() 用一次。版本号的真源本来
就在 PHP 侧（functions.php 的 THEME_VERSION，读 style.css 的 Version:），
JS 里再存一份副本必然漂移 —— 主题已到 4.x，那里还停在 3.1.8，
用户在控制台看到的版本号落后 9 个小版本。

改法不是把 3.1.8 换成 4.2.0（下个版本还得再改一次），而是删掉这份副本：
inc/theme-core.php 的 wp_localize_script $data 数组里加 'version' => THEME_VERSION，
JS 从 window.kratos.version 取。wp_localize_script 在脚本标签之前注入，
所以 kratos.min.js 执行时它已经存在。

kratos.min.js 无构建脚本、是手工压缩产物，同步改了里面的字面量。
取不到版本号时只打印 "Kratos Yang"，不凭空补默认值 —— 后台预览、
维护页等没走 wp_enqueue_scripts 的场景不该在控制台报错。

判据三层：
- _console421_check.py        23/0（静态两份 JS + PHP 注入 + node vm 真跑 min.js）
- _console421_falsify.py      6/6（含"只改源码不重压"、"硬编码成本版号"）
- _console421_meta_falsify.py 5/5（判据恒绿/恒红/inject 假成功/不还原/删判据）
 2026-10-28 18:23:36 +08:00
laoyang 677de0f24e 3.2.29: 把「自定义 CSS」里的站点样式并入主题公共样式 assets/css/site.css（段落缩进/h2 蓝条/列表缩进与行距），配置项默认置空并一次性清库迁移；自定义 CSS 内联输出改挂 kratos-site 以保持在最末 2026-10-25 10:36:29 +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 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 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 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 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
laoyang a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00