v3.2.13 图片选项全部自带默认图,新装站点不再出现空洞/破图

根本原因:kratos_option() 运行时只读数据库,`std` 仅在后台表单预填和
「恢复默认」时生效,前台根本读不到。因此新装站点所有图片项都是空值。
另外 isset() 挡不住「用户清空」——of_sanitize_upload() 对空输入返回 '',
键存在且值为空串,调用方传的兜底值被绕过。

同时不能把绝对 URL 写进 std:它会随保存一起写库,主题目录改名/换 CDN/
迁站后永久 404。本站 s_wechat_url / g_donate_alipay / g_donate_wechat
三项就指向已删除的 kratos-master 目录,一直在破图(这三项是 hidden 字段,
后台界面上看不到,所以坏了很久没人发现)。

做法:
- 新增 inc/theme-option-defaults.php,图片默认值注册表(11 项),
  默认图一律运行时给出,不写数据库。
- yang_option_image() 三层判断:空/纯空白 → 默认图;指向已不存在的主题
  目录 → 默认图;文件不存在则不输出地址(避免换来一个 404)。
- 陈旧判断用 get_template()(主题 slug)而非 basename(目录名),避免本地
  开发目录名与 slug 不一致时误伤当前主题自己的图。
- 模板统一走取值函数:header(logo/favicon/banner)、footer(微信码/国旗)、
  404、index、article 缩略图、widgets 头像、page-toolbar、theme-core 赞赏码。
- 国旗与 favicon 的渲染抽成 yang_flag_block() / yang_favicon_tag(),
  空值时不输出空 src / 空 href。
- 后台 9 处 std 改为 yang_options_default_img(),与前台默认图同源;
  该包装函数自带 function_exists 防护,单独加载 theme-options.php 不会 Fatal。

新增图片(本地生成,合计 291KB):default-404 / default-share /
default-empty / default-avatar / default-banner / default-flag / favicon.ico。
favicon 为 WordPress 风格自绘(品牌蓝圆底 + 白色 W),非站长个人专用那张。

验证:run_tests 146 条(新增第 4 组图片默认值 22+ 条);falsify 35 条注入
全部能被抓住(新增 10 条);verify_all.sh 14 组全绿。
This commit is contained in:
2026-10-23 19:50:07 +08:00
parent 704a9346e1
commit ef9a58dc51
19 changed files with 410 additions and 49 deletions
+19 -11
View File
@@ -17,7 +17,11 @@
<meta name="keywords" content="<?php echo keywords(); ?>">
<meta name="description" itemprop="description" content="<?php echo description(); ?>">
<meta name="theme-color" content="<?php echo kratos_option('g_chrome', '#282a2c'); ?>">
<link rel="shortcut icon" href="<?php echo kratos_option('g_icon'); ?>">
<?php
/* favicon:空值时落到主题包内的默认图标,**绝不输出空 href**。
标签由 yang_favicon_tag() 生成,测试直接测那个函数。 */
echo yang_favicon_tag();
?>
<?php wp_head(); wp_print_scripts('jquery'); ?>
</head>
<?php flush(); ?>
@@ -35,9 +39,15 @@ wp_body_open();
<div class="container">
<a class="navbar-brand" href="<?php echo get_option('home'); ?>">
<?php
if (kratos_option('g_logo')){
echo '<img src="' . kratos_option('g_logo') . '">';
}else{
/* Logo 空着时不塞通用图,回落到站点名称文字 —— 一张人人
共用的占位 logo 会让每个站看起来一模一样,比文字更难看。
但不能用 kratos_option('g_logo') 直接判真假:用户在后台
把那一格清空后值是 ''、键却还在,isset 仍成立。
用 yang_option_image() 统一按"空串也算空"判断。 */
$yang_logo = yang_option_image('g_logo');
if ($yang_logo !== '') {
echo '<img src="' . esc_url($yang_logo) . '" alt="' . esc_attr(get_bloginfo('name')) . '">';
} else {
bloginfo('name');
}
?>
@@ -66,13 +76,11 @@ wp_body_open();
<?php if(kratos_option('top_select', 'banner') == 'banner'){ ?>
<div class="banner">
<div class="overlay"></div>
<div class="content text-center" style="background-image: url(<?php
if(!kratos_option('top_img')){
$img = ASSET_PATH . '/assets/img/background.png';
} else {
$img = kratos_option('top_img', ASSET_PATH . '/assets/img/background.png');
}
echo $img; ?>);">
<div class="content text-center" style="background-image: url(<?php
/* 顶部图片导航的背景图。空值(含用户清空那一格)落到包内默认图。
CSS 是 height:300px + background-size:cover,默认图已按
1920x640 压好(见 _tooling 里的生成脚本)。 */
echo esc_url(yang_option_image('top_img')); ?>);">
<div class="introduce animated fadeInUp">
<?php
if (is_category() || is_tag()) {