laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
84 Commits 1 Branch 0 Tags
cca7497553b14ae7939e81eeaac95439770c8d10
Commit Graph
8 Commits
Author SHA1 Message Date
laoyang 0a5486e195 3.2.57 新增「写作增强」：发布时自动生成别名/标签/分类/摘要 #25 
需求（工单 #25）：写文章时自动生成别名（翻译）、自动生成标签、
自动选择分类、自动生成摘要，问主题能不能做、是否必须用插件。
结论：主题自己就能做，不依赖任何插件。

新增 inc/theme-writing.php（四个独立引擎 + 设置读写 + 密钥处理）：

- 触发点：transition_post_status，且要求
  new_status === publish && old_status !== publish
  ⇒ 只在「第一次点发布」时动手，自动保存不触发，已发布的文章一概不碰。
- 幂等锁 _yang_writing_done：同一篇只做一次，避免反复覆写。

四道「不覆盖」守卫（用户逐条确认的决策）：
- 摘要：只在 post_excerpt 为空时才写。
- 分类：只在文章还挂默认分类（未分类）时才动。
- 别名：只在「空」或「不是纯 ASCII」时才生成。判据不是"空"而是
  "不是纯 ASCII" —— 中文标题下 WP 生成的是 %e4%bf%a1... 这种编码串，
  它非空但不可用。已有英文别名的 966 篇一概不动（别名=URL，改了
  就是成批 404）。
- 标签：wp_set_post_tags(..., true) 追加，绝不删除手工标签。

修一个真实产品 bug：3.2.56 及以前 apply() 里写的是
list($suggest, $_) = yang_writing_make_tags(...)，$new 被整个丢掉；
接着又拿 $suggest 去 get_term_by 二次分类 —— 而 $suggest 里每个词
都来自词典、必然全部命中 ⇒「新建」分支永远进不去 ⇒ 这条功能在真实
发布流程里一次都没生效过。改为 list($exist_hits, $new_cands)，
两段分别复核后合并。

标签两级策略（新博客也能用）：先匹配已有标签池，匹配不到才新建，
每篇新增数量受 w_tag_new_limit 约束（默认 3，设 0 = 永不新建）。

中文分词（服务器无 scws/jieba）：先按虚词与标点切短语，再在短语
内部取 2~6 字 n-gram。不切句直接取窗口会产出「星等换算与赤」
这类跨词碎片，且字面上"出现 ≥2 次"能通过所有频次闸门 —— 这是
n-gram 的固有缺陷，只能靠切分规避，调阈值无效。
虚词表统一由 yang_writing_seps() 提供（闸门④ 复用同一函数）。

翻译：默认 MyMemory（免注册），可选百度/有道。任何失败都返回空串
跳过该项，绝不阻塞发布。

密钥：存独立选项 yang_writing_secrets，不进 kratos；password 类型 +
std 空串；页面只显示末 4 位；留空提交 = 不修改。

设置页：新增「写作增强」独立 heading 标签页，四个开关默认全关
（升级不改变现有行为）。framework 里 'requires' 这个键根本没被读取，
条件显示改用 options-custom.js 显式逻辑；info 类型不生成 .section
包裹层，补一条 .section-info 规则才能藏住服务商申请说明。

验证（发布前）：
- 写作端到端 71 条、后台渲染 21 条、密钥路径 9 条，合计 101 条全过
- 反证 22 组（W1~W16 端到端 / A1~A6 后台）× R1~R14 发布包注入，
  全部让失败数从 0 增加
- 测试自身不污染：每节差分回滚 + 总闸门，标签库稳定 703 / 967 篇
- 发布走 theme-update/，主题目录仍是 3.2.56，未被覆盖
 2026-10-27 16:05:43 +08:00
