讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

WordPress 自定义 Logo 在首页不链接到主页的解决方案

胖婷小哥_8707

胖婷小哥_8707

发布时间:2026-11-22 14:08:05

|

291人浏览过

|

来源于php中文网

原创

WordPress 自定义 Logo 在首页不链接到主页的解决方案

本文详解如何让 WordPress 的 the_custom_logo() 函数在首页也保持可点击并跳转至首页,解决因主题启用 'unlink-homepage-logo' => true 导致的链接被移除问题。

本文详解如何让 wordpress 的 `the_custom_logo()` 函数在首页也保持可点击并跳转至首页,解决因主题启用 `'unlink-homepage-logo' => true` 导致的链接被移除问题。

在基于 Twenty Twenty-One 或其子主题(如 twentytwentyone-child)开发时,你可能会发现:尽管调用了 the_custom_logo(),但当用户访问网站首页时,Logo 图片不再包裹 <a></a> 标签,即无法点击返回首页——而这是不符合多数用户体验预期的行为。

这并非模板代码(如 site-branding.php)遗漏所致,而是由主题在 functions.php 中通过 add_theme_support('custom-logo', ...) 显式启用了 'unlink-homepage-logo' => true 选项所导致。该参数是 WordPress 5.5+ 引入的特性,意在允许主题“在首页自动解绑 Logo 链接”,但默认行为(即始终链接到首页)更常见且更合理。

✅ 正确修复方式:重置自定义 Logo 支持参数

你不能直接在子主题的 functions.php 顶层作用域中调用 remove_theme_support() 和 add_theme_support() —— 因为父主题的 add_theme_support() 通常在 after_setup_theme 钩子中执行,若子主题代码未挂载到对应时机,将失效。

✅ 必须使用 after_setup_theme 钩子,并设置比父主题更低的优先级(例如 9),确保在父主题注册之后再覆盖:

Keyword Research
Keyword Research

SEO关键词研究工具,用于高价值关键词的搜索意图分析、难度评估和内容机会映射。

下载
// 在子主题的 functions.php 中添加以下代码
function child_theme_setup_custom_logo() {
    // 先移除父主题已注册的 custom-logo 支持
    remove_theme_support('custom-logo');

    // 重新注册,关键:设置 'unlink-homepage-logo' => false
    $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, // ? 核心修复项:强制首页保留链接
    ));
}
add_action('after_setup_theme', 'child_theme_setup_custom_logo', 9);

⚠️ 注意事项:

  • add_action 的优先级设为 9(父主题通常为 10),确保执行顺序正确;
  • $logo_width / $logo_height 值建议与父主题一致(可查阅父主题 functions.php 中原始定义),避免影响裁剪逻辑;
  • 修改后请清空对象缓存(如有)并刷新前台首页验证效果;
  • 无需修改任何模板文件(如 site-branding.php),the_custom_logo() 将自动按新配置渲染带链接的 Logo。

? 验证是否生效

在首页查看源码,确认 Logo 输出类似如下结构(含 <a href="https://yoursite.com/"></a>):

<div class="site-logo">
  <a href="https://yoursite.com/" class="custom-logo-link" rel="home">
    <img    style="max-width:90%"  style="max-width:90%" src="https://yoursite.com/wp-content/uploads/logo.png" class="custom-logo" alt="Site Title">
  </a>
</div>

至此,无论用户处于首页还是内页,点击 Logo 均可一致跳转至网站首页,实现专业、统一的导航体验。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

13444

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7661

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2295

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4848

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5574

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4391

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6357

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5022

2023.11.13

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

0

2026.11.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何在 Windows 11 上安装 XAMPP
如何在 Windows 11 上安装 XAMPP

共1课时 | 254人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 12.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn