
默认情况下,部分主题(如 Twenty Twenty-One)会禁用首页的自定义 Logo 链接;本文详解如何通过子主题重写 custom-logo 支持参数,强制在首页保留 Logo 的主页链接功能。
默认情况下,部分主题(如 twenty twenty-one)会禁用首页的自定义 logo 链接;本文详解如何通过子主题重写 `custom-logo` 支持参数,强制在首页保留 logo 的主页链接功能。
WordPress 的 the_custom_logo() 函数默认会在首页自动移除 <a></a> 标签包裹(即不链接),前提是当前主题声明了 'unlink-homepage-logo' => true 这一支持选项。Twenty Twenty-One 主题正是这样配置的——它在 functions.php 中通过 add_theme_support('custom-logo', [...]) 启用了该行为,导致即使你在首页调用 the_custom_logo(),输出的 Logo 也只是纯 <img alt="如何让 WordPress 自定义 Logo 在首页也保持可点击并跳转至主页" >,没有跳转能力。
要修复这个问题,不能直接修改父主题文件,而应在子主题中覆盖该设置。关键在于:先移除父主题注册的 custom-logo 支持,再以新参数重新注册,将 'unlink-homepage-logo' 显式设为 false。
但需特别注意:这段代码不能直接写在子主题 functions.php 的顶层作用域(即函数外部),否则可能因执行时机过早而失效。必须挂载到 after_setup_theme 动作钩子上,确保在父主题完成 add_theme_support 后再执行覆盖逻辑。
以下是推荐的实现方式(请将以下代码添加至你的 twentytwentyone-child/functions.php 文件中):
/**
* 强制启用首页 Logo 链接(覆盖父主题 unlink-homepage-logo 设置)
*/
function child_theme_enable_logo_link_on_home() {
// 移除父主题已注册的 custom-logo 支持
remove_theme_support( 'custom-logo' );
// 重新声明 custom-logo 支持,禁用自动解链
$logo_width = 300;
$logo_height = 100;
add_theme_support(
'custom-logo',
array(
'height' => $logo_height,
'width' => $logo_width,
'flex-width' => true,
'flex-height' => true,
'unlink-homepage-logo' => false, // ? 核心:设为 false
)
);
}
add_action( 'after_setup_theme', 'child_theme_enable_logo_link_on_home', 11 );✅ 说明与注意事项:
-
add_action的优先级设为11(高于父主题默认的10),确保覆盖生效; -
$logo_width和$logo_height值建议与父主题保持一致(可查阅twentytwentyone/functions.php中原始定义),避免影响响应式表现; - 修改后无需改动模板文件(如
site-branding.php),the_custom_logo()将自动输出带链接的 Logo; - 若后续父主题更新调整了 Logo 尺寸逻辑,需同步更新子主题中的数值以维持兼容性。
完成上述操作并刷新页面后,无论是否处于首页,点击 Logo 均可正常跳转至站点首页——真正实现“全站统一导航体验”。


















