laoyang
37c52948c4
评论邮件重复的根因是发信源不止一个，分两层处理：一层管「谁发」，一层管「发几封」。 只做前者的话邮件照样重复，只是都从同一个 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 不溢出。
该项目是原kratos的一个分支。
本项目仓库地址：
https://code.yangyq.net/laoyang/wordpress-kratos-yang
因为我需要一些定制的功能，就fork出来一个新的分支，自己用。如果你对原有的主题开发也有不满意的地方，欢迎使用我的这个版本。当然，版权仍然是属于原主题。
主题预览：老杨说话的地方。
该仓库已同步到多个git托管平台，包括Github、Gitee、 Gitlab和阿里云Code。这些代码库都和源库保持一致和同步，在任何平台上关注都可以。
Github因为网络原因，同步会出现失败情况，无法保证最新。
主要修改的地方主要包括：
- 为移动端增加了侧边栏显示。之前的版本，在移动端无法看到最近评论，这个版本加入了这个功能。当然只是在首页，在文章页面，为了减少数据传输，仍然没有侧边栏。
- 文章聚合widget，将最新文章优先显示。原来的版本，是显示最热门文章，但是不知道什么原因，热点文章总是没几个，而且我认为，大部分人上来，应该时主要为了看最新文章的吧。
- 删除了配置页面中的关于主题，精简、精简、精简。
- 删除了资源托管选项，删除了媒体托管选项。
- 文章配置中，删除了文章版权信息，删除了网易云音乐。
- 删除了社交相关配置选项。
- 增加了在页脚显示国旗的选项。
修复Bug
- 如果使用了插件，会改变comment的div名称，class="comments" 变成了comments-area，因此，评论的样式不好用了。
此时，在主题的额外CSS中添加：
.k-main .details .comments-area {
margin-top: 16px;
padding: 1.6px 16px 16px;
border-radius: 2px;
background-color: #fff;
-webkit-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
-moz-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
}
.k-main .details .post-2 .comments-area {
-webkit-box-shadow: none;
-moz-box-shadow: none;
box-shadow: none;
}
就可以了。该问题属于和插件的冲突问题，因此，在额外CSS中添加，不修改主题本身。
代码块样式
主题的 assets/css/kratos.css 里有一组 .k-main .details .article .content 下的
pre / code / kbd / pre code / pre ol / pre li 规则，负责代码块与行内代码的底色和间距。
这六条曾经在压缩产物里整组丢失过：某次改动把单行压缩版 kratos.min.css 手工展开成可读格式，
展开时漏掉了这一整段，而原始未压缩的 kratos.css 里它们是齐全的，导致源与产物对不上。
表现是行内 code 与 kbd 没有样式（代码块因为插件 Prism 主题的覆盖才没露馅）。
改完 CSS 后请用压缩器重新生成产物，不要手工维护 kratos.min.css：
npx clean-css-cli@5.6.3 -o assets/css/kratos.min.css assets/css/kratos.css
主题自动更新
更新走的是一份静态 JSON + 一个 zip 包，由 inc/update-checker/（Plugin Update Checker 4.9）消费。
- 元数据地址：
https://yangyq.net/theme-update/update.json（定义在inc/theme-core.php，可用wp-config.php里的YANG_THEME_UPDATE_URL覆盖） - 发布目录：站点根下的
theme-update/，内容只有三样：
theme-update/update.json # 版本元数据
theme-update/kratos_yang.zip # 主题包，解压后是 kratos_yang/ 目录
theme-update/readme.html # 「详情」页，可省
update.json 格式（version 与 details_url 必填）：
{
"version": "3.3.0",
"details_url": "https://yangyq.net/theme-update/readme.html",
"download_url": "https://yangyq.net/theme-update/kratos_yang.zip"
}
发布新版本的顺序
先改 style.css 里的 Version，再打包，否则 WordPress 认为没有新版本，不会提示升级。
- 改
style.css的Version（例如 3.2.2 → 3.3.0） - 打包：
zip -r kratos_yang.zip kratos_yang -x "*.DS_Store" "*/.git/*" - 传
kratos_yang.zip到theme-update/ - 最后才改
update.json里的version
第 4 步放最后，是因为 WordPress 见到新版本号就会立刻允许升级； 若此时 zip 还是旧的，等于发了个指向旧包的更新，装完版本号没变（或者直接坏掉）。
⚠️ 自动升级会覆盖主题目录
WordPress 升级主题的做法是删掉整个 kratos_yang/ 再解压新包
（wp-admin/includes/class-theme-upgrader.php 里 clear_destination => true，
随后 delete_old_theme() 递归删除）。所以任何直接改在服务器主题目录里的东西都会丢，
包括手工打的补丁（例如曾经直接在 footer.php 里加的 Prism 脚本）。
自定义样式不再放主题目录。 早期版本有一个 custom/ 目录（custom.css /
custom.js / custom.php），是给用户随手加样式的入口，但它位于主题目录内，
每次升级都会被清空 —— 而且 custom.php 会被 require，等于允许在主题里执行任意
PHP 代码。该模块已在 3.2.2 移除，改为后台选项：
后台 → 主题选项 → 自定义代码 → 自定义 CSS / 自定义 JS
这两段内容存在数据库的 kratos 选项里，升级、重装、改主题目录名都不受影响。
它们分别在主题样式表和主题脚本之后加载，优先级最高。
几个要点：
- 不需要写
<style>/<script>标签，直接写 CSS / JS 内容 - 内容不会被当作 HTML 处理，
>、<、~、反斜杠转义（如content: "\f101"）都原样保留 - 想彻底清空，把框里内容删掉保存即可（空值会覆盖内置默认值）
- 点“恢复默认”会把「自定义 CSS」还原成主题自带的默认样式
换域名 / 退役旧域名
以前更新元数据放在独立子域名上，现在收进主站，省掉一个站点、一套证书和一份备案。 切换时注意：
- 先把
theme-update/部署到主站并确认update.json能直接访问（返回 JSON，不是 404 或首页） - 再发布带新地址的主题版本
- 旧版本的主题仍会去老地址拉更新，所以旧域名的
update.json要在确认所有站点都升级完之后才能下线