laoyang e47bf37966 3.2.33 后台「主题设置」两栏顶边对齐 (#2) 
用户反馈：「左侧标签栏和右侧设置框两个也不一样高，有一个高度差，看着
很别扭。」经测量纠正：不是高度不一样，是**顶边**位置不同 —— 左栏白
卡片 top=53、右栏白卡片 top=63，差 10px，左边高、右边低。

根因不在主题里，在 WordPress 后台自己的样式：
  #wpbody-content .metabox-holder { padding-top: 10px }
这条是给「一路往下竖排的 metabox」留顶部间距用的。3.2.24 把标签列
float 到左边、变成两栏并排之后，这 10px 就没人跟它配对了：左栏
(h2.nav-tab-wrapper) 不带这层 padding，右栏 (#optionsframework-metabox)
还带着，于是右栏被压低 10px。

修法：两栏并排时把这 10px 清零。
  #optionsframework-wrap > #optionsframework-metabox { padding-top: 0 }
只在 @media (min-width: 960px) 里清 —— 窄屏仍是标签横排在上一路往下，
那 10px 是该留的间距，不动。

没有采用「给左栏补 10px」的凑齐改法：那样左栏卡片内部会多出一段看不
见的空白，标签整体下移，问题只是从「两栏错位」变成「左栏内部偏空」。

底边仍不齐（左栏 467 固定、右栏 366~1276 随标签变），这是另一个问题，
本轮按用户界定不做，等确认后另开一单。

验证：
- _geo333_top.py        18/0（三档宽屏顶边差 0px；逐标签切 11 次顶边不变；
                        窄屏 700px 仍保留那 10px）
- _geo333_top_falsify.py 7/0（删规则/写成10px/补左栏padding/挪出媒体查询/
                        额外 margin/等价重写 0→0px，六种注入全部红对地方）
- _pkgcheck333.py       77/0 · _pkgcheck333_falsify.py 10/0
                        （C5 抓出真盲点：'float: left' in css 会命中别处，
                         判据改为锚在左栏块内部）
- 回归全绿：_admin330_tab_check 88/0 · _admin328_check 13/0 · _guard330 63/0
            _toc330_logic 101/0 · _test_toc 53/0 · _geo330_rail 73/0
            _geo331_inline 23/0，及对应六组 falsify 全部变红且红对地方
- 公网核验：md5 319d098f2fa5c5fb2764f25b8d55936c 本地/下载一致；
            包内 Version=3.2.33；padding-top:0 出现 1 次且在 960 媒体查询内；
            readme 24 条版本标题、历史 23 条全保留、ul/li/b/code 全配平
 2026-10-25 15:36:55 +08:00
laoyang 6f51d50a58 3.2.30: 文章目录进后台（新增「自动目录」标签页）—— 位置/插入点/默认展开可配，手写 [TOC] 永远优先 
后台「主题设置」新增第 5 个标签页「自动目录」，7 个选项：
  目录位置   正文中间 / 页面左侧（浮动）/ 页面右侧（浮动）
  添加方式   手动（只认 [TOC]）/ 自动
  自动插入位置  文章开头 / 第一个 H1、H2 之前 / 文章结尾
  默认状态   默认显示 / 默认隐藏
  另外：目录标题、收录层级（H1~H4）、是否显示序号

设计要点：
- 插入方式拆成 toc_mode(manual/auto) x toc_anchor(start/first/end) 两个正交
  字段，不合成一个四值下拉：侧栏模式下插入位置毫无意义，合并会产生歧义。
- 手写 [TOC] 绝对优先：yang_toc_plan() 里 $has_marker 最先返回，inline_at
  ='marker' 且 rail=false —— 否则同一篇会出现两份目录，老文章升级后突然多
  出一个目录。这条是刻意守住的。
- 纯函数 + 薄壳分层：normalize_settings / plan / inject / build_list 全部不查库，
  单进程可喂几十种组合；settings() 只负责读库 + 调纯函数 + static 缓存。
- <details open> 是唯一可靠的「默认收起」手段：展开态不接受 CSS 覆盖，只能
  由 open 属性决定，所以隐藏时必须不输出该属性。
- 侧栏收起态必须 translateX(±100%) 完全移出视口：只做 opacity 会让透明面板
  留在原位吃掉正文点击（探针 elementFromPoint 才抓得到）。
- yang_toc_rail_ready() 开关：侧栏在 wp_footer 输出，那时正文可能没走
  the_content（缓存插件/OEmbed），标题没 id ⇒ 侧栏链接全跳不动却看起来正常。
  宁可不出侧栏。
- 后台联动隐藏「插入位置」不用 jQuery show()/hide()：会把 .section 的行内
  display 写成 block，悄悄回退 3.2.28 的 display:flow-root BFC 修复。改用
  class + display:none!important。

验证（全部在本轮重跑）：
  _test_toc.php       53/0   旧 TOC 行为回归
  _toc330_logic.php   88/0   逻辑判据
  _toc330_falsify     13/13  注入全变红且红对地方
  _geo330_rail.js     73/0   侧栏真实几何（左/右 x 展开/收起 x 宽窄屏）
  _geo330_falsify     8/8
  _guard330.php       46/0   后台控件与运行时默认值双向一致
  _guard330_falsify   8/8
  _admin330_tab_check 36/0   新标签页几何 + 联动 + 载入态
  _admin330_falsify   8/8
  _admin328_check     13/0   3.2.28 布局回归

发布：只发 zip + readme + update.json 到 theme-update/，不动服务器主题目录，
用户在 WP 后台自行升级（沿用 3.2.24 起的策略）。
 2026-10-25 12:18:52 +08:00
laoyang 420434aacf 3.2.28: 修后台设置页第一个配置项后面的大块空白（.section 建独立 BFC，不再被左侧浮动标签列的 clear:both 拉长到标签列等高；真实渲染实测 405px→93px） 2026-10-25 10:13:44 +08:00
laoyang 92ffced7cf 3.2.26: 评论布局重排（姓名/时间垂直居中于头像、正文全宽下移 10px，锚点黄底不再压作者徽章）；引导线与子块留 8px 空隙并与缩进同源（--yq-my-indent）；修深层缩进晚一层生效的存量 bug；后台设置页标题 margin 收编（项间空白 42→22px） 2026-10-24 23:58:55 +08:00
laoyang fd27b4d218 3.2.24: 评论富文本工具条（B/I/颜色/表情移入）+ kses 放行 span+style + 后台设置页标签左列竖排重排 2026-10-24 21:59:06 +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 a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00