Files
wordpress-kratos-yang/inc
laoyang c1dde099d7 「个人简介」挂件:头像/昵称/简介/背景四项可单独填 + 修大图撑爆 #21
一、头像 / 昵称 / 简介原来**只读主题设置**,挂件表单里没有字段
  · 用户点开侧栏「个人简介」只能改背景图,头像和那句话得跑去
    「主题设置 → 站长信息」改全站共用的那份。
  · 现在四项都是挂件实例字段:avatar / nickname / introduce / background。
  · 取值顺序:实例 → 主题设置 → 内置兜底,**留空即回落**,
    老站点升级后显示一点不变。
  · pick() 判空统一用「trim 后是不是空串」,不用 empty()
    (!empty('0') 是 false,昵称就叫「0」会被当没填)。
  · 简介用 sanitize_textarea_field(保留换行),URL 用 esc_url_raw
    (不做 HTML 实体化,避免与 esc_attr 双重转义)。

二、后台 form() 补齐五个字段
  · 头像 / 背景各带「选择图片」按钮(调媒体库),背景另有「清除」。
  · 输入框显示用户填的原始值,缩略图显示前台最终会用的那张,刻意分开。
  · 资源加载统一到 yang_widget_admin_assets(),不再每个挂件各挂一次。

三、大图撑爆挂件的真因:CSS 选择器依赖三层祖先
  · 老规则是 `.k-main .sidebar .w-about .wrapper img`,而后台
    「外观 → 小工具」预览里没有 `.k-main .sidebar` 这层祖先,
    规则一条都不生效 ⇒ 头像按原图 2136×2136 铺开、背景塌成 0。
    前台看着正常是因为前台恰好有那层祖先,问题被完全掩盖。
  · 改为只管 `.w-about` 内部元素,并补 max-width/max-height 双保险。
  · 老规则必须**删掉**而不是并存:它是 (0,3,1),新规则是 (0,2,1),
    并存时老规则在前台永远赢,新规则只对后台生效。
  · 保留 `.k-main .sidebar .w-about { padding:0 }`:通用规则
    `.k-main .sidebar .widget` 是 (0,3,0),少了这条会多出内边距、整体高 57px。
  · 头像保持 inline(display:block 会让它脱离 text-align:center 的居中)。
  · 顺带:object-fit 从 fill 改 cover(超宽图不再压扁);
    背景 url() 补引号(文件名带空格时不再整条声明作废)。

验证
  · 行为测试 67 条全通过;反向验证 13 组全部真红。
  · 浏览器几何 76 条全通过(前台/后台 × 四种极端原图)。
  · 修复前 CSS 跑同一套判据:38 条报红,精确复现用户症状
    (后台挂件高 2217、头像 2136×2136、横向滚动 2146)。
  · 线上真实页面 + 新版 CSS:16 条全通过。
2026-10-26 23:51:20 +08:00
..