laoyang
7047ab3ece
需求一：[Archives] 短代码 —— 归档式全站文章列表
· 在文章/页面正文写一行 [Archives]，该位置渲染全站文章的年月归档
· 默认显示今年，按月份归类；每篇带浏览/评论/点赞三个数
· 上下两排各有一组「上一年 / 下一年」按钮（四角），JS 切换不刷新页面
· 地址栏同步 ?arc_year=，刷新与分享链接都能保持同一年
· 只在用到短代码的页面才加载 assets/js|css/archives.js|css
· 参数：year="2025" 指定首年；month="0" 不按月分组
需求二：评论关闭时评论区整块消失
· comments.php 在**任何输出之前** `if (!comments_open()) return;`
—— 零字节，不是空容器、不是 display:none、不留提示文字
· 已有评论的老文章关评论后也不再显示（需求原话：正文之外什么都没有）
· inc/theme-comments.php 的资源守卫与之同口径：关评论时不加载
约 10KB 的 comments.css / comments.js
· 删掉 .comments-closed 样式与两处「评论已关闭」提示分支
开发中实测抓到并修掉的三个真实 bug（都是"测试把期望值写对之后"才显形）：
· 年份标题 / 导航年份过了 number_format_i18n() ⇒ 输出「2,025」，
而 JS 侧 String(year) 输出「2025」⇒ 首屏与切年后不一致
· 月份标题同样过 number_format_i18n()，与 JS 侧 String(m) 口径不一致
· yang_archives_render_nav() 把 ar-nav-top 写死，而下排也调它生成
⇒ 下排被叫成 top（视觉上被更高特异性规则压住，看不出问题）
验证：
归档 _archives_unit.php 94 通过 / 0 失败
_archives_e2e.js 109 通过 / 0 失败
_archives_e2e_falsify.js 反证 25 真红 / 0 无效
_archives_unit_falsify.py 反证 6 真红 / 0 无效
评论 _comments_closed_test.php 54 通过 / 0 失败
_comments_closed_falsify.py 反证 13 真红 / 0 无效
回归 _test_comments.php 64 通过 / 0 失败
_hl_unit_run.py 24 通过 / 0 失败
全量 96 个 PHP 文件语法检查通过；包内 lint 通过
发布 已推 3.2.46 到 /theme-update/，update.json 已落 3.2.46；
服务器 wp-content/themes/kratos_yang/ 仍为 3.2.45（未覆盖）
另：把 _archives_unit.php 从 `__DIR__` 定位改为接受根目录参数，
否则它无法登记进 verify_all.sh，只能手动跑（手动跑 = 长期不跑）。
5 个新套件已登记进 verify_all.sh（2j ~ 2o）。
99 lines
4.4 KiB
PHP
99 lines
4.4 KiB
PHP
<?php
|
||
/**
|
||
* 模板函数
|
||
* @author Yongquan Yang <yangyq.net>
|
||
* @license MIT License
|
||
* @version 2020.03.17
|
||
*/
|
||
|
||
define('THEME_VERSION', wp_get_theme()->get('Version'));
|
||
|
||
// 主题配置
|
||
require get_template_directory() . '/inc/options-framework/autoload.php';
|
||
|
||
// 自定义代码（CSS / JS，存选项表而非主题目录）
|
||
require get_template_directory() . '/inc/theme-custom-code.php';
|
||
|
||
// 更新配置
|
||
require get_template_directory() . '/inc/update-checker/autoload.php';
|
||
|
||
// 核心配置
|
||
require get_template_directory() . '/inc/theme-core.php';
|
||
|
||
// 图片类选项的默认值（Logo/favicon/404/分享图… 空值时落到包内默认图）。
|
||
// 必须排在 theme-core.php 之后：它要用 ASSET_PATH 与 kratos_option。
|
||
require get_template_directory() . '/inc/theme-option-defaults.php';
|
||
|
||
// 站点配置
|
||
require get_template_directory() . '/inc/theme-setting.php';
|
||
|
||
// 纪念日自动哀悼（按日期判断，需在 theme-setting 之后，
|
||
// 因为它用到 kratos_option）
|
||
require get_template_directory() . '/inc/theme-mourning.php';
|
||
|
||
// 哀悼说明页（固定路径 /memory，由主题判定路由，不写数据库）
|
||
require get_template_directory() . '/inc/theme-mourning-page.php';
|
||
|
||
// 文章配置
|
||
require get_template_directory() . '/inc/theme-article.php';
|
||
|
||
// 代码高亮：highlight.js 自托管，接管正文与评论区的所有代码块。
|
||
// 必须排在 theme-core.php 之后：它要用 kratos_option 读三个开关。
|
||
// 必须**早于 theme-comments.php**：评论区渲染要调 yang_hl_render_block()。
|
||
// 挂在 the_content 优先级 9 —— 早于 wpautop(10)，
|
||
// 因为裸 <pre>（站内实测 80 个，占 28.2%）一旦先被 wpautop 包进 <p>，
|
||
// 行首缩进就会被 white-space:normal 折叠掉，代码完全没法读。
|
||
require get_template_directory() . '/inc/theme-highlight.php';
|
||
|
||
// 评论区（统一渲染 + AJAX + 评论通知）。
|
||
// 必须在 theme-article.php 之后：后者不再定义评论函数，
|
||
// 但评论模板 comments.php 里引用的 comment_callbacks 由本文件提供。
|
||
// 也必须早于 theme-mail.php（评论通知要调 yang_mail_render）。
|
||
require get_template_directory() . '/inc/theme-comments.php';
|
||
|
||
// 小工具配置
|
||
require get_template_directory() . '/inc/theme-widgets.php';
|
||
|
||
// 文章增强
|
||
require get_template_directory() . '/inc/theme-shortcode.php';
|
||
|
||
// 文章目录（[TOC] 短代码）
|
||
require get_template_directory() . '/inc/theme-toc.php';
|
||
|
||
// 归档式文章列表（[Archives] 短代码）：年/月归类 + 浏览/评论/点赞计数 + 四角年份切换。
|
||
// 必须排在 theme-article.php 之后：计数读的是它写的 post meta（views / love）。
|
||
// 也必须排在 theme-core.php 之后：它用 ASSET_PATH 与 THEME_VERSION 挂资源。
|
||
require get_template_directory() . '/inc/theme-archives.php';
|
||
|
||
// 添加导航目录
|
||
require get_template_directory() . '/inc/theme-navwalker.php';
|
||
|
||
// 对象存储配置
|
||
require get_template_directory() . '/inc/theme-dogecloud.php';
|
||
|
||
// CDN 加速（地址改写：CDN 地址 + 白名单 + 黑名单）。
|
||
// 必须排在 theme-core.php 之后：它要用 kratos_option 与 wp_parse_url。
|
||
// 挂在 template_redirect 上开输出缓冲，所以本文件晚加载不影响生效。
|
||
require get_template_directory() . '/inc/theme-cdn.php';
|
||
|
||
// 自动头像：为没有头像的访客按邮箱生成一张（纯 PHP，零外网请求）。
|
||
// 必须排在 theme-core.php 之后：它要用 kratos_option。
|
||
// 它挂在 get_avatar 过滤器上（优先级 20，晚于 theme-core.php 里
|
||
// 那个改 Gravatar 域名的过滤器），所以要保证 theme-core.php 先加载。
|
||
require get_template_directory() . '/inc/theme-avatar.php';
|
||
|
||
// 图片灯箱：正文图片点击在当前页放大、多图轮播、键盘切换。
|
||
// 必须排在 theme-core.php 之后：它要用 ASSET_PATH 与 THEME_VERSION。
|
||
// 必须排在 theme-article.php 之后：它挂在 the_content 优先级 20，
|
||
// 要去掉 imgnofollow()（优先级 10）给图片链接加的 target="_blank"。
|
||
require get_template_directory() . '/inc/theme-lightbox.php';
|
||
|
||
// 邮件模板：必须先于 theme-mail.php 加载，
|
||
// 因为后者在发信时会调用 yang_mail_render()
|
||
require get_template_directory() . '/inc/theme-mail-template.php';
|
||
|
||
// 邮件治理：统一接管发信通道、去重、关掉重复通知
|
||
require get_template_directory() . '/inc/theme-mail.php';
|
||
|
||
// SMTP 配置（连通性相关，实际接管在 theme-mail.php）
|
||
require get_template_directory() . '/inc/theme-smtp.php'; |