删除目录「.zcode/plans」
This commit is contained in:
@@ -1,60 +0,0 @@
|
|||||||
# 用户公开主页通知按钮改为纯图标+未读角标
|
|
||||||
|
|
||||||
## 现状
|
|
||||||
- 目标按钮: `templates/parts/user/author-hero.php:144-149`(仅 `$is_own` 查看自己主页时输出),当前为铃铛图标 + "消息" 文字,无角标。
|
|
||||||
- 参照实现: 用户中心头部 `inc/helpers/user-center-renderers/profile-header.php:87-94` — `btn-ghost btn-sm btn-icon` 纯图标按钮,带 `aria-label`/`title`,未读数 > 0 时输出角标 `<span class="uc-header__action-badge">N</span>`(不封顶 99)。
|
|
||||||
- 未读数函数: `aksrt_get_user_unread_notification_count($user_id)`(`inc/modules/user-notifications.php:387`),模块经 `inc/bootstrap.php:78` 无条件加载,可直接调用。
|
|
||||||
- hero 卡片仅由 `page-user-home.php` 服务端静态渲染一次(DOM 无刷新只作用于 tab 面板),角标为静态服务端渲染,与用户中心行为一致。
|
|
||||||
- `.btn-icon` / `.btn-icon.btn-sm` 样式已存在于 `assets/css/core/buttons.css:129-136`,全局可用;但 `.uc-header__action-badge` 样式在 user-center 路由 CSS 中,不会在公开主页加载,需在 `assets/css/routes/user-home.css`(该页直接入队,无构建步骤)新增。
|
|
||||||
|
|
||||||
## 修改内容
|
|
||||||
|
|
||||||
### 1. `templates/parts/user/author-hero.php`
|
|
||||||
- 在第 58 行 `$messages_url` 之后新增:
|
|
||||||
```php
|
|
||||||
$unread_count = $is_own ? aksrt_get_user_unread_notification_count($user_id) : 0;
|
|
||||||
```
|
|
||||||
- 将消息按钮(144-149 行)整体替换为与用户中心一致的纯图标形式,类名沿用本文件 BEM 前缀:
|
|
||||||
```php
|
|
||||||
<a href="..." class="btn-ghost btn-sm btn-icon aksrt-author-hero__message-btn" aria-label="消息通知" title="消息通知">
|
|
||||||
<i class="fa fas fa-bell" aria-hidden="true"></i>
|
|
||||||
<?php if ($unread_count > 0) : ?>
|
|
||||||
<span class="aksrt-author-hero__action-badge"><?php echo esc_html((string) $unread_count); ?></span>
|
|
||||||
<?php endif; ?>
|
|
||||||
</a>
|
|
||||||
```
|
|
||||||
- 删除原 `<span>消息</span>` 文字输出,不保留旧结构。
|
|
||||||
|
|
||||||
### 2. `assets/css/routes/user-home.css`
|
|
||||||
在 `.aksrt-author-hero__follow-btn` 样式附近(约 167 行后)新增,视觉与用户中心角标(`user-center/shell.css:136-157`)完全一致:
|
|
||||||
```css
|
|
||||||
.aksrt-author-hero__message-btn {
|
|
||||||
position: relative;
|
|
||||||
}
|
|
||||||
|
|
||||||
.aksrt-author-hero__action-badge {
|
|
||||||
position: absolute;
|
|
||||||
top: -5px;
|
|
||||||
right: -5px;
|
|
||||||
display: inline-flex;
|
|
||||||
align-items: center;
|
|
||||||
justify-content: center;
|
|
||||||
min-width: 16px;
|
|
||||||
height: 16px;
|
|
||||||
margin: 0;
|
|
||||||
padding: 0 4px;
|
|
||||||
border-radius: 999px;
|
|
||||||
background: var(--color-error, #ef4444);
|
|
||||||
color: #fff;
|
|
||||||
font-size: 11px;
|
|
||||||
font-weight: 700;
|
|
||||||
line-height: 1;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
- `php -l templates/parts/user/author-hero.php`
|
|
||||||
- 运行 `node --test tests/widget-system/page-display-contract.test.cjs tests/widget-system/post-visual-contract.test.cjs`(已确认两者均未断言该按钮标记,应保持通过)
|
|
||||||
- 桌面/移动端检查: 图标按钮为 28px 方形(`.btn-icon.btn-sm`),角标绝对定位右上角,移动端居中布局不受影响(角标不占布局空间)
|
|
||||||
|
|
||||||
不写 function_exists 兜底、不保留文字版本、不添加迁移逻辑。
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
修复文章详情页分割线右侧三点图标不居中的问题
|
|
||||||
|
|
||||||
## 根因
|
|
||||||
|
|
||||||
三点按钮（`inc/helpers/aksrt-single-components.php:131-146`）为 `<button class="but cir post-drop-meta__toggle"><i class="fa fas fa-ellipsis-h"></i></button>`，位于 `templates/parts/single-author-bar.php` 中 `.single-meta-row` 分割线右端。`.but.cir` 是 `inline-flex; justify-content: center`，flex 居中的是子元素的 margin box。`assets/css/core/buttons.css` 中存在特异性冲突：
|
|
||||||
|
|
||||||
- 第 183 行 `.but > i[class*="fa-"]:not(.fa-angle-right) { margin-right: 0.25em; }` 特异性 (0,3,1)
|
|
||||||
- 第 225 行 `.but.cir > .fa { margin: 0; }`（本意的重置规则）特异性 (0,3,0)，被压掉
|
|
||||||
|
|
||||||
导致图标右侧残留 0.25em 外边距（15px 字号下约 3.75px），三点整体左偏约 1.9px。这是全局 bug，所有 `.but.cir` 图标按钮都受影响。
|
|
||||||
|
|
||||||
## 修改内容
|
|
||||||
|
|
||||||
1. **`assets/css/core/buttons.css:224-225`** — 加强重置规则的特异性到 (0,4,0)，稳定压过 (0,3,1) 的 margin 规则（不依赖源码顺序）：
|
|
||||||
```css
|
|
||||||
.but.cir svg.icon,
|
|
||||||
.but.cir > .fa,
|
|
||||||
.but.cir > .fa:not(.fa-angle-right),
|
|
||||||
.but.cir > i[class*="fa-"]:not(.fa-angle-right) { margin: 0; }
|
|
||||||
```
|
|
||||||
附一行注释说明 `:not()` 变体是为压过 `.but > i[class*="fa-"]:not(.fa-angle-right)` 的 margin 规则。保留原 `.but.cir > .fa` 选择器以继续覆盖 fa-angle-right 图标。不改 main.css（旧的手工捆绑副本）：public 捆绑包中 core/buttons.css 副本排在 main.min.css 之后，高特异性重置必然胜出。
|
|
||||||
|
|
||||||
2. **重建捆绑包** — 运行 `node tools/build-public-assets.mjs`（esbuild 已就绪），重新生成 `assets/css/build/public.css/.min.css` 等捆绑文件。
|
|
||||||
|
|
||||||
3. **新增契约测试** `tests/widget-system/circular-button-icon-margin-contract.test.cjs`：断言源文件 buttons.css 与构建产物 public.min.css 中包含加强后的重置选择器（防止特异性回归），沿用现有 `*.test.cjs` 契约测试模式。
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
|
|
||||||
- `node --test tests/widget-system/circular-button-icon-margin-contract.test.cjs` 通过
|
|
||||||
- 在构建后的 `public.min.css` 中确认重置规则存在且位于 margin 规则之后
|
|
||||||
- 刷新文章详情页目视确认三点图标在圆形按钮内水平居中（同时全站其他 `.but.cir` 图标按钮居中恢复正常）
|
|
||||||
@@ -1,163 +0,0 @@
|
|||||||
## 目标与边界
|
|
||||||
|
|
||||||
将“全局功能 → Email邮件”收敛为一套真正可用的邮件系统：后台完整展示 SMTP、发件品牌、认证/账号、内容互动、审核、私信、身份/账号处理、举报，以及订单、支付、提现、返佣、分成、转账等商城/资金类邮件；模板主题和正文默认直接显示，不再用空值加 placeholder 代替；所有真实发送统一由同一服务渲染和发送。
|
|
||||||
|
|
||||||
明确排除：
|
|
||||||
|
|
||||||
- 不实现论坛、版主、论坛帖子审核、回答采纳等论坛专属邮件。
|
|
||||||
- 不实现邮箱回滚、撤销链接、回滚令牌或旧邮箱恢复流程；邮箱变更邮件只做安全通知。
|
|
||||||
- 不做旧 option 的数据迁移，不保留新旧双路，不写兼容 adapter。
|
|
||||||
- 不做浏览器或真实视觉验收，只做代码、契约、语法和构建验证。
|
|
||||||
|
|
||||||
## 1. 建立唯一邮件配置与模板目录
|
|
||||||
|
|
||||||
- 以 `aksrt_settings` 的 Email section 作为唯一配置来源；SMTP、品牌、通知开关和模板都通过 `/settings/schema/global/email` 读写。
|
|
||||||
- 在邮件域建立集中式模板目录，统一声明每个非论坛事件的事件键、后台名称、默认开关、默认主题、默认 HTML 正文、占位符及说明。
|
|
||||||
- 邮件运行时和后台 Schema 均从该目录生成，避免默认文案继续散落在业务调用点。
|
|
||||||
- 对每个事件同时声明“开关、主题模板、正文模板”；模板正文在后台直接显示为非空默认值。数据库中已有空主题/正文时，仅在读取响应和表单初始化时解析为目录默认值，不执行迁移。
|
|
||||||
- HTML 模板和 `mail_more_content` 使用 `wp_kses_post()` 清理；主题、SMTP host/username/name 等按文本清理；邮箱地址使用 `sanitize_email()`；端口限制到合法范围；加密方式只允许 `ssl`、`tls` 或空值；SMTP 密码使用 secret 掩码/清除机制。
|
|
||||||
|
|
||||||
## 2. 完整重做 Email 后台 Schema
|
|
||||||
|
|
||||||
在 `src/Admin/Schema/GlobalSchema.php` 中由集中目录生成 Email section；让 `SchemaPage.vue` 对 `global.email` 使用服务端 Schema，删除前端重复的静态 Email schema 定义，避免 PHP/JS 两份字段漂移。
|
|
||||||
|
|
||||||
页面分组与事件如下：
|
|
||||||
|
|
||||||
1. **管理员邮件推送**
|
|
||||||
- 友情链接提交
|
|
||||||
- 新订单
|
|
||||||
- 提现申请
|
|
||||||
- 投稿待审核
|
|
||||||
- 身份认证申请
|
|
||||||
- 账号封禁申诉
|
|
||||||
- 举报提交
|
|
||||||
|
|
||||||
2. **用户邮件推送**
|
|
||||||
- 注册验证码
|
|
||||||
- 注册成功
|
|
||||||
- 免密登录验证码
|
|
||||||
- 密码重置验证码
|
|
||||||
- 邮箱/敏感操作验证码
|
|
||||||
- 邮箱变更安全通知
|
|
||||||
- 新订单/支付结果
|
|
||||||
- 提现处理结果
|
|
||||||
- 返佣到账
|
|
||||||
- 创作分成到账
|
|
||||||
- 收到积分/余额转账
|
|
||||||
- 评论通过审核
|
|
||||||
- 评论回复
|
|
||||||
- 投稿发布/驳回结果
|
|
||||||
- 手机号修改通知
|
|
||||||
- 身份认证审核结果
|
|
||||||
- 账号封禁/解封通知
|
|
||||||
- 举报处理结果
|
|
||||||
- 私信通知
|
|
||||||
- 私信邮件用户组限制
|
|
||||||
- 所有用户
|
|
||||||
- 所有会员
|
|
||||||
- 二级会员及以上
|
|
||||||
- 仅管理员
|
|
||||||
|
|
||||||
3. **自定义发件人/品牌**
|
|
||||||
- `mail_showname`，默认站点名
|
|
||||||
- `mail_title_prefix`，默认 `[站点名]`
|
|
||||||
- `mail_description`，默认“此信为系统邮件，请不要直接回复。”
|
|
||||||
- `mail_more_content`，默认显示“访问网站 / 联系站长”等基础 HTML 链接
|
|
||||||
|
|
||||||
4. **SMTP 配置**（沿用参考主题语义，但使用当前主题唯一字段契约）
|
|
||||||
- `mail_smtps`
|
|
||||||
- `mail_name`
|
|
||||||
- `mail_passwd`
|
|
||||||
- `mail_smtp_name`
|
|
||||||
- `mail_host`
|
|
||||||
- `mail_port`
|
|
||||||
- `mail_smtpauth`
|
|
||||||
- `mail_smtpsecure`
|
|
||||||
- SMTP 风险提示和依赖显示
|
|
||||||
|
|
||||||
5. **测试邮件**
|
|
||||||
- Email 页面内提供测试收件地址和发送操作。
|
|
||||||
- 有未保存修改时禁止测试并提示先保存，确保测试当前生效配置。
|
|
||||||
- 测试邮件走统一 HTML 包装、品牌和 SMTP 主线。
|
|
||||||
|
|
||||||
每个事件组直接显示“启用开关 + 主题模板 + HTML 正文模板 + 可用占位符说明”。论坛事件不进入 Schema、模板目录、默认值或运行时注册。
|
|
||||||
|
|
||||||
## 3. 实现参考主题式统一邮件渲染
|
|
||||||
|
|
||||||
重构 `src/Settings/Mail.php` 和 `inc/core-hooks/part-2.php`：
|
|
||||||
|
|
||||||
- 集中服务完成事件查询、开关判断、占位符替换、主题前缀、HTML 安全处理、品牌包装和 `wp_mail()` 调用。
|
|
||||||
- 复刻参考主题邮件信封：站点 Logo、主体内容、站点名称、底部说明、附加链接及现有 `assets/img/mail-bg.png` 背景图。
|
|
||||||
- 主题前缀只添加一次，并清除 WordPress 默认重复 `[站点名]` 前缀。
|
|
||||||
- 发件人名称保留明确优先级：`mail_showname` → 站点名；SMTP 发件地址和 SMTPAuth 使用同一 Email section 的 `mail_*` 字段。
|
|
||||||
- 将 `send_event_email()` 统一为事件键、收件人、占位符（必要时允许结构化上下文），默认模板不再由调用方重复传入。
|
|
||||||
- 未知事件失败关闭；无效收件地址不发送；事件关闭时不发送。
|
|
||||||
- 统一管理员收件人获取、去重和有效邮箱过滤。
|
|
||||||
|
|
||||||
## 4. 接通所有非论坛真实业务发送点
|
|
||||||
|
|
||||||
新增聚合通知注册类，基于当前主题已有 WordPress/AKSRT action 注册邮件发送；不凭空添加论坛功能。每个事件都复用集中模板目录和统一发送服务。
|
|
||||||
|
|
||||||
### 认证与账号
|
|
||||||
|
|
||||||
- 改造 `UserControllerAuthPhoneOperations.php`：注册验证码、免密登录验证码、密码重置验证码按独立事件发送；失败时删除验证码 transient，维持现有频率限制和安全行为。
|
|
||||||
- 注册成功在用户创建成功且用户对象有效时发送，提供用户名、站点名、个人中心/站点链接等占位符。
|
|
||||||
- 改造 `account-ajax.php`：敏感操作验证码、邮箱变更通知走统一服务；删除直接 `wp_mail()` fallback；不增加邮箱回滚。
|
|
||||||
- 手机号绑定/换绑成功后向有效邮箱发送通知。
|
|
||||||
|
|
||||||
### 内容互动与审核
|
|
||||||
|
|
||||||
- 评论通过审核、评论回复：接入 WordPress 评论状态/回复钩子，避免重复状态流转、自己回复自己和无效邮箱。
|
|
||||||
- 投稿待审核与发布/驳回结果：接入现有 `aksrt_new_posts_pending` 与文章状态转换，只处理当前主题实际支持的投稿内容，防止重复通知。
|
|
||||||
- 友情链接提交：接入当前友情链接写入成功动作，向有效管理员邮箱发送。
|
|
||||||
|
|
||||||
### 身份、账号、举报和私信
|
|
||||||
|
|
||||||
- 身份认证申请/审核、封禁申诉/处理、举报提交/处理：接入现有成功动作；若成功路径缺少动作，只在事务成功点增加明确的 `aksrt_*` action。
|
|
||||||
- 私信通知：接入现有消息/通知主线，只处理 private 类型；实现参考主题的用户组限制，并过滤无效或占位邮箱。
|
|
||||||
|
|
||||||
### 订单与资金业务（保留）
|
|
||||||
|
|
||||||
- 订单创建/支付成功/支付失败或状态变化：接入当前支付订单状态 action，分别通知管理员、买家及适用的订单关联用户。
|
|
||||||
- 提现申请与处理结果：接入当前提现申请、审核/完成/拒绝路径，通知管理员和申请用户。
|
|
||||||
- 返佣通知：接入当前 referral/佣金到账 action，向推荐人发送订单和佣金信息。
|
|
||||||
- 创作分成通知：接入当前 ledger/收益分配成功 action，向分成作者发送到账明细。
|
|
||||||
- 积分/余额转账通知：接入当前资产转账完成 action，向收款用户发送转账信息。
|
|
||||||
- 上述商城/资金事件只使用仓库中已存在的订单、支付、ledger、referral、资产动作和数据结构；若某事件没有可直接监听的成功动作，在对应现有事务完成点补充 action，不复制业务逻辑、不新建第二套交易流程。
|
|
||||||
|
|
||||||
论坛/版主/回答采纳动作不注册任何邮件监听器，也不产生对应模板字段。
|
|
||||||
|
|
||||||
## 5. 删除旧接口、旧存储与绕路代码
|
|
||||||
|
|
||||||
- 删除 `GlobalController` 的 `/settings/mail` 路由和 `rest_handle_mail()`，不再使用 `aksrt_mail_config`。
|
|
||||||
- 保留 `/mail/test` 作为动作接口，但重写为统一邮件服务测试；配置读写只有 Schema 路由。
|
|
||||||
- 删除前端 `getMailSettings()` / `saveMailSettings()`，只保留测试邮件 API 方法。
|
|
||||||
- 删除 `UserController` 的 `/settings/mail-templates` 路由、`handle_mail_templates()` 和 `aksrt_mail_templates` 契约。
|
|
||||||
- 删除 `Settings::get_smtp()` 对 `aksrt_mail_smtp` 的读取，并从 standalone/secret option 注册表移除该旧 option；SMTP 只读 Email section 的统一字段。
|
|
||||||
- 删除认证、账号和各业务模块中邮件服务不存在时的直接 `wp_mail()` fallback；正常业务只允许集中邮件服务内部调用 `wp_mail()`。
|
|
||||||
- 删除旧六事件空模板回退参数、重复前端 Email Schema 及不再使用的旧字段；不读取、不转换旧 option 值。
|
|
||||||
- 不删除数据库中的旧 option 值，但代码完全停止消费它们；不执行迁移脚本或双写。
|
|
||||||
|
|
||||||
## 6. 契约测试与构建验证
|
|
||||||
|
|
||||||
新增邮件系统契约测试/harness，覆盖：
|
|
||||||
|
|
||||||
- 后端 Email Schema 包含认证、账号、内容互动、审核、私信、身份/账号处理、举报、订单、支付、提现、返佣、分成、转账等事件。
|
|
||||||
- Schema 明确不包含 `bbs`、moderator、answer-adopted 及其它论坛字段。
|
|
||||||
- 每个主题和正文默认值非空；空存储读取时后台仍返回可见模板；模板占位符替换后无未知占位符。
|
|
||||||
- HTML 邮件信封包含品牌说明、附加内容、Logo 和背景图；主题前缀不重复；发件人和 SMTP 字段优先级稳定。
|
|
||||||
- SMTP 开关、认证、host、port、encryption、secret 掩码/清除行为正确。
|
|
||||||
- 事件关闭、未知事件、无效收件地址均不发送。
|
|
||||||
- 注册/登录/重置/邮箱变更路径不再绕过集中服务，发送失败时验证码缓存处理正确；不出现邮箱回滚入口或令牌。
|
|
||||||
- 评论、投稿、友情链接、身份认证、封禁、举报、私信及所有订单/资金事件分别绑定真实 action，并覆盖去重、无效邮箱和边界条件。
|
|
||||||
- 论坛事件不注册、不发送、不出现在后台；订单/支付/提现/返佣/分成/转账事件必须存在并可配置。
|
|
||||||
- 旧 `/settings/mail`、`/settings/mail-templates`、`aksrt_mail_config`、`aksrt_mail_templates`、`aksrt_mail_smtp` 和旧前端 API 不再存在。
|
|
||||||
- 全仓库业务代码中的 `wp_mail()` 只剩集中邮件服务内部调用。
|
|
||||||
|
|
||||||
执行验证：
|
|
||||||
|
|
||||||
1. 对所有变更 PHP 文件运行 `php -l`。
|
|
||||||
2. 运行新增邮件契约测试及受影响的 admin/UI 契约测试。
|
|
||||||
3. 在 `assets/admin` 执行 `npm run build`，由 Vite 清理旧 chunk 并更新完整 `assets/admin/build/`。
|
|
||||||
4. 使用 `rg` 做最终静态检查：无论坛邮件字段、无旧 option/API、无散落直接 `wp_mail()`，且订单/支付/提现/返佣/分成/转账事件均有 Schema、模板目录和发送入口。
|
|
||||||
5. 不启动浏览器、不截图、不做真实视觉效果验收。
|
|
||||||
@@ -1,56 +0,0 @@
|
|||||||
## 目标与口径
|
|
||||||
|
|
||||||
将 AKSRT 小工具系统中 12 个小工具对照 Zibll(仅参考"(新)"模块,忽略一切"旧版即将删除")做全量 1:1 复刻:后台配置项(字段、类型、选项、默认值、依赖、min/max/step、分组小标题)与前端 DOM/样式/状态全部对齐参考主题。已确认口径:
|
|
||||||
- **专题全部移除**:本项目无 topics 分类法,12 个小工具范围内所有"专题限制"字段与 `PostQuery` 的 topics 查询分支一并删除,测试同步更新。
|
|
||||||
- **修正参考源码明显 bug 的文案**(如排序 label 颠倒、最近评论 style 默认值 'card' 不在选项中),数据值与行为保持一致。
|
|
||||||
- **省略 AKSRT 无法支撑的排序选项**(销售价格/积分售价/销售数量),排序值域 = views/like/comment_count/favorite/modified/date/rand。
|
|
||||||
- **新增"搜索式多选+拖拽排序"分类选择字段**(terms 类型)。
|
|
||||||
- 不写双路/迁移;清理被替换的死代码;不做 Docker 视觉验收;不改 37 个 slug 与 REST 路由形态。
|
|
||||||
|
|
||||||
## 复用基础(已核实)
|
|
||||||
|
|
||||||
- 文章 item DOM 契约已在 `inc/helpers/posts-renderer/markup.php`(posts-item/posts-mini/badges/meta,9.0 契约);`main.css` 已含 `.zci-*`、`.zps-*`、`.graphic*` 等 Zibll 同款 CSS(76 处命中);`frontend.css:179-228` 已有 tab/slider 的 Zibll 契约块;runtime `main.js` 已有 `.swiper-scroll`/`.new-swiper` 初始化。复刻 = 补齐缺失部分并对齐 markup,而非从零移植。
|
|
||||||
- 前次复刻先例:tab_posts/slider/buttons/notice 走 `FrontendRenderer` "特殊壳"路径(before_widget + reference_title + 内容自闭环),本次 12 个中需要 Zibll 壳的一并加入该列表。
|
|
||||||
|
|
||||||
## 实施步骤
|
|
||||||
|
|
||||||
### Phase A 基础设施
|
|
||||||
1. `FieldSchema.php`/`FormRenderer.php`:新增 `terms` 字段类型(动态 get_terms 分类选项、搜索过滤、拖拽排序、按选择顺序保存 int 数组;支持 taxonomy 参数以供合作伙伴的链接分类复用);spinner/slider 渲染 `unit` 后缀(此前 unit 是死键)。
|
|
||||||
2. `PostQuery.php`:删除 topics 分支;tabs 段支持 `zibpay_type`(数组,沿用 apply_pay_type 映射 1/2/5/6);orderby 值域与 allowlist 对齐。
|
|
||||||
3. `PostRenderer.php`:分页三态对齐 Zibll —— `''`→隐藏 `.ajax-pag.hide` 占位、`ajax`→"加载更多" `.ajax-pag .next-page.ajax-next`、`number`→`.pagenav.ajax-pag` 数字页码(全部带 `ajaxpager-target=".widget-ajaxpager"` 契约,REST 数据属性保留);`mini_opt` 应用于 posts;热榜从通用分支拆出专用渲染。
|
|
||||||
4. `FrontendRenderer.php`:特殊壳列表加入 `posts, oneline_posts, hot_posts, term_cards, term_aggregation, media_cards, combo_info, partners, recent_comments, posts_toc`。
|
|
||||||
5. `frontend.js`:移植/新增 ①IAS IntersectionObserver 懒加载(列表 `load_mode=ajax` 与加载更多自动触发,替代 Zibll lazysizes ias);②合作伙伴滚动初始化(测量 seed 组宽→克隆→`--zps-duration`,resize 重算,Zibll main.js:4204-4296);③幻灯片组合卡 footer 重算 `--cover-ratio`(widget-slider.php:848-875);④目录树逻辑(section-navs 移植:h1-h4 抓取、排除 `.item-heading`/`.no-nav`、`wznav_{i}`、scrollspy offset 105、>380px 折叠、hash 定位);保持 role=status/aria-busy/reduced-motion a11y 契约。
|
|
||||||
6. `admin.js`/`admin-core.js`/`admin.css`:terms 字段交互(搜索、拖拽排序、选序同步)。
|
|
||||||
|
|
||||||
### Phase B 逐个小工具(schema+render+CSS+JS+空态,均以参考文件为准逐字段移植)
|
|
||||||
|
|
||||||
| # | AKSRT slug | 参考定义(行号) | 要点 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 1 | posts 文章列表 | widget-posts.php:1881-2006 | load_mode radio(detail/ajax 默认 ajax)、cat(reference_ids)、zibpay_type checkbox、limit_day、orderby、order、style(list/card/mini)+mini_opt、count 4..20 默认 12、paginate radio ''/ajax/number;壳 `widget-main-post mb20 style-X`(mini 加 `zib-widget posts-mini-lists`);删旧 tag_ids/paginate select |
|
|
||||||
| 2 | tab_posts 多栏目文章 | widget-posts.php:2008-2155 | tabs 子字段 title/cat/zibpay_type/limit_day/orderby/order;移除 topics;**删除现有 legacy `post_ajax_trigger` 双路**,翻页三态;mini 骨架含缩略图变体 |
|
|
||||||
| 3 | oneline_posts 横向滚动文章 | widget-posts.php:2157-2234 | cat/zibpay_type/orderby/order/style 默认 card/count;移除 limit_day/paginate/autoplay(参考无);swiper-scroll DOM 已对齐,清 data-autoplay |
|
|
||||||
| 4 | hot_posts 热榜文章 | widget-posts.php:1803-1851 + zib-posts-list.php:769-888 | orderby radio 4 榜单、limit_day、count 默认 6、target_blank;`zib-widget hot-posts`、TOP1 大图+linear-mask+TOP 徽章(jb-red/jb-yellow/b-gray)、行布局与计数文案(人收藏/人点赞/条讨论/人已阅读);删 show_thumbnail/通用样式字段 |
|
|
||||||
| 5 | term_cards 分类图文卡片 | widget-posts.php:1565-1694 + functions.php:1939-2046 | 模块级 obs_animation/animation_repeat(common.animation 关)、terms 选择器、type style-1..4、height_scale、pc_row(1/2/3/4/6/12 默认 2)/m_row、mask_opacity 默认 10、target_blank;`row gutters-5` + `graphic hover-zoom-img` + `--cover-height-scale` + graphic-mask,style-2/3/4 文案差异与 tooltip;新建共享助手 `aksrt_graphic_card()`(inc/helpers),term 分类默认封面回退 |
|
|
||||||
| 6 | term_aggregation → 改名"分类聚合卡片" | widget-posts.php:1696-1801 + zib-category.php:606-751 | 仅分类(去标签/专题):模块级动画、pc_row slider 1..2 默认 2、terms、orderby/order、count 1..20 默认 4、target_blank;移植 `zib-widget term-aggregation`(term-img+img-badge 浏览合计、term-title/meta/更多文章、按 orderby 的行内 meta、--delay 交错);Catalog 名称/描述/共同字段更新;服务端仅 category |
|
|
||||||
| 7 | media_cards 图文视频封面卡片 | widget-more.php:2005-2191 | 模块级动画、pc_row/m_row(1..12,默认 4/2)、mask_opacity、height_scale 默认 30、font_size_pc/m、font_bold、font_color、covers group{image,video,hide,title,link};`widget-graphic-cover` + this-font 变量 + 移动端回退图片;删旧 description/image_dark 卡片字段 |
|
|
||||||
| 8 | slider_media_combo 幻灯片加图文视频卡片 | widget-slider.php:361-887 | 模块级动画;补 5 个 subheading 分组;option 默认值逐项核对(源文件为准);m_layout_type=default 时 m_row=pc_row;clamp 上限 4/6 修正;footer 重算 JS 接入 |
|
|
||||||
| 9 | partners 横向滚动合作伙伴 | widget-more.php:2317-2581 | rows/m_rows 1..6 默认 3、style_type card/logo/chip、card_width/height(依赖)、card_bg/card_radius、speed slider 0.1..10 步 0.1、direction/pause_hover/show_widget_bg/go_link/end_fade、link_type(link 类别多选用 terms 类型 taxonomy=link_category/link_limit/link_orderby/page_links_order)、partners group{title,desc,image,link};zps-* DOM、round-robin 行分配、get_bookmarks 来源、go_link 走 aksrt_go_link、CSS 动画(已有)+JS 初始化 |
|
|
||||||
| 10 | combo_info 复合信息卡片 | widget-more.php:2583-2833 | 模块级动画、pc_row 2/3/4/6 默认 4、m_row 1/2、pc_gap/m_gap(gutters)、card_radius、top_band/top_band_height、go_link、cta_text/cta_color、cards group{title,icon,icon_image,tags 嵌套 group{text,color},desc,link,cta_text,cta_color,band_color auto/7色};zci-* DOM + band auto 循环 + --delay 交错;markup 改挂到已有 `.aksrt-combo-info-card` CSS;删 aksrt-combo-card 死代码 |
|
|
||||||
| 11 | recent_comments 最近评论 | widget-more.php:3315-3363 + zib-comments-list.php:340-407 | limit 1..50 默认 8、outer/outpost、show_source 默认 false、style radio(''简约/style_2 风格2,默认修正为 '');`box-body comment-mini-lists zib-widget` + comment-widget-item(avatar box、昵称+icon-spot 时间、点赞、con-link text-ellipsis-5、style_2 盒装、来源行);复用 inc/helpers/aksrt-comments.php 时间/头像,内容过滤图片→[图片] |
|
|
||||||
| 12 | posts_toc 文章目录树 | widget-more.php:445-532 | 改旧式字段:title 默认"文章目录"、mini_title、in_affix(删 min_headings/collapsed/offset);渲染空占位 `.posts-nav-box[data-title]`;目录构建/scrollspy/折叠全部移入 frontend.js;`.posts-nav-lists` CSS 若缺则从 main.css:4835-4946 补 |
|
|
||||||
|
|
||||||
### Phase C 死代码清理
|
|
||||||
- 删除被替换的渲染分支与 CSS:aksrt-term-cards、aksrt-term-aggregation、aksrt-combo-card、aksrt-widget-partners 旧轨、aksrt-widget-media-cards/comments/toc/pagination/load-more 旧标记、tab_posts legacy trigger、hot_posts 的 show_thumbnail、oneline 的 autoplay;`media_card_fields()` 仍被 knowledge_product 组使用故保留,仅解除 12 个目标对它的引用。
|
|
||||||
|
|
||||||
### Phase D 测试与校验
|
|
||||||
- `tests/widget-system/run.php`:query_contract 移除 topics、加 tab zibpay_type;modern_widget_contract 扩充 12 个的 schema/DOM 断言;保持既有断言全绿。
|
|
||||||
- 新增 `tests/widget-system/zibll-parity-widgets-contract.test.cjs`(node --test 源码 token 契约:每 widget 的字段 id 清单、关键 DOM 类、CSS token、frontend.js 行为、死类负向断言)。
|
|
||||||
- 更新受影响的 zibll-modern-widgets / post-visual / a11y 契约测试(保持 aria-busy、role=status、reduced-motion)。
|
|
||||||
- 重新生成 `tests/fixtures/widget-golden-v1.json`(php tools/generate-widget-golden-fixture.php)并跑 php tools/validate-widget-golden.php(不带 --require-results)。
|
|
||||||
- 验证:`php -l` 全部改动 PHP;`node --test tests/widget-system/` 全量;`composer dump-autoload -o`(优先不新增类,仅改现有文件)。
|
|
||||||
|
|
||||||
### 明确不做
|
|
||||||
不做旧设置迁移与双路渲染;不做真实视觉/Docker 验收;不参考"(旧版即将删除)"模块;不改 37 slug 顺序、REST 路由形态、其他 25 个小工具。
|
|
||||||
|
|
||||||
### 主要参考文件
|
|
||||||
zibll:`inc/widgets/widget-posts.php`、`widget-more.php`、`widget-slider.php`、`inc/functions/{zib-posts-list,zib-category,functions}.php`、`js/section-navs.js`、`js/main.js`、`css/main.css`;AKSRT:`src/WidgetSystem/*`、`inc/helpers/*`、`assets/widgets/*`、`tests/widget-system/*`。
|
|
||||||
@@ -1,16 +0,0 @@
|
|||||||
诊断结论（已核实）：
|
|
||||||
|
|
||||||
`video-player.js:177` 是 `toggle()` 中的 `this.video.play()`。播放器进入“无可播放源”状态后，点击封面/遮罩触发 `toggle()`，该 Promise 没有 catch，于是抛出 `Uncaught (in promise) NotSupportedError: The element has no supported sources`。播放器进入无源状态有四条已确认路径：
|
|
||||||
1. `.m3u8` 在 Chrome：hls.js 从 `cdn.jsdelivr.net` 懒加载（video-player.js:22），CDN 不可达时 `loadScript` 静默失败（promise 也未 catch），`<video>` 始终没有源；
|
|
||||||
2. `.flv` 同理（flv.js，video-player.js:23）；
|
|
||||||
3. 直链 mp4 地址 404/编码不支持，源加载失败后 `currentSrc` 为空；
|
|
||||||
4. `.switch-iframe` 剧集按钮被 video-player 的委托处理器（video-player.js:225）捕获，把 iframe 嵌入页 URL 当 mp4 塞给 `video.src`，必然无源。`.switch-iframe` 本应由 `runtime/main.js:1351` 的 iframe 链路处理。
|
|
||||||
|
|
||||||
修复方案（单一路径，不引入双路/迁移）：
|
|
||||||
|
|
||||||
1. `assets/js/video-player.js`：
|
|
||||||
- `toggle()`：播放前守卫无源状态（`video.currentSrc`/`video.src`/`this.hls`/`this.flvPlayer` 均为空时直接返回），并对 `play()` 返回的 Promise 加 `.catch()`，播放失败不再产生未捕获异常；
|
|
||||||
- 两处 `loadScript()`（hls/flv）加 `.catch()`，CDN 失败被收敛为“无源”状态，不再产生未处理 rejection；
|
|
||||||
- 委托处理器限定为 `.switch-video`，移除对 `.switch-iframe` 的错误接管（iframe 剧集继续由 main.js 既有链路处理，属于删除错误重叠而非新增实现）。
|
|
||||||
2. 契约测试 `tests/widget-system/single-cover-height-contract.test.cjs` 的 video cover 用例追加断言：toggle 守卫 + play catch、loadScript catch、处理器不含 `.switch-iframe`。
|
|
||||||
3. 验证：`node --check` 播放器文件、运行 `single-cover-height-contract` 及相关契约测试、`rg` 复查、`git diff --check`；不做真实视觉效果验收。
|
|
||||||
@@ -1,142 +0,0 @@
|
|||||||
## 目标与边界
|
|
||||||
|
|
||||||
将 AKSRT 前台 DOM 架构一次性硬切换为 `C:\Users\Xing\Desktop\zibll` 的真实架构：
|
|
||||||
|
|
||||||
```text
|
|
||||||
WordPress 配置/_win
|
|
||||||
→ jQuery → Bootstrap → runtime/loader.js
|
|
||||||
→ tbquire(['main'])
|
|
||||||
→ main.js 顶层全局委托 + window.auto_fun()
|
|
||||||
→ 局部 AJAX：post_ajax.ed
|
|
||||||
→ JSON AJAX：zib_ajax.success
|
|
||||||
→ 远程 modal：loaded.bs.modal → auto_fun()
|
|
||||||
```
|
|
||||||
|
|
||||||
不保留 `AksrtFrontend`、不写兼容适配器、不做双路初始化、不保留“迁移中”分支。保留 AKSRT 的业务能力和安全处理，但全部挂到参考主题的唯一 `main/auto_fun` owner 上。按用户要求只做静态、契约、VM、语法和构建验证，不做真实视觉验收。
|
|
||||||
|
|
||||||
## 一、运行时入口硬切换
|
|
||||||
|
|
||||||
1. **重写 `assets/js/runtime/loader.js`**
|
|
||||||
- 以参考主题 loader 为行为基准，恢复 RequireJS 改名运行时、`tbquire.config()` 和最后的 `tbquire(['main'])`。
|
|
||||||
- 根据 AKSRT 实际目录调整 `baseUrl` 与 URL 版本参数，但保持参考主题的加载语义和 module mapping 结构。
|
|
||||||
- 将当前仍有业务消费者的模块纳入 mapping：main、imgbox、page-navs、section-navs、comment、message、input-expand、mini-upload、page-template、page-edit、author、poster-share、captcha、pay、swiper、dplayer、lazySizes、clipboard、svg-icon、enlighter、translate 等；每个 mapping 只指向一个真实文件，不复制第二份实现。
|
|
||||||
- 删除当前仅为 `AksrtFrontend`/`aksrt.tbquire` 服务的映射和 fallback。
|
|
||||||
|
|
||||||
2. **重写 `assets/js/runtime/main.js`**
|
|
||||||
- 以参考主题 `zibll/js/main.js` 的全局顺序为骨架：顶层建立 `_win.bd`/`_win.window`，注册 body/document 委托，定义全局 API 与插件，定义 `z_auto_fun`，暴露 `window.auto_fun = debounce(z_auto_fun, 100)`，顶层首次调用 `auto_fun()`，最后执行单一 `$(document).ready(...)` 首屏逻辑。
|
|
||||||
- 将 AKSRT 当前 `aksrt-runtime.js` 中仍需要的 declarative action、确认、通知、上传/安全/站点功能直接并入该唯一运行时或对应 `tbquire` 模块，不再通过第二个 runtime 注册表调用。
|
|
||||||
- 将所有按 DOM 条件加载逻辑集中到 `z_auto_fun()`：支付、消息、输入扩展、上传、海报分享、验证码、复制、tooltip、popover、affix、Swiper、DPlayer、SVG、代码高亮、灯箱等，严格按参考主题调用 `tbquire()`。
|
|
||||||
- 删除 `AksrtFrontend.register('aksrt-legacy-main', ...)`、`window.auto_fun` 到 `AksrtFrontend.rehydrate()` 的 wrapper、`z_auto_fun()` 中对新 registry 的依赖。
|
|
||||||
- 将原先局部更新后的 `AksrtFrontend.rehydrate(root, 'ajax'/'modal')` 全部改为参考主题调用顺序：注入完成后触发 `post_ajax.ed`（列表场景）或 `loaded.bs.modal`（远程 modal），随后调用防抖 `auto_fun()`。
|
|
||||||
- 保留必要的幂等 class/data 标记（如 `is-on`、`swiper-container-initialized`、`dplayer-initialized`），但删除无法再被调用的 registry 保护代码。
|
|
||||||
|
|
||||||
3. **删除新生命周期核心**
|
|
||||||
- 删除 `assets/js/rehydrate.js`。
|
|
||||||
- 将 `assets/js/aksrt-runtime.js` 中仍需的实际业务行为迁移到 `runtime/main.js` 或对应按需模块后，删除该文件及其作为公共入口的职责；不得留下空壳 `aksrt-runtime` 适配层。
|
|
||||||
- 清理所有 `AksrtFrontend.register/boot/rehydrate`、`aksrt.autoFun`、`aksrt:ready`、`aksrt:rehydrated` 引用和注释。
|
|
||||||
|
|
||||||
## 二、公共构建与 PHP 入队重构
|
|
||||||
|
|
||||||
1. **调整 `tools/build-public-assets.mjs`**
|
|
||||||
- 不再把整个 canonical 模块集合拼成一个 `public.js` 再依赖 `AksrtFrontend`。
|
|
||||||
- 以参考主题的独立 loader + 独立动态模块为构建图；对仍需生成的压缩文件只从唯一源码生成，避免 source/min 双 owner。
|
|
||||||
- 保留 CSS bundle 构建；JS 构建只生成 loader/main 及实际 mapping 所需的 min 产物。
|
|
||||||
- 生成后执行静态顺序检查，确保 loader 先于 main 动态加载，且没有 `tbquire(['main'])` 之外的第二个 boot。
|
|
||||||
|
|
||||||
2. **调整 `src/Core/Scripts.php`、`ScriptsPart1b.php`、`ScriptsPart1c.php` 及 WidgetSystem AssetManager**
|
|
||||||
- 前台基础依赖改为 jQuery → Bootstrap → `runtime/loader.js`，不再将 `build/public.js` 作为全局生命周期入口。
|
|
||||||
- 删除所有 routed script 对 `aksrt-runtime` 的依赖；路由模块改由 loader/main 按 DOM 条件加载，直接遵循参考主题的条件加载方式。
|
|
||||||
- 将 `_win` 作为唯一前台运行时配置对象；把必须保留的 AKSRT 数据字段合并进去，避免同时维护 `_win`、`aksrtData` 两套 DOM 生命周期配置。
|
|
||||||
- WidgetSystem 只保留一个前端 owner：将 widget 的初始化接入 `auto_fun`/对应动态模块，禁止 `assets/widgets/frontend.js` 与旧 widget-set/main 重复初始化同一节点；同步调整第三方资源注册和依赖。
|
|
||||||
- 清理已迁移到 loader/main 的独立 enqueue、重复 inline boot、重复条件判断和无实际动作的 Swiper 注册。
|
|
||||||
|
|
||||||
## 三、局部更新协议统一为参考主题行为
|
|
||||||
|
|
||||||
1. **列表 AJAX：`assets/js/core/ajax-list.js`、`homepage-fixed.js`、`pagination.js`、`comments.js`、`routes/user-center.js`、`author.js`、`widgets/frontend.js` 等**
|
|
||||||
- 保留现有请求、安全、错误提示和业务响应格式。
|
|
||||||
- 删除直接 `AksrtFrontend.rehydrate()` 的调用。
|
|
||||||
- 按场景统一为：before 状态 → HTML parse/replace/append → 触发容器上的 `post_ajax.ed` → `auto_fun()`；保留参考主题的 `ing`/loading/分页/route 顺序。
|
|
||||||
- 对复杂 panel 继续使用现有 destroy 能力（例如订单中心），但 destroy 只是业务实例清理，不再扩展成第二套全局 lifecycle。
|
|
||||||
- 明确旧 `.ajax-next` 与新 `data-aksrt-*` 的唯一 ownership；最终删除重复 click handler，控制只由一个 `post_ajax` 实现处理。
|
|
||||||
|
|
||||||
2. **JSON AJAX：`comment-ajax.js`、`auth.js`、`follow.js`、`credits.js`、`reward.js`、`messages.js` 等**
|
|
||||||
- 统一使用参考主题的 `zib_ajax()` 语义：按钮状态、错误/成功提示、`zib_ajax.success` 事件、业务 callback、可选 modal/reload。
|
|
||||||
- 删除以 `aksrt:rehydrated` 或 registry 事件作为成功信号的路径；只有真正 HTML 注入后才调用 `auto_fun()`。
|
|
||||||
|
|
||||||
3. **远程 modal 与历史路由**
|
|
||||||
- modal HTML 更新改为 Bootstrap `loaded.bs.modal`，由 main 的全局监听调用 `auto_fun()`。
|
|
||||||
- 保留 `history.pushState/replaceState` 与 Tab `popstate` 行为，但删除 `AksrtFrontend` 路由 API 和独立页面 boot；不引入 PJAX、Turbolinks、InstantClick 或全局 MutationObserver 重初始化。
|
|
||||||
|
|
||||||
## 四、灯箱、懒加载和 DOM 标记恢复为参考主题契约
|
|
||||||
|
|
||||||
1. **灯箱硬切换**
|
|
||||||
- 删除 `AksrtLightbox`、`data-aksrt-lightbox*`、`aksrt-lightbox` overlay 和其专用 CSS/配置桥接。
|
|
||||||
- 从参考主题恢复单一 `imgbox` owner：新增/恢复 `assets/js/runtime/imgbox.js`（压缩产物由构建生成），使用 `Miniimgbox`、`imgbox-container`、`a[data-imgbox]`、`imgbox_data` 和参考主题的幂等标记。
|
|
||||||
- `main.js` 只在 `_win.imgbox` 且存在目标 DOM 时 `tbquire(['imgbox'])`；不得再有第二个灯箱监听器。
|
|
||||||
- 更新 `single.php`、`page.php`、gallery/content renderer、图片 helper、相关 CSS 和设置输出，使 DOM 属性、分组、缩略图、zoom/full/play/down 开关与参考主题一致。
|
|
||||||
|
|
||||||
2. **懒加载单一 owner**
|
|
||||||
- 删除 `lazy-image-attr.js` bridge 及其 enqueue/build/test 依赖；lazySizes、`lazybeforeunveil`、`data-src`/`data-srcset`/`data-bg`、兼容属性处理全部由 main/lazySizes owner 负责。
|
|
||||||
- 保留必要的 PHP 图片 URL 生成和占位图能力，但统一输出参考主题可识别的 DOM，不再并行维护第二套 lazy switch 或 IntersectionObserver 初始化。
|
|
||||||
- 保留 lazySizes 自有 MutationObserver；禁止把它扩展成全局组件 rehydrate 机制。
|
|
||||||
|
|
||||||
## 五、所有业务模块去 registry 化
|
|
||||||
|
|
||||||
逐一处理当前已注册的 public/routed 文件（article、comments、comment-fixed-input、pagination、archive、footer-tabbar、misc、follow、enhancements、enhancements2、color-extract、effects、captcha、auth、author、page-navs、section-navs、messages、front-submit、mini-upload、page-template、page-edit、post-share、poster-share、pay-vip、video-player、download-status、ban-appeal、docs-navigation、input-expand、waterfall、yiyan、site-notice、user-badge-actions、widgets 等）：
|
|
||||||
|
|
||||||
- 删除 `AksrtFrontend.register()` 包装和对 registry API 的防御性分支。
|
|
||||||
- 将脚本改成参考主题式：被 `tbquire` 加载后立即定义/绑定，或暴露单一模块初始化函数供 main 调用；依赖 DOM 委托和 `is-on`/class/data 标记实现重复调用安全。
|
|
||||||
- 任何需要窗口/文档监听的模块只绑定一次，并使用参考主题的全局 owner；不新增 destroy registry、root 广播或双入口 ready。
|
|
||||||
- 保留 AKSRT 的 nonce、REST 权限、输出转义和业务接口，不改变安全边界。
|
|
||||||
|
|
||||||
## 六、死代码清理
|
|
||||||
|
|
||||||
在改造前后用 `rg/git grep` 建立引用图，仅删除已确认无入口的代码，避免把仍被动态 loader 使用的资源误删：
|
|
||||||
|
|
||||||
- 删除 `assets/js/revenue.js`（确认无 PHP、JS、构建和模板引用后）。
|
|
||||||
- 删除当前 `rehydrate.js`、`aksrt-runtime.js` 生命周期专用代码及其测试夹具。
|
|
||||||
- 删除 `runtime/main.js` 中已迁移功能的 registry 适配、注释掉的 waterfall 分支、未使用 `auto_fun` 转发代码和重复事件派发。
|
|
||||||
- 删除确认无 mapping、enqueue、模板或第三方引用的 `runtime/widget-set.*`、`runtime/mini-touch.*`、`waterfall.*` 等 orphan；若仍被参考主题式 loader 使用，则保留唯一映射，不凭文件名删除。
|
|
||||||
- 删除 `AksrtLightbox`、旧 overlay、runtime/imgbox 的冲突副本和无消费者的 `aksrt.*` API；`_win`、`tbquire`、main、loader、Swiper/DPlayer/lazySizes 只在确认所有消费者迁移后保留。
|
|
||||||
- 同步清理文档、注释、PHP handles、构建清单、测试中的旧 token，确保仓库不存在“旧入口还能被重新接回”的死配置。
|
|
||||||
|
|
||||||
## 七、测试与非视觉验证改造
|
|
||||||
|
|
||||||
1. 删除/重写锁定旧架构的测试：
|
|
||||||
- `global-dom-init-contract.test.cjs` → `legacy-loader-runtime-contract.test.cjs`：验证 loader config、mapping、`tbquire(['main'])`、唯一 boot owner。
|
|
||||||
- `rehydrate-runtime-contract.test.cjs` → `legacy-auto-fun-contract.test.cjs`：VM 验证 `auto_fun` 防抖、重复调用、`auto_fun` 事件、异常隔离和 DOM 标记幂等。
|
|
||||||
- `public-bundle-parity-contract.test.cjs`：改为验证 loader/main 构建图，不再断言 `AksrtFrontend`。
|
|
||||||
- `homepage-dom-contract.test.cjs`：改为验证 HTML 注入后 `post_ajax.ed → auto_fun` 顺序和唯一 delegated owner。
|
|
||||||
- `lightbox-contract.test.cjs`：改为 `Miniimgbox`/`data-imgbox`/`imgbox` mapping 契约。
|
|
||||||
- `lazyload-contract.test.cjs`：改为 main/lazySizes 单 owner 契约。
|
|
||||||
- `legacy-navigation-contract.test.cjs`：验证 loader 的 page-navs/section-navs mapping 和 `auto_fun` 条件加载。
|
|
||||||
|
|
||||||
2. 新增/保留 VM 与静态契约：
|
|
||||||
- loader URL 解析和模块缓存只发生一次。
|
|
||||||
- 同一 DOM 多次 `auto_fun()` 不重复绑定 tooltip、Swiper、DPlayer、imgbox、上传和 widget。
|
|
||||||
- `post_ajax.ed`、`zib_ajax.success`、`loaded.bs.modal` 三种事件不混用。
|
|
||||||
- 全仓库禁止 `AksrtFrontend`、`aksrt.autoFun`、`aksrt:ready`、`aksrt:rehydrated`、第二套 `DOMContentLoaded` 页面 boot。
|
|
||||||
- 静态检查没有 PJAX/InstantClick/全局 MutationObserver reinit 新入口。
|
|
||||||
|
|
||||||
3. 继续运行与改造后的验证：
|
|
||||||
- Node widget/navigation 契约测试。
|
|
||||||
- `tools/test-credits-rehydrate.mjs`（改名或改断言为 auto_fun 重入 harness）。
|
|
||||||
- WidgetSystem PHP audit、asset ledger、业务安全/支付/评论相关测试。
|
|
||||||
- `node --check` 检查所有改动后的 JS 和构建脚本。
|
|
||||||
- `php -l` 检查所有改动后的 PHP。
|
|
||||||
- `node tools/build-public-assets.mjs` 后再次运行 bundle/source parity、旧入口扫描和 `git diff --check`。
|
|
||||||
|
|
||||||
## 八、实施顺序与完成标准
|
|
||||||
|
|
||||||
1. 先完成只读引用图和测试基线，记录当前失败/通过集合。
|
|
||||||
2. 先改 loader/main/构建/PHP 入队，建立唯一运行时入口。
|
|
||||||
3. 再批量去掉所有 registry 调用并统一 AJAX/modal 事件顺序。
|
|
||||||
4. 再恢复参考主题灯箱和 lazySizes owner，更新模板/CSS/配置。
|
|
||||||
5. 最后删除确认死代码与旧测试，重建生成产物。
|
|
||||||
6. 完成标准：
|
|
||||||
- 前台只有 `loader → main → auto_fun` 一条初始 DOM 路径。
|
|
||||||
- 没有任何 `AksrtFrontend` 或其双路兼容代码。
|
|
||||||
- 列表、JSON、modal 三类更新分别遵循参考主题事件协议。
|
|
||||||
- Swiper、DPlayer、lazySizes、imgbox、WidgetSystem 各只有一个 owner。
|
|
||||||
- 所有已确认死代码和旧契约被删除或改写。
|
|
||||||
- 非视觉测试、语法检查、构建和静态引用审计通过；不执行真实视觉验收。
|
|
||||||
@@ -1,95 +0,0 @@
|
|||||||
# 第三方人机验证优化改造计划
|
|
||||||
|
|
||||||
约束：不写双路/兼容迁移代码；顺手清理死代码；不做真实视觉效果验收（用语法检查、契约测试、构建产物校验代替）。
|
|
||||||
已确认决策：范围全做（P0+P1+P2）；下载场景 pass 放行 10 分钟；凭据不齐时仅加后台警告、前台保持放行。
|
|
||||||
|
|
||||||
## 改动文件总览
|
|
||||||
|
|
||||||
| 文件 | 动作 |
|
|
||||||
|---|---|
|
|
||||||
| `inc/modules/captcha.php` | 重写校验层 + 瘦身渲染 + 后台警告 + 静态缓存 |
|
|
||||||
| `assets/js/captcha-front.js` | 新建（从内联脚本迁移，~340 行） |
|
|
||||||
| `assets/css/shared/captcha.css` | 保留不动（改为进 bundle） |
|
|
||||||
| `tools/build-public-assets.mjs` | publicScripts 加 captcha-front.js；public.css 加 captcha.css |
|
|
||||||
| `src/Admin/Schema/SchemaPermissions.php` | 删除 'mode' 死字段（L32-34） |
|
|
||||||
| `assets/admin/src/schema/sections/permissions/index.js` | 删除 'mode' 死字段（L18 defaults、L50-56） |
|
|
||||||
| `src/Admin/SchemaProvider.php` | L403 白名单删 'mode'；保存后 flush 配置静态缓存 |
|
|
||||||
| `tests/widget-system/captcha-cloud-contract.test.cjs` | 新建契约测试 |
|
|
||||||
|
|
||||||
不动的文件及原因：`aksrt-header-userbox.php`（toast-contract 测试锁定 signin 接线）、`data-aksrt-download-captcha` 挂载点（`templates/parts/resource-download-box.php:467`、`inc/helpers/aksrt-pay.php:1586`）、所有业务 JS（auth/signin/comments/cms-download/user-center/front-submit 只消费 `AKSRTCaptchaState.scenes[scene]` 与 mount 内 token input，接口不变即零改动）。
|
|
||||||
|
|
||||||
## 1. inc/modules/captcha.php — 校验层
|
|
||||||
|
|
||||||
**P0-1 腾讯云改走 WP HTTP API**：`aksrt_verify_tencent()` 删除 curl 块（L374-390，含 `CURLOPT_SSL_VERIFYPEER => false`），改用 `wp_remote_post('https://captcha.tencentcloudapi.com/', ['timeout'=>5, 'headers'=>aksrt_tencent_tc3_sign(...)生成的一维数组, 'body'=>$payload])`，与另外三家一致。签名函数不动。
|
|
||||||
|
|
||||||
**P1-5 错误信息收敛**：四家服务商的传输层错误（wp_remote_post 返回 WP_Error、响应不可解析）统一 `error_log('[AKSRT Captcha] {provider}: ' . 详情)` 后返回通用文案 `__('人机验证服务暂不可用，请稍后重试', 'aksrt')`；保留对用户有行动意义的映射文案（腾讯 CaptchaCode 表、阿里 F0xx 表）。腾讯 API Error 分支（签名错误等）也走 log+通用文案。
|
|
||||||
|
|
||||||
**P1-4**：阿里云 `SignatureNonce` 由 `uniqid('', true)` 改 `wp_generate_uuid4()`。
|
|
||||||
|
|
||||||
**P1-8**：四家 `'timeout'` 统一 5 秒（现 10 秒）。
|
|
||||||
|
|
||||||
**P1-6 Turnstile 绑定场景**：`aksrt_verify_captcha($post_data, $scene = '')` 增加第二参数（唯一调用方是 `aksrt_require_captcha`，无散落调用点）；Cloudflare 成功响应校验：`action !== 'aksrt-verify'` 或 `cdata !== $scene`（存在才比对，lenient）→ 失败。客户端配套见 §2。
|
|
||||||
|
|
||||||
**P0-2 下载 pass 放行（10 分钟）**：`aksrt_require_captcha()` 内，scene 命中放行名单时先查 transient、验证通过后写 transient：
|
|
||||||
- `aksrt_captcha_pass_ttl($scene)`：仅 `download` 返回 `10 * MINUTE_IN_SECONDS`，其余返回 0（单一代码路径，无散落分支）
|
|
||||||
- key = `'aksrt_captcha_pass_' . md5($scene . '|' . get_current_user_id() . '|' . aksrt_get_client_ip() . '|' . md5(UA))`，仿 `aksrt_auth_rate_` 既有模式
|
|
||||||
|
|
||||||
## 2. assets/js/captcha-front.js — 新建（P2-9 + P1-7 客户端）
|
|
||||||
|
|
||||||
把 `aksrt_render_captcha()` 内联 `<script>`（L632-969）整体迁移为静态文件，逻辑不改名不重写：`loadScriptOnce`、四家 `load*`、`AKSRTCaptchaState.scenes[scene].verify/reset` 注册、`setField/resetVerificationState/syncDownloadSiblings` 等原样搬移。仅两处行为修正：
|
|
||||||
- 极验 `onClose` 空回调改为 `cancelPending('已取消验证')`（P1-7，与腾讯/CF 取消体验对齐）
|
|
||||||
- Turnstile render 配置加 `cdata: C.scene`（P1-6 客户端配套）
|
|
||||||
|
|
||||||
激活模型：扫描 `document.querySelectorAll('[data-aksrt-captcha-config]')`，`JSON.parse(el.getAttribute(...))` 逐个 init；DOMContentLoaded 后再补扫一次并暴露 `window.AKSRTCaptchaState.rescan()` 供未来 ajax 注入使用。保持 vanilla JS、无新依赖。
|
|
||||||
|
|
||||||
对应 PHP 渲染端瘦身：`aksrt_render_captcha()` 只输出
|
|
||||||
1. 原 wrapper 结构不变（`.aksrt-captcha-wrap` + `#uid` box + `#vid` captcha_verified 隐藏域），
|
|
||||||
2. wrapper 上挂 `data-aksrt-captcha-config`（`esc_attr(wp_json_encode($js_config))`），
|
|
||||||
3. 删除内联 `<script>` 与逐次 `<link rel="stylesheet">`。
|
|
||||||
|
|
||||||
TOKEN_FIELDS 常量、i18n 字符串原样进 JS 文件（与仓库其它 bundle 内硬编码中文一致）。
|
|
||||||
|
|
||||||
## 3. 构建与后台（P2-10 + bundle 接线）
|
|
||||||
|
|
||||||
- `tools/build-public-assets.mjs`：`publicScripts` 追加 `'assets/js/captcha-front.js'`；`cssBundles['public.css']` 追加 `'assets/css/shared/captcha.css'`。走既有 bundle 版本机制，无需新增 enqueue 代码。
|
|
||||||
- `SchemaPermissions.php`：删除 'mode' 字段定义（L32-34，单选项 always 的死字段）。
|
|
||||||
- `assets/admin/src/schema/sections/permissions/index.js`：删除 `mode` 的 defaults（L18）与字段定义（L50-56）。
|
|
||||||
- `SchemaProvider.php` L403：归一化白名单去掉 `'mode'`；`write_section_settings()` 更新 `aksrt_captcha_config` 后调用新助手 `aksrt_captcha_config_reset()` 清静态缓存（function_exists 守卫，与现有 captcha 专用块并排）。
|
|
||||||
- DB 里残留的 `mode` 键不做迁移清洗（读路径白名单已忽略它，符合"不做迁移"约束）。
|
|
||||||
|
|
||||||
## 4. inc/modules/captcha.php — 后台警告与缓存
|
|
||||||
|
|
||||||
- **P0-3**：新增顶层 `add_action('admin_notices', ...)`：`manage_options` 权限 + `enabled` 为真 + `active_provider` 非空 + `aksrt_captcha_provider_is_configured()` 为假时，输出 `notice-error` 横幅，文案指向「功能&权限 → 人机验证」补全配置（复用现有 misconfig 提示文案）。前台行为不变（保持放行）。
|
|
||||||
- **P2-11**：`aksrt_get_captcha_config()` 加 `static $cache`；新增 `aksrt_captcha_config_reset()`；写入路径（SchemaProvider）调用 reset。`aksrt_get_captcha_status_summary()` 的 12 场景循环随之受益。
|
|
||||||
|
|
||||||
## 5. 新契约测试 tests/widget-system/captcha-cloud-contract.test.cjs
|
|
||||||
|
|
||||||
仿 toast-contract 的正则断言风格：
|
|
||||||
- `captcha.php`：不匹配 `curl_init|CURLOPT_SSL_VERIFYPEER|machine-verification|slidercaptcha|imagecaptcha`；匹配 `wp_remote_post`（≥4 处）、`wp_generate_uuid4`、`'timeout'\s*=>\s*5`、`aksrt_captcha_pass_`；渲染函数不匹配 `/<script|<link/`（内联抽取完成）
|
|
||||||
- `captcha-front.js` 存在且含 `AKSRTCaptchaState`、`data-aksrt-captcha-config`
|
|
||||||
- `build-public-assets.mjs` 的 publicScripts 含 captcha-front.js、public.css 含 shared/captcha.css
|
|
||||||
- `SchemaPermissions.php` 与 admin `index.js` 的 captcha 段不匹配 `mode`
|
|
||||||
- `SchemaProvider.php` 不匹配 `'mode'`
|
|
||||||
|
|
||||||
## 6. 验证（不做视觉验收）
|
|
||||||
|
|
||||||
1. `php -l` 全部改动的 PHP 文件
|
|
||||||
2. `node --check` captcha-front.js
|
|
||||||
3. `node tools/build-public-assets.mjs` 重建 bundle
|
|
||||||
4. `grep` 全仓清扫：无 `curl_init`、无 `'mode'`（captcha 相关文件）、无 legacy 标记
|
|
||||||
5. `node --test tests/widget-system/*.test.cjs` 全量跑，预期仅存量 page-display-contract 一项失败（与本次无关，已验证在 HEAD 上同样失败）
|
|
||||||
|
|
||||||
## 明确不做
|
|
||||||
|
|
||||||
- 不做视觉验收/浏览器实测（按要求）
|
|
||||||
- 不写新旧配置迁移、不清洗 DB 残留 `mode` 键
|
|
||||||
- 不动腾讯 trerror 容灾票据策略（维持拒绝）
|
|
||||||
- 不做阿里云签名 V3 升级、Turnstile appearance/retry 配置项（列为后续可选项）
|
|
||||||
- 不动 `ExtensionController` 的 extensions 状态端点（SPA 未消费属另一话题）
|
|
||||||
|
|
||||||
## 建议提交拆分（如需提交）
|
|
||||||
|
|
||||||
1. `fix(captcha): use WP HTTP API with TLS verification for tencent`
|
|
||||||
2. `feat(captcha): short-lived download pass + turnstile binding + error hardening`
|
|
||||||
3. `refactor(captcha): extract inline runtime to captcha-front.js bundle`
|
|
||||||
4. `chore(captcha): drop dead mode field, config cache, contract tests`
|
|
||||||
@@ -1,47 +0,0 @@
|
|||||||
# 侧栏空槽/挤压修复（全站，单一决策源）
|
|
||||||
|
|
||||||
## 根因
|
|
||||||
"是否渲染侧栏列"有两套脱节的决策：
|
|
||||||
- **body 布局类**（`site-layout-1/2/3`，决定 CSS 留白）来自 `aksrt_is_show_sidebar_filter()`，但"小工具是否为空"检查只对 `is_single()` 生效（`inc/helpers/template-tags/site-layout.php:150-152`）。
|
|
||||||
- **aside 渲染**各自为政：固定首页 `aksrt_homepage_render_sidebar()` 额外检查小工具（`inc/helpers/homepage/content.php:146-162`），空时整个不渲染；`sidebar.php`（page/search/archive 用）却渲染空列 div（"legacy parity"）。
|
|
||||||
|
|
||||||
于是"开关开 + 无小工具"：首页 body 仍是 `site-layout-2` → `layout.css:156-162` 保留 `margin-right: 侧栏宽+15px` → 主内容挤压、右侧 326px 空槽；其他页面则是空列占位同样挤压。后台关开关的路径本身自洽（layout-1），但因上述不一致，任何"列被保留而无内容"的场景都出现挤压。
|
|
||||||
|
|
||||||
参考 Zibll（`zib-theme.php` 判断 + `sidebar.php:14-16` 早退 + `main.css` 留白只挂 `site-layout-2/3`）：判断集中一处，body class 承载几何，渲染与判定同源。AKSRT 骨架已具备，只缺"小工具为空"一维的全局化。
|
|
||||||
|
|
||||||
## 修改
|
|
||||||
|
|
||||||
### 1. `inc/helpers/template-tags/site-layout.php` — 核心（覆盖所有页面）
|
|
||||||
- `aksrt_is_show_sidebar_filter()`：把 `is_single() && !aksrt_has_current_sidebar_widgets()` 提升为无条件 `if (!aksrt_has_current_sidebar_widgets()) { return false; }`（空侧栏列 = 空槽，全部场景折叠为 layout-1；single 既有行为不变，home/category/tag/search/page/日期归档一并对齐）。
|
|
||||||
- `aksrt_resolve_sidebar_id()`：把 `is_home() || is_front_page()` 分支移到 `is_page()` 之前——静态首页目前解析成 `page_sidebar_{id}` 但渲染器输出 `home_sidebar`，判定/渲染不匹配；重排后一致（该函数仅 sidebar.php 与小工具检查两处调用，重排安全）。
|
|
||||||
|
|
||||||
### 2. `inc/helpers/homepage/content.php` — 删双路
|
|
||||||
- 删除 `aksrt_homepage_has_sidebar()`（修复后与 `aksrt_is_show_sidebar()` 完全等价）；`aksrt_homepage_render_sidebar()` 守卫直接用 `!aksrt_is_show_sidebar()`。
|
|
||||||
|
|
||||||
### 3. `sidebar.php` — Zibll 式早退
|
|
||||||
- 顶部加 `if (!function_exists('aksrt_is_show_sidebar') || !aksrt_is_show_sidebar()) { return; }`（覆盖 `search.php:126` 的无条件 `get_sidebar()`）。
|
|
||||||
- 删除"Keep the column even if widgets are empty (legacy parity)"注释与空列行为（此后不可能渲染空列：is_show_sidebar 为真 ⇔ 至少一个 zone 有小工具）；删除 `elseif ((is_home() || is_front_page()) && ...home_sidebar...)` 死分支与 `$sidebar_id` 兜底。
|
|
||||||
|
|
||||||
### 4. `inc/helpers/aksrt-archive.php` + `category.php` / `tag.php` — 死参数清理
|
|
||||||
- `aksrt_archive_has_sidebar(string $preferred = '', bool $enabled = true)` → `(bool $enabled = true)`（`$preferred` 自注释 "compat only" 后即 unset，死参数）；删除 `return !wp_is_mobile();` 死兜底（主题已明确弃用 wp_is_mobile 布局门控，见 site-layout.php:141-143）。
|
|
||||||
- 更新调用点：`category.php:49`、`tag.php:30` 改为 `aksrt_archive_has_sidebar(!empty($archive_settings['show_sidebar']))`。
|
|
||||||
|
|
||||||
### 5. 死类/死代码清理
|
|
||||||
- `single.php:45`：删除无任何 CSS/JS 引用的 `container--no-sidebar` 输出。
|
|
||||||
- `front-page.php:14-29`：删除不可达的 `function_exists('aksrt_homepage_render_layout')` 兜底双路（`inc/bootstrap.php:33` 无条件加载），模板直接 `get_header(); aksrt_homepage_render_layout(); get_footer();`。
|
|
||||||
- `index.php:23-25`：注释"widget activity never changes the body layout after render"与新契约矛盾，更新为单一决策源描述。
|
|
||||||
- 保留：`layout.css:149-153` 的 `content-layout--no-sidebar` compat 规则（go.php/archive-resources.php/page-ban-appeal.php/page-user-home.php 仍在用）。
|
|
||||||
|
|
||||||
### 6. 测试
|
|
||||||
- `tests/widget-system/post-visual-contract.test.cjs:359-367`：更新测试名与 ：364 正则为全局检查 `if \(!aksrt_has_current_sidebar_widgets\(\)\) \{\s*return false;`；新增断言钉住：homepage 渲染守卫用 `aksrt_is_show_sidebar()` 且 `aksrt_homepage_has_sidebar` 已不存在、sidebar.php 早退、resolver 中 home 分支先于 page 分支、archive helper 无 `$preferred` 参数。
|
|
||||||
- 运行 `node --test tests/widget-system/`（至少 post-visual-contract）与 `php -l` 全部改动 PHP 文件。
|
|
||||||
|
|
||||||
## 修复后行为矩阵（每场景验证推演）
|
|
||||||
| 状态 | body 类 | aside |
|
|
||||||
|---|---|---|
|
|
||||||
| 开关开 + 有小工具 | layout-2/3 | 渲染，留白匹配 |
|
|
||||||
| 开关开 + 无小工具 | **layout-1** | 不渲染，主内容占满（首页/分类/标签/页面/搜索/归档统一） |
|
|
||||||
| 开关关 | layout-1 | 不渲染 |
|
|
||||||
|
|
||||||
## 不改动
|
|
||||||
SPA schema（`sidebar_home_enabled` 等字段已齐全）、`get_sidebar_config()` 缺省语义、主题的响应式 CSS 隐藏策略（弃用 wp_is_mobile 的既有决定）、single 页既有判定（已被测试钉住，保持原样）。
|
|
||||||
@@ -1,53 +0,0 @@
|
|||||||
## 现状结论（影响方案的既有事实）
|
|
||||||
|
|
||||||
- 下载系统集中在 `src/Content/Download.php`：路由前缀硬编码为常量 `ENDPOINT='aksrt-dl'`（同时用于 rewrite 正则 :68 和 URL 拼接 :226）、TTL 硬编码 `TOKEN_TTL=600`(:12)、`max_uses` 固定写死 1(:422)、`expires_in` 返回固定值(:242)。
|
|
||||||
- 扣次在"点击兑换"时发生(`Download.php:286-292`)，无 HEAD 特判、无断开检测，需按需求重构。
|
|
||||||
- 过期/耗尽已是 `fail_410()`(HTTP 410 + wp_die 提示"回到资源页重新获取")，**不自动生成新链接** —— 该行为现状已满足，保持不变。
|
|
||||||
- `aksest_dl_token` 表（`src/Core/DBMigratorPart2.php:133-150`）的 token 列已是 `PRIMARY KEY`（即唯一索引），重复密钥不可能入库；需补的是 issue_token 插入失败时的换号重试。
|
|
||||||
- 设置体系是双端 schema：PHP 权威在 `src/Admin/Schema/*.php`，Vue 镜像在 `assets/admin/src/schema/sections/**`，菜单在 `assets/admin/src/constants/sections/permissions.js`，REST 用泛型路由自动生效。"功能&权限"= SPA 内 permissions 域。
|
|
||||||
- `Auth\Router::maybe_flush_rewrite_rules()`(:78-84) 已有"版本标记式 flush_rewrite_rules()"先例，可直接套用。
|
|
||||||
|
|
||||||
## 一、新增设置分区（permissions 域 → "下载配置"）
|
|
||||||
|
|
||||||
存储为独立 option `aksrt_download_config`（沿用 captcha/moderation 的 standalone 模式），三个字段：
|
|
||||||
|
|
||||||
| key | 类型 | 默认 | 校验 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| `url_alias` | input | `download` | 必填；trim 后非空；仅允许 `[A-Za-z0-9_-]`（禁中文/空格// \ ? # & 等）；≤48 字符；拒绝保留字黑名单（wp-json、wp-admin、wp-content、wp-includes、admin、login、logout、register、lostpassword、feed、search、author、page、comments、sitemap、sign 等，防路由冲突/404） |
|
|
||||||
| `default_max_uses` | number | `1` | min 1 / max 100 |
|
|
||||||
| `ttl_minutes` | number | `10` | min 1 / max 1440 |
|
|
||||||
|
|
||||||
修改文件：
|
|
||||||
1. **`src/Admin/Schema/SchemaPermissions.php`**：新增 `download` section（version 1.0.0，option_key `aksrt_download_config`，单组 basic 三字段，含中文标签/help 说明"完整下载才计次、到期或耗尽后 410 需重新获取"）。
|
|
||||||
2. **`src/Admin/SchemaProvider.php` `validate()`**：仿照 payment/withdrawal 特例先例(:269-292)，对 `permissions/download` 增加中文错误消息校验块（空值/非法字符/过长/保留字）——422 错误经前端 `message.error('保存失败: …')` 弹窗呈现，满足"后台弹窗提示"。
|
|
||||||
3. **`src/Settings/Settings.php`**：`STANDALONE_OPTION_KEYS` 追加 `aksrt_download_config`（导入导出完整性 + 缓存失效覆盖）。
|
|
||||||
4. **`assets/admin/src/schema/sections/permissions/index.js`**：镜像新增 `download` 分区（defaults 与 PHP 完全一致）。
|
|
||||||
5. **`assets/admin/src/constants/sections/permissions.js`**：追加子页 `schemaPage({ key:'permissions-download', route:'/permissions/download', label:'下载配置', section:'download' })`，置于附件配置之后。泛型 REST 路由与 SchemaPage 无需改动。
|
|
||||||
|
|
||||||
## 二、Download.php 改造（`src/Content/Download.php`）
|
|
||||||
|
|
||||||
1. **动态前缀**：删掉 `const ENDPOINT`；新增私有 `endpoint()` 读配置（无效/被污染时回落 `download`）；`register_rewrite()` 用 `preg_quote($endpoint)` 拼正则(:66-72)；URL 拼接(:226)同源。
|
|
||||||
2. **别名变更刷新路由**：仿 `Auth\Router` 版本标记法——`init` 尾部挂 `maybe_flush_rewrite()`（priority 99）：比较 `AKSRT_VERSION + 当前别名` 与 option `aksrt_dl_rewrite_version`，不一致则 `flush_rewrite_rules(false)` 并回写。导入/重置/直接改库都覆盖，无双路兼容逻辑。
|
|
||||||
3. **动态 TTL / 次数**：删掉 `TOKEN_TTL` 常量引用；`issue_token()` 写入 `max_uses = 配置.default_max_uses`、`expires_at = now + 配置.ttl_minutes*60`；`rest_request` 的 `expires_in` 改为动态秒数。配置读取做 clamp 兜底（别名非法回落 download、次数 1..100、分钟 1..1440）。
|
|
||||||
4. **完整下载才扣次**：
|
|
||||||
- 将扣次(UPDATE used_count)与文章计数 `_aksrt_res_download_count`(:286-300) 移到交付成功之后的新方法 `consume_token()`；UPDATE 加原子条件 `WHERE token=%s AND used_count < max_uses`，并发下计数封顶不超发。
|
|
||||||
- `stream_local_file()` 改为返回是否完整送达：输出循环中 `connection_aborted()` 为真立即中断并返回 false；收尾再核验一次。仅当完整送达且非 HEAD 才 `consume_token()`——网络波动中断不消耗次数，用户可重新点同一链接续下。
|
|
||||||
- **HEAD 探测**：`REQUEST_METHOD === 'HEAD'` 时照常走校验/输出 headers 但不扣次。
|
|
||||||
- **外链 302 源**（远端主机无法感知"是否下完"）：把 302 交接视为一次交付，重定向发出后扣次（HEAD 时同样跳过）。此为唯一可实现语义，计划中明示。
|
|
||||||
- 过期/耗尽仍走现有 `fail_410()`（改动前后行为一致）。
|
|
||||||
5. **密钥冲突重试**：`issue_token()` 插入失败时用全新随机串重试至多 3 次（PRIMARY KEY 已保证唯一，此为极低概率兜底；表缺失仍在入口提前返回 WP_Error 不进循环）。
|
|
||||||
|
|
||||||
## 三、清理与文档
|
|
||||||
|
|
||||||
- 删除不再使用的 `Download::ENDPOINT` / `Download::TOKEN_TTL` 常量及全部残留引用（实现时全库 grep 复核；已知其余命中仅为 CSS 类名巧合，不动）。
|
|
||||||
- 更新 `CLAUDE.md:132` 文档行：rewrite 前缀改为"可配置别名（默认 download）"，并补充"完整送达才计次"契约。
|
|
||||||
- 不写任何迁移/双路：现有表结构不动，存量过期 token 由每日 cron 自然清理。
|
|
||||||
- **关于唯一索引**：PRIMARY KEY(token) 本身即唯一索引且已存在（不加冗余 UNIQUE KEY，也不做表结构变更——与"不写迁移"一致），以插入重试落实需求的防冲突意图。
|
|
||||||
|
|
||||||
## 四、验证
|
|
||||||
|
|
||||||
1. 新增 Node 契约测试 `tests/widget-system/download-config-contract.test.cjs`：断言双端 schema 的字段/默认值/option_key 一致、菜单子项注册、Download.php 关键契约（动态 endpoint、流式完成后才条件 UPDATE 计次、HEAD 跳过、410 不自动续签、无 ENDPOINT/TOKEN_TTL 常量残留）。
|
|
||||||
2. `node --test tests/widget-system/download-config-contract.test.cjs` + 跑现有相关契约测试确认无回归。
|
|
||||||
3. `php -l` 全部改动的 PHP 文件；`php tools/audit-admin-contracts.php` 通过双端合同审计。
|
|
||||||
4. `cd assets/admin && npm ci && npm run build`，确认 build 产物完整（PHP 端有 chunk 缺失探测）。
|
|
||||||
5. 视觉不做真实验收（按约定跳过 Docker 对比环境）。
|
|
||||||
@@ -1,72 +0,0 @@
|
|||||||
# 评论区 Zibll 1:1 全量复刻计划
|
|
||||||
|
|
||||||
目标：将 AKSRT 评论区渲染层（DOM、类名、布局、CSS、交互行为）替换为与 Zibll 完全一致，不保留旧类名、不写兼容/迁移代码。现有 REST 后端（`src/Core/CommentActions.php`）保留，仅前端选择器随之更新。
|
|
||||||
|
|
||||||
## 参考源（Zibll 侧，只读对照）
|
|
||||||
- `zibll/template/comments.php`（整体结构 L21–210）
|
|
||||||
- `zibll/inc/functions/zib-comments-list.php`（`zib_comments_list` 回调 L14、分页 L569–678）
|
|
||||||
- `zibll/inc/functions/functions.php` L1775 `zib_get_input_expand_but()`（表情/代码/图片/链接/快捷回复工具栏）
|
|
||||||
- `zibll/css/main.css` L9411–9660（桌面端）+ L12470–12560（移动端）
|
|
||||||
- `zibll/js/comment.js`（交互行为参照）
|
|
||||||
- `zibll/img/smilies/*.gif`（约 100 个表情资源）
|
|
||||||
|
|
||||||
## 改动清单
|
|
||||||
|
|
||||||
### 1. 评论列表项 DOM — `inc/helpers/comments/item.php` 重写
|
|
||||||
输出 Zibll 原始结构（去掉所有 `aksrt-comment__*` 类）：
|
|
||||||
```
|
|
||||||
li.comment#comment-{id}（用 WP comment_class()，含 depth-N）
|
|
||||||
└ ul.list-inline > li.comt-main#div-comment-{id}
|
|
||||||
├ div.comment-header.mb10 > div.author-box.flex.ac
|
|
||||||
│ ├ span.avatar-img.comt-avatar > img.avatar（含嵌套 ul.avatar-icontag 徽章位）
|
|
||||||
│ ├ <name>（置顶 badge.badge-topping.jb-blue + a.text-ellipsis.font-bold / b.mr6 + 作者 badg）
|
|
||||||
│ └ a.action.action-comment-like.muted-2-color.flex0.ml10（svg like + <count>）
|
|
||||||
└ div.comment-footer
|
|
||||||
├ div.mb10.comment-content#comment-content-{id}
|
|
||||||
└ div.comt-meta.muted-2-color
|
|
||||||
├ span.comt-author（time-ago，title=完整时间）· IP 属地 badg · span @父级作者
|
|
||||||
├ span.badge-approve > span.badg.c-red.badg-sm「待审核」
|
|
||||||
├ span.reply-link > a.comment-reply-link（data-commentid / data-postid）
|
|
||||||
└ span.dropdown.drop-fixed-sm.padding-6（menu_2 ⋮ 菜单：置顶/编辑/通过/删除，wp-ajax-submit 类）
|
|
||||||
子级：li.comment > ul.children > li.comment…
|
|
||||||
```
|
|
||||||
保留 Zibll 的自定义语义标签 `<name>` `<badge>` `<text>` `<count>` 以确保 CSS 选择器 1:1 命中。置顶/点赞/神评等数据仍取自现有 `inc/helpers/comments/actions.php`。
|
|
||||||
|
|
||||||
### 2. 评论区外壳与表单 — `inc/helpers/aksrt-comments.php` + `comments/form-parts.php` 重写
|
|
||||||
- 外壳：`div.theme-box#comments` > `div.box-body.notop > div.title-theme`（+ `<small>共N条</small>`/抢沙发）> `div.no_webshot.main-bg.theme-box.box-body.radius8.main-shadow`
|
|
||||||
- 登录门槛：`div.comment-signarea.text-center` > h3 + 登录/注册按钮 + 社交登录（复用现有 oauth 输出，仅换外壳类名）
|
|
||||||
- 移动端假输入：`div.flex.ac.jsb.virtual-input`（`fixed-input="#respond"`）
|
|
||||||
- 表单 `div#respond.mobile-fixed > form#commentform`：
|
|
||||||
- `div.flex.ac > div.comt-title.text-center.flex0.mr10`（comt-avatar 60px + 昵称）+ `div.comt-box.grow1`
|
|
||||||
- `div.action-text.mb10.em09.muted-2-color`（回复@xxx）
|
|
||||||
- `textarea.form-control.grin#comment`（Ctrl+Enter 提交）
|
|
||||||
- `div.comt-ctrl.relative`：comt-tips（隐藏字段+nonce）、comt-tips-right（`a.but.c-red#cancel-comment-reply-link` 取消 + `button.but.c-blue.pw-1em.comment-send#submit`）、comt-tips-left（`span.dropup#comment-user-info` 游客姓名/邮箱/网址 line-form 下拉 + 工具栏）
|
|
||||||
- 工具栏按 Zibll `zib_get_input_expand_but()` 结构：`span.dropup.relative > a.but.btn-input-expand.input-{smilie|code|image|link|quick}.mr6` + `div.dropdown-menu`（表情面板 `div.dropdown-smilie.scroll-y.mini-scrollbar > a.smilie-icon[data-smilie] > img`），按现有设置项开关
|
|
||||||
- 列表：`div#postcomments > ol.commentlist.list-unstyled`，过滤器 `div.comment-filter.tab-nav-theme.flex.ac.jsb`（最新/最热 + 只看作者）放在 commentlist 之前、#postcomments 内
|
|
||||||
- 分页：AJAX 模式 `div.theme-pagination.lazyload.ias-pagenav.pagenav > div.order-ajax-next > a.ias-btn 加载更多`；数字模式 `div.pagenav` + paginate_links（>8 页带 `a.pag-jump` 跳页 input）
|
|
||||||
- 空状态：`zib_get_null()` 同款 `img/null.svg` 结构
|
|
||||||
|
|
||||||
### 3. CSS 全量移植 — `assets/css/frontend/comments/`
|
|
||||||
- 把 `zibll/css/main.css` L9411–9660 与移动端 L12470–12560 规则逐条移植为新文件（按现有 shell/list/form/mobile 拆分或单文件 `zibll-comment.css`），选择器保持原样（`#comments .comt-title`、`#postcomments .commentlist > .comment > .list-inline .comment-footer {margin-left:65px; margin-top:-25px}`、`.children {margin-left:86px}`、`.children .children {margin-left:23px}`、`.smilie-icon {width:30px!important}` 等）
|
|
||||||
- 依赖的通用变量（`--main-shadow/--main-border-color/--main-radius/--main-bg-color`）与基础类（`.avatar-img`、`.but`、`.badg`、`.line-form`、`.pagenav`）核对 AKSRT 是否已有；缺的补进对应基础样式文件，值与 Zibll 一致
|
|
||||||
- **删除** 现有 `comments/shell.css`、`comments/mobile-item.css`、`comment-tools.css` 中所有旧评论样式与 `--aksrt-comment-*` 变量，无兼容层
|
|
||||||
- 保持 enqueue 结构（`src/Core/ScriptsPart1b.php` / `ScriptsPart1c.php`）指向新文件
|
|
||||||
|
|
||||||
### 4. JS 选择器对齐
|
|
||||||
- `assets/js/core/comments.js`、`comment-ajax.js`、`comment-tools.js`、`comment-fixed-input.js`、`comment-move-form.js`：全部选择器改为 Zibll 目标（`.commentlist`、`.comment-reply-link`、`#div-comment-{id}`、`.comment-send`、`#respond.mobile-fixed`、`[fixed-input]` 等），提交后的局部插入逻辑改为 Zibll 同款（prepend 到 `.children` 或 `.commentlist`，`slideDown`，15s 冷却倒计时按钮禁用）
|
|
||||||
- REST 端点与 nonce 机制不变；AJAX 分页/排序沿用现有 fragment 管线，仅换容器选择器
|
|
||||||
|
|
||||||
### 5. 资源（按用户确认）
|
|
||||||
- **删除 `assets/img/smilies/` 中现有全部旧表情包资源**，从 `zibll/img/smilies/` 拷贝全套 gif 替换；`content.php` 的 `[g=]` 转换与 data-smilie 表情面板统一指向该目录的 Zibll 文件名列表
|
|
||||||
- 空状态 `null.svg`、点赞/置顶/菜单等 svg 图标按 Zibll 形状补齐到 `assets/img/`
|
|
||||||
|
|
||||||
### 6. 清理与验证
|
|
||||||
- 全库 grep `aksrt-comment__`、`--aksrt-comment-`、`.comments-area`（评论语境）确保零残留（用户中心页的评论条目不在本次范围）
|
|
||||||
- 检查 `tests/widget-system/post-visual-contract.test.cjs` 是否引用旧评论类名，如有则同步更新契约
|
|
||||||
- `php -l` 校验全部改动 PHP 文件；运行 `node --test tests/widget-system/post-visual-contract.test.cjs`
|
|
||||||
- 桌面+移动端断点目测核对 Zibll 截图/本地对照环境（`tests/visual/README.md`）
|
|
||||||
|
|
||||||
## 不做的事
|
|
||||||
- 不写任何双路渲染、旧类名兼容或数据迁移代码
|
|
||||||
- 不动 `src/Core/CommentActions.php` REST 逻辑、管理后台 Vue 设置页（除非契约字段需对齐）
|
|
||||||
- 不动论坛/商铺评论（Zibll 中亦为独立模块）
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
## 修复方案
|
|
||||||
|
|
||||||
### 1. 删除废弃的静态 action 入口
|
|
||||||
|
|
||||||
修改 `assets/js/runtime/main.js`：
|
|
||||||
|
|
||||||
- 完整删除全局 `_win.bd.on('click', '[data-action]', ...)` 委托。
|
|
||||||
- 完整删除仅被该委托调用的 `action_ajax()` 函数。
|
|
||||||
- 保留紧随其后的独立 `[ajax-action]` 处理器以及其他合法的 `data-action` 属性读取。
|
|
||||||
- 不创建 `assets/action/action.php`，不增加兼容代理，不把旧协议映射到新接口。
|
|
||||||
|
|
||||||
仓库内文章互动、评论点赞、关注等已有 WordPress AJAX/REST 实现，因此这是单一路径硬切换。
|
|
||||||
|
|
||||||
### 2. 精确同步运行时压缩产物
|
|
||||||
|
|
||||||
修改 `assets/js/runtime/main.min.js`：
|
|
||||||
|
|
||||||
- 从唯一 `_win.bd.on("click","[data-action]"` 起点，精确删除到下一个 `_win.bd.on("click","[ajax-action]"` 起点之前的旧压缩块。
|
|
||||||
- 不执行全量前端构建，以免覆盖或重新格式化其他已有运行时产物。
|
|
||||||
- 删除后确认 `[ajax-action]` 处理器仍存在，`action_ajax` 和 `/action/action.php` 均消失。
|
|
||||||
|
|
||||||
当前该文件虽然出现在状态列表中，但内容与 HEAD 完全一致，因此可安全形成仅针对旧块的内容差异。
|
|
||||||
|
|
||||||
### 3. 增加硬切换契约测试
|
|
||||||
|
|
||||||
新增 `tests/widget-system/runtime-action-hard-cut-contract.test.cjs`：
|
|
||||||
|
|
||||||
- 同时检查 `main.js` 与 `main.min.js`。
|
|
||||||
- 断言旧全局 `[data-action]` 委托不存在。
|
|
||||||
- 断言 `action_ajax` 不存在。
|
|
||||||
- 断言 `/action/action.php` 不存在。
|
|
||||||
- 断言独立 `[ajax-action]` 处理器仍保留且只有一份。
|
|
||||||
- 不禁止整个仓库使用 `data-action`，避免误伤下载、弹窗和其他新业务属性。
|
|
||||||
|
|
||||||
### 4. 验证
|
|
||||||
|
|
||||||
- 运行新增的 runtime action 契约测试。
|
|
||||||
- 运行全部 `tests/widget-system/*.test.cjs`。
|
|
||||||
- 使用 `rg` 检查源码和压缩产物中不存在 `action/action.php`、`action_ajax` 和旧委托。
|
|
||||||
- 执行 `git diff --check`，确认没有格式问题。
|
|
||||||
- 不做真实视觉验收，不恢复静态 PHP 直连入口。
|
|
||||||
|
|
||||||
### 5. 提交
|
|
||||||
|
|
||||||
从当前 `origin/main` 创建 `worktree/fix-legacy-action-404` 分支，只提交：
|
|
||||||
|
|
||||||
- `assets/js/runtime/main.js`
|
|
||||||
- `assets/js/runtime/main.min.js`
|
|
||||||
- `tests/widget-system/runtime-action-hard-cut-contract.test.cjs`
|
|
||||||
|
|
||||||
现有其他 CSS、JavaScript 状态项和 `.zcode/plans` 文件不进入提交。验证通过后推送该分支到远端。
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
## 目标
|
|
||||||
|
|
||||||
在后台「AKSRT → 功能&权限 → 下载配置」中新增总开关 `enabled`（switch，**默认开启**）。开启 = 现有本站 token 中转下载（`/download/{token}`，别名/次数/有效期生效）；关闭 = 直连模式，下载按钮直接渲染原始下载地址，不再生成本站中转链接。**权限门控保留**（未登录/未购买/非会员仍显示解锁提示，已确认）。不写迁移、不留死代码、不做真实视觉效果验收。
|
|
||||||
|
|
||||||
## 现状（调研结论）
|
|
||||||
|
|
||||||
- 「下载配置」是 SPA 通用 schema 页（`SchemaPage.vue`），PHP schema 在 `src/Admin/Schema/SchemaPermissions.php:73-85`（option `aksrt_download_config`），前端镜像在 `assets/admin/src/schema/sections/permissions/index.js:246-269`
|
|
||||||
- 下载链路：按钮 `data-action="aksrt-download"` → `POST /aksrt/v1/download/request`（`src/Content/Download.php:215`）签发 token → 返回 `home_url('/别名/{token}')` → rewrite + `maybe_serve_download()` 中转（本地流式/302 外链）
|
|
||||||
- 发现死代码：`rest_policy()` + `/download/policy` 路由（全库无调用方）、`aksrt_is_download_alone_page_enabled()`（`inc/helpers/aksrt-pay.php:921`，无调用方）
|
|
||||||
|
|
||||||
## 变更清单
|
|
||||||
|
|
||||||
**1. `src/Admin/Schema/SchemaPermissions.php`（PHP 权威 schema）**
|
|
||||||
- download section version 1.0.0 → 1.1.0
|
|
||||||
- groups 重构（仿 login/moderation 模式）：新 `basic` 组「下载总开关」，字段 `enabled`（switch，default true，help 说明「关闭后下载采用直连，下方链接规则不生效」）；原 `url_alias`/`default_max_uses`/`ttl_minutes` 移入 `rules` 组「链接规则」，各加 `dependsOn: {key: 'enabled', value: true}`
|
|
||||||
|
|
||||||
**2. `assets/admin/src/schema/sections/permissions/index.js`（前端镜像）**
|
|
||||||
- `download.defaults` 增加 `enabled: true`；groups 同步 PHP 双组结构（switch + dependsOn）；更新 description
|
|
||||||
|
|
||||||
**3. `src/Content/Download.php`**
|
|
||||||
- 新增 `public function is_enabled(): bool`：读 `aksrt_download_config`，`enabled` 键缺失视为开启（默认 true），否则 `!empty()` 判定（与 PostDisplay 等现有默认 true 惯用法一致）
|
|
||||||
- 关闭时提前 return：`register_rewrite()`（不注册路由）、`register_routes()`（不注册 `/download/request`）、`maybe_serve_download()`（旧 token 链接失效，含 `?aksrt_dl_token=` 直查）
|
|
||||||
- **删除死代码**：`rest_policy()` 方法与 `/download/policy` 路由注册
|
|
||||||
- token 签发/流式输出等开启路径逻辑不动（现有契约测试正则不受影响）
|
|
||||||
|
|
||||||
**4. `templates/parts/resource-download-box.php`**
|
|
||||||
- 顶部计算 `$direct_download`（`class_exists` 守卫 + `is_enabled()` 取反）
|
|
||||||
- 下载源循环：直连模式且非 need_login 时，渲染 `<a href="{原始url}" target="_blank" rel="nofollow noopener">`（保留网盘识别徽章/着色），提取码旁复用全局 clipboard 委托渲染复制按钮（`data-clipboard-text`，main.min.js 已全局处理）；need_login 分支不变
|
|
||||||
- 直连模式下 `$captcha_active` 置 false（验证码容器成死 UI）
|
|
||||||
- 独立下载页入口（`down_alone_page`）是独立功能，不与本开关耦合
|
|
||||||
|
|
||||||
**5. `inc/helpers/aksrt-pay.php`**
|
|
||||||
- `aksrt_get_paid_download_actions_html()`：直连模式渲染 `<a class="but ...">` 直链替代 token 按钮；提取码/复制按钮逻辑不变
|
|
||||||
- **删除死代码** `aksrt_is_download_alone_page_enabled()`
|
|
||||||
|
|
||||||
**6. `tests/widget-system/download-config-contract.test.cjs`（扩展契约测试）**
|
|
||||||
- 字段对齐测试加入 `enabled => true`（PHP）/ `enabled: true`（JS）
|
|
||||||
- 新增断言：Download.php 含 `is_enabled` 守卫；`/download/policy` 已移除；直连模式下盒模板与付费卡函数含直链 `<a>` 渲染分支
|
|
||||||
|
|
||||||
## 行为语义（写入代码注释与测试预期）
|
|
||||||
|
|
||||||
- 默认开启，存量站点零感知（不迁移 option，键缺失即 true）
|
|
||||||
- 关闭后：无下载计次、无免费额度扣减、无下载就绪通知、无验证码——直连语义的自然结果
|
|
||||||
- 关闭后旧 `/download/{token}` 链接全部失效
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
|
|
||||||
- `php -l` 检查所有改动的 PHP 文件
|
|
||||||
- `node --test tests/widget-system/download-config-contract.test.cjs`，并跑 pay-card-contract、post-visual-contract 确认无回归
|
|
||||||
- `cd assets/admin && npm run build` 重建 SPA（前端 schema 变更需构建生效）；若 `assets/admin/build/` 被 git 跟踪则一并纳入变更
|
|
||||||
- 按要求跳过真实视觉效果验收
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
## 目标
|
|
||||||
|
|
||||||
把"点关注"从同步跑完整结算链(积分+勋章×3遍+等级,约几十条 SQL)优化为:接口只写关注表立即返回,结算在响应送达客户端之后执行。
|
|
||||||
|
|
||||||
## 改动内容(3 个文件)
|
|
||||||
|
|
||||||
### 1. `src/User/Metrics.php` — 删除冗余订阅
|
|
||||||
`on_user_followed()`(Metrics.php:93-98)只做 `reevaluate_medals(following_id)`,而 `BadgeAutoAward::on_follow` 已经评估过该用户——这是同一请求内的第 3 遍重复评估。删除该方法和它的 `add_action` 注册(Metrics.php:34)。`reevaluate_medals` 方法本身保留(点赞/浏览等其他钩子仍在用)。
|
|
||||||
|
|
||||||
### 2. `src/User/BadgeAutoAward.php` — 删除对"关注者"的无效评估
|
|
||||||
`on_follow()`(BadgeAutoAward.php:61-68)同时评估关注者和被关注者,但 `Badges::metric_value` 的全部指标分支(registration_time/checkin/new_post/comment/**followed(被关注数)**/like/views/pay_income/pay_rebate)没有任何一个依赖"关注了多少人"——关注者评估必然零产出。改为只评估 `$following_id`(保留双参数签名以兼容钩子,`unset($follower_id)`)。
|
|
||||||
|
|
||||||
### 3. `src/User/Follow.php` — 结算钩子延迟到响应之后
|
|
||||||
`follow()` 里的 `do_action('aksrt_user_followed', ...)`(Follow.php:50)改为经 `register_shutdown_function` 延迟执行:关闭回调里先调 `fastcgi_finish_request()`(PHP-FPM 下存在)把响应立即送达客户端,再触发钩子跑积分/勋章/等级结算。新增一个 `private static function defer_action(string $hook, int ...$args)` 辅助方法。
|
|
||||||
|
|
||||||
- 非-FPM 环境(无 `fastcgi_finish_request`):退化为 shutdown 时机同步执行,行为与现状等价,无回归。
|
|
||||||
- 不用 `wp_schedule_single_event`:WP-Cron 粒度不可控(禁用循环回执的站点要等系统 cron,积分勋章到账会延迟数分钟),shutdown 方案在所有环境都能即时结算。
|
|
||||||
- `aksrt_user_followed` 仅 Follow.php:50 一处触发,4 个订阅者全部按传入 ID 工作、不依赖请求上下文,延迟执行安全。
|
|
||||||
- 效果:关注接口响应路径只剩 WP REST 启动 + 1 次 SELECT + 1 次 INSERT + 1 次 COUNT(全部命中索引),勋章评估从 3 遍降为 1 遍且不再阻塞响应。
|
|
||||||
|
|
||||||
## 不在本次范围
|
|
||||||
|
|
||||||
前端乐观更新(点击瞬间翻转按钮、失败回滚)——上轮标注为可选项,用户未明确要求;异步化后反馈延迟已大幅下降,且与全站点赞/收藏的交互模式保持一致。需要可后续单独做。
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
|
|
||||||
- `php -l` 检查 3 个改动文件。
|
|
||||||
- 浏览器实测:关注点击后按钮/Toast 应明显变快(仅剩接口往返);稍后刷新可见积分/勋章/等级照常到账(结算仍在同一请求生命周期内完成,只是后置)。
|
|
||||||
- 取消关注路径不受影响(本就无钩子)。
|
|
||||||
|
|
||||||
## 提交
|
|
||||||
|
|
||||||
单条提交:`perf(user): 关注结算异步化并去除冗余勋章评估`。
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
# 修复前台文章卡片无刷新加载出现空位的问题
|
|
||||||
|
|
||||||
## 根因
|
|
||||||
|
|
||||||
规范分页控件（`aksrt_render_pagination()` 输出的 `.ajax-pag[data-aksrt-pagination]`，内含 `.next-page.ajax-next`）携带了遗留引擎的触发类 `ajax-next`。全站加载的 `main.min.js` 在 body 上委托监听 `.ajax-next` 点击（另有 IAS 无限滚动路径用 jQuery 模拟点击 `.ajax-next/.ias-btn`），导致每次"加载更多"被两套引擎同时处理：
|
|
||||||
|
|
||||||
1. **规范引擎**（pagination.js）：POST `aksrt_load_more_posts`，把卡片正确插入 `.ajax-pag` 之前；
|
|
||||||
2. **遗留引擎**（main.min.js `post_ajax()`）：抓取整页 `?paged=2` HTML，**先删除 `.ajax-pag`**，把占位加载器、重复的一批卡片和一个新的**块级** `.ajax-pag` div 插到最后一张卡之后。
|
|
||||||
|
|
||||||
卡片网格是 inline-block 布局（`width: calc(33.333% - 16px)`），块级分页 div / 重复批次插入流中会强制换行 → 网格中出现空位（即"隔出一个卡片位置"），且第 2 页内容被加载两次。评论分页（`inc/helpers/template-tags/search-meta.php:533`）已用 `order-ajax-next` + `ias-btn` 避开遗留引擎，文章分页是唯一例外。
|
|
||||||
|
|
||||||
另经确认：生产环境实际生效的懒加载运行时是 main.min.js 内置版（`assets/js/lazysizes.js` 无任何 enqueue），其 IAS 自动加载走 jQuery 模拟点击，只到得了遗留引擎——所以无限滚动模式目前完全由遗留引擎执行。若只摘掉 `ajax-next` 类而不接管 IAS 触发，无限滚动会失效，因此两处改动必须配套。
|
|
||||||
|
|
||||||
## 修改内容（4 个文件）
|
|
||||||
|
|
||||||
### 1. `inc/helpers/template-tags/pagination-permissions.php:123`
|
|
||||||
`.next-page` 包装类的 `ajax-next` → `order-ajax-next ias-btn`：
|
|
||||||
- 移除遗留引擎的点击触发 token（手动点击与 IAS 模拟点击双双失效于遗留引擎）；
|
|
||||||
- `order-ajax-next` 复用现有按钮样式 `.theme-pagination .order-ajax-next a`（main.css:9659+），**零 CSS 改动**；
|
|
||||||
- `ias-btn` 保持 main.min.js 的 IAS 匹配器仍能找到元素（其后续 jQuery 点击成为无害空操作），且 pagination.js 的 clickTarget 选择器 `.next-page.ajax-next, .ias-btn` 原生支持，**零 JS 选择器改动**；
|
|
||||||
- 与评论分页的既有模式完全一致。
|
|
||||||
|
|
||||||
### 2. `assets/js/core/pagination.js`
|
|
||||||
在点击绑定块后新增容器级 `lazybeforeunveil` 监听（仅当服务端输出了 `lazyload` 契约类时挂载）：unveil 事件由 main.min.js 内置 lazySizes 原生派发（可冒泡），监听到后设置 `lazyAuto` 并原生 `click()`，把无限滚动自动加载**收归规范引擎**的既有点击管线（复用 loading 守卫、iasMax 上限、按钮状态机）：
|
|
||||||
```js
|
|
||||||
if (container.classList.contains("lazyload") || clickTarget.classList.contains("lazyload")) {
|
|
||||||
container.addEventListener("lazybeforeunveil", function (e) {
|
|
||||||
if (e.target !== container && e.target !== clickTarget) return;
|
|
||||||
clickTarget.dataset.lazyAuto = "1";
|
|
||||||
clickTarget.click();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
```
|
|
||||||
附带修复：评论分页的 IAS 自动加载此前同样到不了规范引擎（jQuery 模拟点击不可见），此监听一并接管。
|
|
||||||
|
|
||||||
### 3. `search.php:112-118` — 消除双层包裹
|
|
||||||
去掉外层冗余 `<div class="posts-row mtn6">`，把 `mtn6` 直接传入 `aksrt_render_post_list(['wrapper_class' => 'mtn6'])`。这样规范引擎的 `previousElementSibling` 目标解析落在真正的卡片网格上，追加的卡片与首页批在同一 inline-block 网格内连续排布（此前新卡片会追加为内层网格块的兄弟节点，卡片模式下在分页边界处出现空位）。ajax-list.js（搜索 tab 切换的实际引擎）用 `querySelectorAll('.ajax-item')` 提取、其替换流程本身就会把卡片拍平到容器层，结构兼容。
|
|
||||||
|
|
||||||
### 4. `tests/widget-system/post-visual-contract.test.cjs:238`
|
|
||||||
- 断言 `/class="next-page ajax-next/` → `/class="next-page order-ajax-next ias-btn/`；
|
|
||||||
- 新增 `assert.doesNotMatch(php, /next-page ajax-next/)` 锁定规范控件不再携带遗留触发类；
|
|
||||||
- 新增 `assert.match(js, /lazybeforeunveil/)` 锁定 IAS 接管。
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
|
|
||||||
- `php -l inc/helpers/template-tags/pagination-permissions.php` 和 `php -l search.php`
|
|
||||||
- `node --test tests/widget-system/post-visual-contract.test.cjs`
|
|
||||||
- 浏览器实测（桌面 3 列卡片网格）：首页点"加载更多"只发一个 `admin-ajax` 请求、无重复批次、无网格空位、`.ajax-pag` 始终位于网格下方；无限滚动模式每次自动加载一页并在 iasMax 后转手动按钮；搜索页卡片模式追加后与首批网格连续。
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
# 评论区硬切换：1:1 复刻 Zibll（不含表情包/快捷回复）
|
|
||||||
|
|
||||||
## 现状与结论
|
|
||||||
- AKSRT 评论区的 PHP 渲染（`inc/helpers/comments/item.php`、`form-parts.php`、`aksrt-comments.php`）与 JS（`assets/js/core/comments.js` 等走 `aksrt/v1` REST）已是自有代码，DOM 与 Zibll 基本一致（`li#comment-{id} > ul.list-inline > li.comt-main`、`.comment-header/.comment-content/.comt-meta`、`#commentform/.comt-title/.comt-box/.comt-ctrl` 均已对齐）。
|
|
||||||
- **样式仍由 vendored `assets/css/main.min.css` 提供**（拼进全站 `build/public.css`；`comments/shell.css` 头部明文"以 vendor 正版样式为准、禁止复制"）——这是本次硬切换的主体：样式归属权切到自有文件，vendor 副本剥离。
|
|
||||||
- 快捷回复链路完整存在（schema/PHP/JS/CSS），需全链路删除；表情包已被此前的 commit 删除并有契约测试锁定，保持。
|
|
||||||
- 传输层不动：提交/点赞/编辑/删除/置顶仍走 AKSRT REST（含权限回调），不改回 Zibll 的 admin-ajax 协议；UI 与 DOM 对齐 Zibll。
|
|
||||||
|
|
||||||
## 1. CSS 硬切换（主体）
|
|
||||||
- 以参考主题 `C:\Users\Xing\Desktop\zibll\css\main.css` 为准移植评论区规则（与 AKSRT vendored 副本 diff 后以参考版为准）：
|
|
||||||
- 新建 `assets/css/frontend/comments/layout.css`：桌面主段（AKSRT main.css 约 9273–9510 对应段：`#comments/#postcomments/#respond/#comment/.commentlist/.comt-*/.comment-*/.comment-signarea/.children/.comment-footer 缩进` 等）+ 散点规则（`.action-comment-like.action-animation`、`.comment-content .box-img`、`.comment-content a`、`.comment-content pre`）。
|
|
||||||
- 填充 `assets/css/frontend/comments/mobile-item.css`（现为空壳占位）：移动端 `@media` 内评论规则（`.mobile-fixed/.virtual-input/头像缩进/分页` 等，main.css 约 12208 起）。
|
|
||||||
- `shell.css` 重写文件头教条（不再"vendor 提供"），保留 identity chip/medal 补充规则。
|
|
||||||
- **剔除**：`.dropdown-smilie/.smilie-icon/.dropdown-quick-often` 与 `img:not(.smilie-icon)` 类选择器。
|
|
||||||
- 从 vendored `assets/css/main.css`/`main.min.css` 剥离同批评论区域专属规则（死代码清理、消除双路）。保留：`.comment-widget-item/.comment-mini-lists`（侧栏小部件在非 singular 页使用）及共享选择器（`.pagenav/.theme-pagination/.line-form/.author-box/.avatar-img` 等别处仍用）。
|
|
||||||
- 先校验 `main.min.css ≙ minify(main.css)`（esbuild dry-run diff，防漂移），剥离后重新生成 `main.min.css`，再跑 `node tools/build-public-assets.mjs` 重出 bundle。
|
|
||||||
|
|
||||||
## 2. Markup 1:1 对齐（PHP 小增量）
|
|
||||||
- `item.php`：点赞按钮对齐 Zibll `zib_get_comment_like`（SVG 图标 + `<text></text><count>N</count>`，保留 AKSRT `data-comment-action` 接线）；置顶/批准/菜单/注册图标由 FA 换成 Zibll SVG——新增小助手（如 `inc/helpers/comments/icons.php`）移植 `zib_get_svg` 所需 glyph（like/topping/approve/menu_2/signup）；时间/回复链接 tooltip 属性对齐。
|
|
||||||
- `aksrt-comments.php` + `form-parts.php`：
|
|
||||||
- `!comments_open()` 时整体不渲染（Zibll 行为；当前会渲染标题+列表）。
|
|
||||||
- 工具栏渲染 `code→image→link`，补齐缺失的"链接"按钮（新设置 `comment_link`，默认关——Zibll 默认值即 false）。
|
|
||||||
- 游客 dropup 补"博客地址"字段（新设置 `comment_user_url_s`，默认关，同 Zibll）。
|
|
||||||
- `comt-title` 登录态昵称旁渲染 AKSRT 身份徽章（对应 Zibll VIP 图标位）。
|
|
||||||
|
|
||||||
## 3. 快捷回复全链路删除 + 死代码清理
|
|
||||||
- PHP：`form-parts.php` quick case 与工具栏分支；`aksrt-comments.php` context 的 `quick_s/quick_phrases`；`PostDisplay.php` 的 `quick_phrases` 字段与 `parse_comment_quick_phrases()`；`SchemaPostList.php` 镜像字段。
|
|
||||||
- Vue schema：`assets/admin/src/schema/sections/post-list/comment.js` 删 `comment_quick_s/comment_quick_often`。
|
|
||||||
- JS：`comment-tools.js` 快捷短语插入逻辑；`ScriptsPart1c.php` 删 `aksrtData.commentQuickPhrases`。
|
|
||||||
- 删除死文件：`assets/js/runtime/comment.js(+.min)`、`input-expand.js(+.min)`（已确认无代码引用）。
|
|
||||||
- `aksrt-runtime.js` 的 vendor comment 模块 stub 与委托解绑**保留**（vendor `main.min.js` 仍在全国 bundle，防回潮）。
|
|
||||||
|
|
||||||
## 4. 设置 schema（前后端镜像）
|
|
||||||
- 新增 `comment_link`、`comment_user_url_s` 开关（默认 false），镜像到 `SchemaPostList.php` 与 `PostDisplay::get_comment_display_settings()`；`npm run build` 重出 admin SPA。
|
|
||||||
|
|
||||||
## 5. 测试
|
|
||||||
- 更新 `comment-smilies-removal-contract.test.cjs`（文件清单移除已删 runtime 存档）。
|
|
||||||
- 新增 `tests/widget-system/comment-hard-cut-contract.test.cjs`：自有 comments CSS 含关键选择器清单；vendor main.css/min 不再含评论区选择器、仍含 `.comment-widget-item`；全库无快捷回复 token（`comment_quick_s/quick-reply-item/dropdown-quick-often/commentQuickPhrases/quick_phrases` 等）；死文件不存在；markup 契约（`<count>`/SVG、工具栏 code/image/link 且无 quick/smilie）。
|
|
||||||
|
|
||||||
## 6. 构建与验证（不做视觉验收）
|
|
||||||
- `php -l` 全部改动 PHP；`node --test` 相关契约测试；`node tools/build-public-assets.mjs`；`npm run build`（admin）。
|
|
||||||
- 不启用 Docker 视觉对比环境（按用户要求）。
|
|
||||||
|
|
||||||
## 风险与对策
|
|
||||||
- vendor main.css 手术：先 min-sync 校验；剥离仅限评论专属选择器，逐个 grep AKSRT 模板确认无跨区使用；剥离后选择器清单复核。
|
|
||||||
- 评论区规则的 CSS 变量（`var(--…)`）与 bootstrap 类来自 bundle 中更早加载的 tokens.css/bootstrap，`aksrt-comments` 在其后加载，无影响。
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
# 公开用户主页去参数化 + 全链路无刷新加载
|
|
||||||
|
|
||||||
## 目标
|
|
||||||
|
|
||||||
`/author/demo/` 的 URL 永远干净（无 `?tab=`、`follow_sub`、`follow_page`、`posts_page` 等），Tab 切换、粉丝/关注子切换、各面板分页全部走 REST AJAX 无刷新加载。单路径实现，不写双路/兼容/迁移代码。
|
|
||||||
|
|
||||||
现状：主 Tab 已是 DOM 切换，但 `author.js` 会把 `?tab=` 写进 URL；follow 子切换和 comments/follow 分页是带参整页链接；posts/favorites 分页走 `aksrt_render_pagination()`（numbered 模式产出 `?posts_page=N` 链接；load_more/infinite 走 admin-ajax）。
|
|
||||||
|
|
||||||
## 服务端
|
|
||||||
|
|
||||||
### 1. 上下文构建 — `inc/helpers/aksrt-user-home.php`
|
|
||||||
- `aksrt_get_user_home_page_context()` 删除全部 `$_GET` 读取（第 104、134-136 行）：`active_tab` 恒等于 `default_tab`，三个 page 恒为 1（保留键，供 REST 覆写）；新增 `follow_page => 1`、`follow_sub => 'followers'` 键。
|
|
||||||
- 新增 `aksrt_render_user_home_pagination(int $total, int $current)`：输出 `<nav class="profile-pagination uh-pagination">` + `<button type="button" class="page-numbers" data-uh-page="N">`（当前页带 `current` 类，含 `‹ ›` 前后页），复用现有 `.profile-pagination` 样式（lists.css:331+）。
|
|
||||||
- 新增 `aksrt_capture_user_home_panel(string $tab, array $ctx): string`：`locate_template('templates/parts/user-home/panel-{$tab}.php')` + ob_start 捕获（仿 `aksrt_capture_user_center_panel`，aksrt-user-center.php:199）。
|
|
||||||
|
|
||||||
### 2. 面板模板重构 — `templates/parts/user-home/`
|
|
||||||
- 删除 `panels-core.php`，拆为按面板 body 模板：`panel-posts.php`、`panel-comments.php`、`panel-favorites.php`、`panel-credits.php`；`panel-follow.php` 改为纯 body（去掉外层 wrapper，第 21-23 行 `$_GET` 读取改为从 `$args` 取 `$follow_page`/`$follow_sub`）。
|
|
||||||
- `page-user-home.php`：dashboard 根节点加 `data-user-id="<?php echo (int) $user_id; ?>"`；循环 `$enabled_tabs`，对存在 body 模板的 tab 输出 `<div id="panel-{tab}" class="dashboard-panel…">` wrapper + `get_template_part('templates/parts/user-home/panel', $tab, $ctx)`。
|
|
||||||
- 各 body 分页统一改用 `aksrt_render_user_home_pagination()`：
|
|
||||||
- posts/favorites 不再用 `aksrt_render_pagination()`（本页退出全站三模式分页体系）；
|
|
||||||
- comments 不再用 `aksrt_render_profile_pagination()`（该函数保留，用户中心仍在用）。
|
|
||||||
- `panel-follow.php` 子切换 `<a href="?tab=follow&…">`（第 40、47 行）→ `<button type="button" data-uh-sub="followers|following">`；`paginate_links`（第 63-69 行）→ 新分页渲染器。
|
|
||||||
|
|
||||||
### 3. REST 端点 — `src/User/Home.php`（仿 `src/User/Center.php:34-110`）
|
|
||||||
- `init()` 挂 `rest_api_init`；路由 `GET aksrt/v1/user-home/panel/(?P<user_id>\d+)/(?P<tab>[a-z0-9_-]+)`，query 参数 `page`（int ≥1）、`sub`（followers|following），`permission_callback => '__return_true'`（公开数据）。
|
|
||||||
- `rest_panel()`：校验用户存在 → `aksrt_get_user_home_page_context()` 重建上下文 → 用请求参数覆写 `active_tab`、对应 page、`follow_sub` → tab 不在 `enabled_tabs`（如 credits 非本人）返回 404 → 捕获 body → 返回 `{success:true, data:{tab, html}}`。
|
|
||||||
|
|
||||||
## 前端 — `assets/js/author.js`
|
|
||||||
|
|
||||||
- 删除 `updateTabUrl()`（第 15-24 行）与 `resolveInitialTab()`（第 70-73 行）：不再读写任何 URL 参数，初始态以服务端渲染的 `is-active`/`data-default-tab` 为准。
|
|
||||||
- 新增 `loadPanelBody(tab, page, sub)`：`fetch(aksrtData.apiUrl + '/user-home/panel/{data-user-id}/{tab}?page=N(&sub=X)', {credentials:'same-origin', headers:{'X-WP-Nonce': aksrtData.restNonce}})` → `panel.innerHTML = data.html` → `AksrtFrontend.rehydrate(panel, 'ajax')`；per-panel 请求去重防竞态（仿 user-center.js `_aksrtPanelRequest`）；`is-loading` 态 + 失败 notyf 提示。
|
|
||||||
- dashboard 根上事件委托（覆盖 AJAX 注入的新按钮）：
|
|
||||||
- `[data-uh-sub]` → 加载 follow 面板 `sub=X, page=1`；
|
|
||||||
- `[data-uh-page]` → `btn.closest('.dashboard-panel')` 得 tab，`panel.dataset.uhSub`（默认 followers）得子项，加载对应页。
|
|
||||||
- URL 永不变更（无 pushState/replaceState）。`follow.js` 是 document 级委托，注入的 minicard 关注按钮自动可用，无需改动。
|
|
||||||
|
|
||||||
## 附带清理与 CSS
|
|
||||||
|
|
||||||
- `templates/parts/submit/editor-main.php:106-108`：「查看草稿」现指向公开主页 + `?tab=post&post_status=draft`（公开主页从未支持该参数，本就错位）。改为 `add_query_arg('post_status', 'draft', aksrt_get_user_center_tab_url('posts'))`（用户中心支持该过滤，posts-list.php:14-16）。
|
|
||||||
- `assets/css/routes/user-home.css`：`button.page-numbers` 复位 + hover 态（现 hover 选择器只覆盖 `a.page-numbers`）；`.uh-follow__subtab` 改 button 后的复位；`.dashboard-panel.is-loading` 半透明过渡。
|
|
||||||
|
|
||||||
## 测试与验证
|
|
||||||
|
|
||||||
- 更新 `tests/widget-system/post-visual-contract.test.cjs`：移除 `panels-core.php`/`page_var` 断言（第 39、205、222-224、328-330 行），改为断言：各 `panel-*.php` body 模板存在且调用 `aksrt_render_user_home_pagination`；user-home 模板无 `$_GET`/`add_query_arg`；author.js 无 `searchParams`（防回归契约）。
|
|
||||||
- `php -l` 全部改动 PHP 文件；`node --test tests/widget-system/post-visual-contract.test.cjs`。
|
|
||||||
|
|
||||||
## 明确的行为变化（单路径的直接结果）
|
|
||||||
|
|
||||||
- 公开主页 posts/favorites 分页不再跟随后台「文章分页模式」（numbered/加载更多/无限滚动）设置，统一为本页 AJAX 数字分页。
|
|
||||||
- 刷新/分享/回退永远回到默认 Tab 第 1 页（URL 无状态，需求本身决定）。
|
|
||||||
- 旧外链 `?tab=follow` 不解析不重定向，按默认 Tab 加载（无兼容代码）。
|
|
||||||
@@ -1,42 +0,0 @@
|
|||||||
# 复刻 Zibll 粉丝/关注用户列表（公开主页 follow TAB）
|
|
||||||
|
|
||||||
## 问题根源
|
|
||||||
|
|
||||||
`templates/parts/user-home/panel-follow.php:46-65` 手写的列表 markup（`.uh-follow__list/item/avatar/name`）在全仓库没有任何 CSS 定义，头像+用户名以内联文本堆叠显示。列表项也只有头像和用户名，没有 Zibll 的卡片结构。
|
|
||||||
|
|
||||||
关键事实：AKSRT 已 vendored Zibll 的 `main.css`（`.author-minicard` 卡片规则、工具类齐全），且 `inc/helpers/aksrt-graphic-card.php:215` 已有 `aksrt_author_minicard()` —— Zibll `zib_author_card()` 的移植版（42px 懒加载头像、用户名+勋章/认证/等级图标、逐项关注按钮、个性签名一行省略、默认文案"这家伙很懒，什么都没有写…"），搜索页在用。**修复 = 粉丝/关注列表改走这条既有链路**，不新写卡片样式。
|
|
||||||
|
|
||||||
## 改动清单
|
|
||||||
|
|
||||||
### 1. `templates/parts/user-home/panel-follow.php`（核心）
|
|
||||||
- 列表循环改为 `aksrt_author_minicard((int) $row['user_id'])`，删除手写的 `.uh-follow__item/avatar/name` markup（渲染链路与搜索页用户列表完全一致）。
|
|
||||||
- 子切换复刻 Zibll 结构（`zib-author.php:407-410`）：居中文字链接「粉丝 N | 关注 N」（`list-inline splitters` + 激活 `focus-color` / 非激活 `muted-color`），**顺序改为粉丝在前、默认子列表改为粉丝**（Zibll 逻辑：TAB 名"粉丝"、默认显示粉丝列表，`zib_get_follow_user_list` 默认 `type='followed'`）。链接仍走现有 `?follow_sub=&follow_page=` 路由。
|
|
||||||
- 空状态图标换心形 SVG（见第 6 条），继续用 `aksrt_render_profile_empty` 组件（对齐 Zibll null-love 爱心语义）。
|
|
||||||
- 分页保持 `paginate_links` 服务端翻页：Zibll 的 AJAX"加载更多"框架（post_ajax/ajax-next）未移植进 AKSRT（main.js 仅 27 行），且公开主页所有 TAB 统一为服务端渲染 + URL 参数翻页，不为此引入独立 AJAX 体系。
|
|
||||||
|
|
||||||
### 2. `inc/helpers/aksrt-graphic-card.php` — `aksrt_author_minicard()`
|
|
||||||
- 关注按钮改为**服务端渲染真实状态**（复刻 Zibll 逻辑）：已登录且 `\AKSRT\User\Follow::is_following(current, target)` 为真时输出 `is-following` class +「已关注」文案。消除每次进页"全部显示关注→异步闪变"的问题。搜索页同样受益。
|
|
||||||
|
|
||||||
### 3. `templates/parts/user/author-hero.php`
|
|
||||||
- hero 关注按钮（L151-163）同样服务端渲染真实初始状态（`is-following` +「已关注」），与卡片按钮同一逻辑。
|
|
||||||
|
|
||||||
### 4. `assets/js/follow.js`
|
|
||||||
- 删除逐按钮 `/follow/status` 轮询（L54-69）：服务端已输出真值，不留双路。保留点击 toggle、`updateFollowButton` 状态切换、用户中心取关移除行、计数更新。
|
|
||||||
|
|
||||||
### 5. `assets/css/routes/user-home.css` — follow 区样式替换
|
|
||||||
- `.uh-follow__list { text-align: center; }`：对齐 Zibll pane 的 `text-center`（卡片为 inline-block，自动 3 列居中换行，移动端单列规则 main.css 已有）。
|
|
||||||
- 子切换：删除旧 pill 按钮样式块（L486-519），替换为 Zibll 风格的少量布局规则（居中、间距），颜色/激活态复用 vendored 工具类。
|
|
||||||
- 同步删除不再被引用的 `__subtab-count` 等旧规则。
|
|
||||||
|
|
||||||
### 6. `inc/helpers/aksrt-user-home.php`
|
|
||||||
- context 数组新增 `svg_empty_follow`（心形 stroke SVG，风格同现有 `svg_empty_post` 等）。
|
|
||||||
|
|
||||||
## 不做的事（明确排除）
|
|
||||||
- 不引入 AJAX"加载更多"（无框架基础，破坏公开主页统一服务端分页架构）。
|
|
||||||
- 不动数据层 `src/User/Follow.php`（`get_user_list` 已提供所需 user_id；徽章/签名由 minicard 自行取）。
|
|
||||||
- 不写任何双路、兼容、迁移代码：旧的手写列表 markup 和 pill 子切换样式直接替换删除。
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
- `php -l` 检查全部改动的 PHP 文件。
|
|
||||||
- `node --test tests/widget-system/*.test.cjs` 确认不破坏既有契约（无该面板专属测试）。
|
|
||||||
- 桌面 + 移动宽度下目视核对：卡片 3 列/单列、关注按钮初始状态、子切换、空状态、分页。
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
## 目标
|
|
||||||
将 `inc/core-hooks/` 下的三个分片收口为唯一实现文件 `inc/core-hooks.php`，不保留兼容 loader、旧分片 stub 或双路加载；同时清理有充分证据确认无效的代码，不做真实浏览器/视觉效果验收。
|
|
||||||
|
|
||||||
## 实施步骤
|
|
||||||
1. **合并实现文件**
|
|
||||||
- 将 `inc/core-hooks/part-1.php`、`part-2.php`、`part-3.php` 的有效实现按现有加载顺序拼接到 `inc/core-hooks.php`。
|
|
||||||
- 保留现有 `defined('ABSPATH') || exit;` 保护和原有 hook 注册顺序，避免改变 WordPress 回调优先级、字符串回调和匿名闭包的行为。
|
|
||||||
- 在合并文件中保留评论过滤、SMTP/邮件、分类 term meta、资源归档/搜索、Enlighter 白名单、后台互动列、Gutenberg、付费内容等仍被运行时代码或测试覆盖的实现。
|
|
||||||
- 去除原文件的 “Shell loader / split into sub-files” 说明和三个 `require_once`，将文件头改为描述单一核心 hooks 文件的注释，避免留下已不存在的拆分结构说明。
|
|
||||||
|
|
||||||
2. **清理明确死代码**
|
|
||||||
- 删除 `part-2.php` 中注册 `wp_head` 调用未定义 `aksrt_print_win_var()` 的 legacy runtime bridge；仓库内只有该调用，没有定义、生产者或测试，且 `function_exists()` 使其当前为空操作。
|
|
||||||
- 删除 `part-3.php` 中原样返回模板的 `single_template` no-op 过滤器；它不改变模板选择，且没有其他实现依赖。
|
|
||||||
- 删除随之失去运行时意义的纯注释占位块（评论提交说明），不触碰实际由 `Moderation` 等模块实现的评论校验。
|
|
||||||
- 不删除后台互动列，尽管它读取旧 meta key；这是可见后台行为，且证据只支持“过时/可能失配”，不足以在本次合并中安全移除或重写。也不删除分类旧字段、资源路由、块注册等看似重复但仍有明确消费者的代码。
|
|
||||||
|
|
||||||
3. **删除旧分片**
|
|
||||||
- 删除 `inc/core-hooks/part-1.php`、`inc/core-hooks/part-2.php`、`inc/core-hooks/part-3.php`，使 `inc/core-hooks.php` 成为唯一实现，不做迁移层或双路兼容。
|
|
||||||
|
|
||||||
4. **同步测试引用**
|
|
||||||
- 将以下契约测试中对分片的直接读取改为 `inc/core-hooks.php`：
|
|
||||||
- `tests/widget-system/email-system-contract.test.cjs`
|
|
||||||
- `tests/widget-system/pay-card-contract.test.cjs`
|
|
||||||
- `tests/widget-system/post-visual-contract.test.cjs`
|
|
||||||
- 不改测试断言语义，仅修正因文件收口导致的路径。
|
|
||||||
|
|
||||||
5. **验证**
|
|
||||||
- 对新的 `inc/core-hooks.php` 运行 `php -l`。
|
|
||||||
- 运行上述三个 Node 契约测试，并运行 `tests/widget-system/run.php` 作为已有回归合同检查（若环境依赖导致失败，如实报告）。
|
|
||||||
- 用 `rg` 检查生产代码和测试中不再残留 `core-hooks/part-*.php` 路径；排除 `.git`、`vendor`、`node_modules` 和历史 `.zcode/plans` 文件。
|
|
||||||
- 不启动浏览器、不执行真实视觉效果验收，符合请求约束。
|
|
||||||
|
|
||||||
## 工作区安全边界
|
|
||||||
当前未提交修改仅涉及 `assets/css/build/*`、`assets/js/runtime/*` 和 `.zcode/plans/*`，不涉及本次目标文件；实施时只修改上述 core hooks 文件及三个测试文件，不覆盖或清理现有其他改动。
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
# assets/vendor 全量迁移 + 全仓去 zibll 化
|
|
||||||
|
|
||||||
## 目标布局（类型归位，`git mv` 保留历史）
|
|
||||||
|
|
||||||
| 源 | 目标 | 说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| `assets/vendor/fontawesome5/` | `assets/fontawesome5/` | css/ + webfonts/ 原结构，`../webfonts` 相对引用不变 |
|
|
||||||
| `assets/vendor/zibll/css/`（22 文件） | `assets/css/` 顶层 | bootstrap/animate/swiper/main 等，无命名冲突；`main(.min).css` 的 `url(../img/playing.svg)` 迁后恰好仍指向 `assets/img`，无需改 |
|
|
||||||
| `assets/vendor/zibll/js/**` | `assets/js/runtime/**` | **必须子目录**：assets/js 已有 14 个同名自有文件（author/sign-register/page-navs…）和一个 enlighter/ 目录 |
|
|
||||||
| `assets/vendor/zibll/img/captcha/` | `assets/img/captcha/` | slidercaptcha.js 运行时按 `_win.uri + '/img/captcha/'` 拼接，新 uri=assets 根后自然命中 |
|
|
||||||
| `assets/vendor/zibll/img/{medal,smilies}` | 与 `assets/img/` 哈希比对 | 相同跳过、缺失补齐；**内容不同时以当前实际渲染源为准**（medal/smilies 保现有，user_t.jpg/slider-bg.jpg 以 vendor 版覆盖，因 PHP 默认值当前渲染的是 vendor 版） |
|
|
||||||
| `assets/vendor/zibll/img/playing.svg` 等散图 | `assets/img/` | |
|
|
||||||
| `assets/vendor/zibll/fonts/`（孤儿 2 文件） | `assets/fonts/` | 按"全部迁移"保留 |
|
|
||||||
| `js/libs/{DPlayer,dash.all,flv,hls,vanilla-tilt}.min.js` | **不迁移**（智能去重） | 先哈希验证与 `assets/widgets/third-party/` 字节一致（探索已确认大小一致）；loader.js paths 改指 `'../widgets/third-party/DPlayer.min'` 等（相对 baseUrl）；若任一哈希不符则该文件照常迁入 `runtime/libs/` |
|
|
||||||
|
|
||||||
完成后删除 `assets/vendor/`。
|
|
||||||
|
|
||||||
## 运行时切换（核心链路 `_win.uri`）
|
|
||||||
|
|
||||||
PHP 将 `'uri'` 从 `…/assets/vendor/zibll` 改为 `…/assets`，loader（改造版 RequireJS）以 `baseUrl = _win.uri + '/js'` 解析懒加载模块：
|
|
||||||
|
|
||||||
1. `assets/js/runtime/loader.js`：`baseUrl` 改为 `_win.uri + '/js/runtime'`（paths 表 `'libs/swiper.min'`、`'enlighter/enlighterjs.min'` 等相对值全部随之命中，无需逐条改，除 5 个去重库改 `../widgets/third-party/`）
|
|
||||||
2. `main.js` + `main.min.js`：enlighter CSS 注入 `_win.uri + '/js/enlighter/…'` → `'/js/runtime/enlighter/…'`（swiper CSS 注入 `/css/swiper.min.css` 迁后自然命中，不改）
|
|
||||||
3. 已核实的死引用（`/css/dplayer.min.css` 404、`/action/action.php`、`/yiyan/…`、paths 中 `shop—main`）保持原状不修不扩
|
|
||||||
|
|
||||||
## PHP 引用切换（7 个文件）
|
|
||||||
|
|
||||||
- `src/Core/ScriptsPart1b.php:16-17,23,38-41`、`src/Core/ScriptsPart1c.php:35-42,53`：新变量 `$runtime_uri = $base_uri . '/assets'`、`$fa5_uri = $base_uri . '/assets/fontawesome5'`；jquery/bootstrap/loader/main 路径改 `assets/js/runtime/…`
|
|
||||||
- `inc/core-hooks/part-3.php:52`、`src/Admin/Admin.php:116`：FA5 新路径
|
|
||||||
- `src/Admin/PageConfigMetaBox.php:275,277`、`src/Settings/DisplayPageGroups.php:96,98`、`src/Admin/Schema/SchemaPageDisplay.php:77,123,138,163,190`：`assets/vendor/zibll/img/` → `assets/img/`
|
|
||||||
|
|
||||||
## 全仓去 zibll 清扫（用户已确认含功能性标识符）
|
|
||||||
|
|
||||||
先跑全仓盘点（排除 .git、composer vendor、node_modules、tests/visual、assets/admin/build）：`zibll/Zibll、zib__、zib_ajax、zibllblock、wp-block-zibllblock、.zib-、_zb、Qinver、zibll.com、子比`，产出替换映射并核对目标名无既有冲突（如 `aksrt_ajax`）。统一替换规则：
|
|
||||||
|
|
||||||
- **品牌头注释**：`@Author: Qinver / @Url: zibll.com / @Project: Zibll子比主题` → `@package AKSRT`；swiper 内 `//zibll : 修改内容` 等注释中性化；`main.js:4866` 的 `console.log(' Zibll Theme …')` 及 min 等价物删除
|
|
||||||
- **功能性标识符重命名**（生产端+消费端原子同步，含 min 文件 sed，改后 diff 抽查只允许替换点变化）：
|
|
||||||
- `zibllblock/*` → `aksrtblock/*`；`zibll_block_cat/var` → `aksrt_block_cat/var`；`.wp-block-zibllblock-*` → `.wp-block-aksrtblock-*`（⚠️ 数据库已发布内容中的旧块名将无法渲染，用户已接受且明确不写兼容层）
|
|
||||||
- `'zibll' + type` localStorage 键 → `'aksrt' + type`（游客点赞记录重置，已接受）
|
|
||||||
- `zib__()` i18n 函数 → `aksrt__()`（先定位定义处，全量替换所有调用，含各 .min.js）
|
|
||||||
- `zib_ajax` 等运行时函数按盘点结果同步改名
|
|
||||||
- **AKSRT 自有资产**：`assets/css/frontend/zibll-utilities.css → legacy-utilities.css`、`zibll-compat-vars.css → compat-vars.css`、`footer/zibll-shell.css → footer/shell.css`（含 enqueue_module 调用、handle 派生、测试引用）；`.zib-widget`(19处)/`.zib-slider` → `.aksrt-widget`/`.aksrt-slider`（CSS + PHP 输出标记 + vendor js 选择器同步）
|
|
||||||
- **PHP 变量/注释**：`$zibll_uri` 等改名；所触及文件注释中 Zibll 措辞改写为"legacy runtime"
|
|
||||||
- **admin SPA**：Vue 源内用户可见 zibll 文案改写后 `cd assets/admin && npm run build`
|
|
||||||
- **例外保留**：`tests/visual/`（docker-compose.zibll.yml、zibll-Caddyfile、baseline）指向外部真实 Zibll 对照主题，属产品名引用，不改
|
|
||||||
|
|
||||||
## 测试同步
|
|
||||||
|
|
||||||
- `tests/navigation/zibll-navigation-contract.test.cjs`（本地未跟踪）：所有 vendor 路径 → 新路径；walk 根改 `assets/js/runtime`（js）与 `assets/css` 顶层（css）；新增断言 `assets/vendor` 目录不存在；文件更名 `legacy-navigation-contract.test.cjs`
|
|
||||||
- `tests/widget-system/{post-visual,toast,page-display,lazyload}-contract.test.cjs`：loader/main 读取路径更新；toast 的 `$zibll_loader_version`/`$zibll_runtime_version` 正则同步新变量名；lazyload `sourceFiles` skip 列表把 `'vendor'` 换成/加上 `'runtime'` 保持语义
|
|
||||||
- 其他 widget-system 测试中引用 zibll 路径/字样的断言同步更新
|
|
||||||
|
|
||||||
## 验证与收尾
|
|
||||||
|
|
||||||
1. `php -l` 逐个检查所有改动 PHP
|
|
||||||
2. `node --test tests/widget-system/post-visual-contract.test.cjs` 等全部受影响 contract 测试 + 更名后的 navigation 测试
|
|
||||||
3. grep 审计：全仓（按上述排除项）`zibll|Qinver|子比|zib__` 零残留；`assets/vendor` 零引用
|
|
||||||
4. 手工 QA 清单：首页/文章页/评论区、FA 图标、滑块验证码图、勋章、enlighter 高亮、DPlayer 视频播放
|
|
||||||
5. 不主动提交；建议单原子 commit：`refactor(assets): vendor 资产迁入标准目录并全仓去除 zibll 标识`（移动+切换+清扫+测试必须同 commit 才能保持可用）
|
|
||||||
|
|
||||||
## 风险提示（用户已确认接受）
|
|
||||||
|
|
||||||
- 数据库中已存 `zibllblock/*` 块的旧文章渲染损坏（无兼容层）
|
|
||||||
- 游客 localStorage 点赞/收藏记录重置
|
|
||||||
- min 文件 sed 属精细操作，逐文件 diff 验证
|
|
||||||
@@ -1,23 +0,0 @@
|
|||||||
1. 余额页改为单一路径 DOM 记录切换
|
|
||||||
- 以 `inc/helpers/user-center-renderers/profile-credits.php` 现有 `data-aksrt-asset-tab` / `data-aksrt-asset-pane` 结构为唯一 UI 状态源，保持积分记录、余额记录、积分任务都通过按钮事件切换，不再依赖 URL hash 或 query。
|
|
||||||
- 在 `assets/js/credits.js` 扩展现有 `initAssetTabs()`：拦截记录分页链接，阻止整页导航；读取分页链接的页码/资产类型，调用当前已有的 `/user-center/panel/credits` REST 面板接口，通过响应 HTML 更新 `#panel-credits` 的 DOM；更新后重新绑定 tab，并清理地址栏中 `wallet_page`、`credits_page`、`points_page` 等历史参数。
|
|
||||||
- 将 PHP 记录渲染改为读取由 REST 请求传入的分页参数，而不是直接读取 `$_GET`；移除 `aksrt_render_profile_pagination()` 生成的 query 链接，改为输出带 `data-aksrt-asset-page`、`data-aksrt-asset-key` 的按钮/链接，供 `credits.js` 处理。
|
|
||||||
- 保留服务端 REST 面板的单一 HTML 输出，不新增 JSON/HTML 双协议；分页请求只使用现有 credits panel endpoint，并在响应后触发既有 `post_ajax.ed → auto_fun` 生命周期。
|
|
||||||
- 用户中心初始化时不再把 `reward_tab`、`commission_page`、`user_page` 等记录参数写回用户地址；对 `/user/balance/` 初次加载清理历史记录参数，避免切换后地址继续携带旧参数。
|
|
||||||
|
|
||||||
2. 首页排序固定为 DOM/AJAX，不保留参数刷新分支
|
|
||||||
- `assets/js/homepage-fixed.js` 删除 `SORT_QUERY_KEY`、`getSortFromUrl()`、`normalizeHomepageUrl()`、`replaceUrlSort()` 及对 `window.location.search` 的依赖；当前排序只从活动排序控件或 `aksrtData.homepageDefaultSort` 读取。
|
|
||||||
- `initSortbar()` 点击排序项后只更新 active 状态并调用现有 `requestHomepagePanel()`，不再调用 `history.replaceState()`，因此地址栏保持无 `home_sort` 参数。
|
|
||||||
- `inc/helpers/aksrt-homepage.php` 排序控件改为无参数链接（或按钮化标记，沿用现有 `data-sort`），删除 `add_query_arg('home_sort', ...)`、`data-sort-ajax` 双路开关和服务端 query override；服务端首页排序只使用 canonical 默认/运行时 override，避免生成旧的参数刷新 URL。
|
|
||||||
- 清理 `src/Core/ScriptsPart1c.php`、`src/Settings/HomeCms.php`、`src/Settings/HomepageReader.php` 中仅服务于可选排序 AJAX 开关的 `homepageSortAjax` / `homepage_sort_ajax_enabled` 死代码及数据注入。
|
|
||||||
- 删除首页排序请求中仅为 URL 刷新服务的 `page_url` 参数，或将其固定为当前无 query 的页面路径；保留 REST 请求内部用于确定上下文的必要字段。
|
|
||||||
|
|
||||||
3. 清理历史 query 分支和测试
|
|
||||||
- 通过 `rg` 找到并删除余额记录的 `wallet_page` / `credits_page` 旧 `$_GET` 分支、首页 `home_sort` query 读取/写入分支，以及相关旧注释/配置字段。
|
|
||||||
- 增加/更新 `tests/widget-system` 契约：余额记录控件必须是 DOM data 事件、分页不得生成 `add_query_arg`/query href；首页排序必须调用 `requestHomepagePanel` 且不得使用 `home_sort`、`replaceState`、`location.search`、`data-sort-ajax`。
|
|
||||||
- 只保留真正需要的 `user-center` REST 参数（例如 revenue 内部分页若仍有明确业务需求则保留在请求体/URL 内部，不写浏览器地址）；不把现有其他用户中心 tab 的必要内部请求参数误删。
|
|
||||||
|
|
||||||
4. 验证
|
|
||||||
- 仅使用 `rg`、Node 契约测试和 PHP 语法检查，不做真实视觉效果验收。
|
|
||||||
- 运行余额/用户中心、首页、生命周期、资产账本相关测试；对所有改动 PHP/JS 执行 `php -l` / `node --check`。
|
|
||||||
- 运行 `git diff --check`，并确认不覆盖工作树中已有的 VIP、runtime、CSS、imgbox 或计划文件改动。
|
|
||||||
Reference in New Issue
Block a user